Register Controller

Startup script

The script goes in kubejs/startup_scripts/.

MMEvents.registerControllers(event => {
  event.create('my_controller')
    .type('mm:machine')
    .name('My Controller')
})

event.create(...) takes the bare MM controller id/path. Do not include mm: here.

Correct:

event.create('coke_oven')

Wrong:

event.create('mm:coke_oven')

The generated controller block/item/menu/block-entity id is exactly:

mm:coke_oven

not:

mm:coke_oven_controller

Builder methods

MMEvents.registerControllers(event => {
  event.create('coke_oven')
    .type('mm:machine')
    .name('Coke Oven')
    .parallelProcessingDefault(false)
    .maxParallelRecipes(-1)
    .recipeSelectionMode('default')
})

Method	Meaning
`create(id)`	Bare generated MM id/path. `coke_oven` becomes `mm:coke_oven`.
`type(id)`	Controller type. Normal machines use `mm:machine`.
`name(text)`	Default display name.
`parallelProcessingDefault(bool)`	Optional controller-level default for recipe parallelism.
`maxParallelRecipes(int)`	Optional controller-level cap. `-1` means unspecified/fallback.
`recipeSelectionMode(string)`	Optional recipe scheduling mode: `default`, `avoid_same_recipe`, or `round_robin_input_item`.

Recipe selection mode

recipeSelectionMode(...) controls how the controller chooses between multiple runnable recipes. This is most useful for machines that have many valid recipes at once and should not keep consuming the same input type.

MMEvents.registerControllers(event => {
  event.create('big_sieve')
    .type('mm:machine')
    .name('Big Sieve')
    .parallelProcessingDefault(false)
    .maxParallelRecipes(1)
    .recipeSelectionMode('round_robin_input_item')
})

Supported values:

Value	Use when
`default`	You want the normal recipe scan behavior.
`avoid_same_recipe`	You only want to avoid starting the exact same recipe back-to-back.
`round_robin_input_item`	You want the controller to prefer the least-recently-used consumed item input among currently runnable recipes. This is good for sieve-like machines with several input types in one input port.

Mode strings are forgiving: hyphens/spaces are normalized to underscores, and unknown values fall back to default.

Important: Startup-generated controllers, ports, and extra blocks use bare ids in event.create(...). Structures and process recipes are datapack/resource ids and should be namespaced.