KubeJS Support

Masterful Machinery can be configured with KubeJS instead of, or alongside, JSON files. Use startup events for generated block definitions and server events for datapack-like content.

All events are exposed through MMEvents.

Event overview

MMEvents.registerControllers(event => {})
MMEvents.registerPorts(event => {})
MMEvents.registerExtraBlocks(event => {})
MMEvents.createStructures(event => {})
MMEvents.createProcesses(event => {})

Event	Script side	Purpose
`registerControllers`	startup	Register generated controller blocks.
`registerPorts`	startup	Register generated input/output port blocks.
`registerExtraBlocks`	startup	Register generated decorative/helper blocks.
`createStructures`	server	Register datapack-style structure definitions.
`createProcesses`	server	Register datapack-style process recipes.

ID rule: generated content vs datapack content

Generated startup content and datapack/server content use different event.create(...) id rules.

Context	Event	`event.create(...)` expects	Example	Generated / referenced id
Controller	`MMEvents.registerControllers`	bare MM base id/path	`event.create('coke_oven')`	`mm:coke_oven`
Extra block	`MMEvents.registerExtraBlocks`	bare MM base id/path	`event.create('basic_circuit')`	`mm:basic_circuit`
Port	`MMEvents.registerPorts`	bare MM base id/path	`event.create('item_port')`	`mm:item_port_input`, `mm:item_port_output`
Structure	`MMEvents.createStructures`	full resource location	`event.create('expert:coke_oven')`	`expert:coke_oven`
Process recipe	`MMEvents.createProcesses`	full resource location	`event.create('expert:coke_oven/charcoal')`	`expert:coke_oven/charcoal`

Important: MMEvents.registerControllers, MMEvents.registerExtraBlocks, and MMEvents.registerPorts take a bare MM id/path in event.create(...), such as coke_oven, not mm:coke_oven. Masterful Machinery registers generated blocks/items under the mm namespace internally. Passing mm:coke_oven here can produce an invalid double namespace like mm:mm:coke_oven. Structures and process recipes are different: those are datapack/resource ids and should be namespaced, such as expert:coke_oven.

KubeJS Support

Event overview

ID rule: generated content vs datapack content

Pages