Recipes

Create machine recipes using KubeJS

Custom Machine recipes can be made with KubeJS.

Create a .js file in the kubejs/server_scripts/ folder (ex: custom_machine_recipes.js).

Then inside the .js file you can use the recipes kubejs event to get the custom machine recipe builder, pass it the id of the machine you want to make the recipe for and the duration of the recipe (in ticks).

onEvent('recipes', event => {
  //Machine recipe : 
  event.recipes.custommachinery.custom_machine("namespace:machine_id", duration)
  //Add requirements here
  
  //Craft recipe : 
  event.recipes.custommachinery.custom_craft("namespace:machine_id", Item.of("output_item"))
  //Add requirements here
})

Requirements

You can add various requirements on the custom machine recipe builder :

BiomeBlockChemical (Mekanism)CommandContraption (Create)DimensionDropDurabilityEffectEnergyEntityFluidFuelFunctionHeat (Mekanism)ItemItem transformLightLoot tablePositionRadiation (Mekanism)RedstoneSkyStructureTimeWeather

Requirements special properties

Some requirements (almost all) have various properties that can change its behavior.

To set these properties you must call one or several of the methods below immediately after the desired requirement. The properties will only be applied on the latest added requirement when the method is called.

If the latest added requirement doesn't support the property an error will be logged and nothing will happen (the property will be ignored).

Chance

Use this method to add a chance property to the latest added requirement.

.chance(chance)

• The chance param must be a double between 0.0 and 1.0 included.

Supported requirements :

• Block

• Command

• Drop

• Durability

• Effect

• Energy

• Energy Per Tick

• Entity

• Fluid

• Fluid Per Tick

• Function

• Item

Delay

Use this method to set a delay for the requirement action.

The requirement will only execute its action after the specified delay.

.delay(delay)

• The delay param must be a double between 0.0 and 1.0 excluded. 0 represent the start of the recipe and 1 represent its end.

Supported requirements :

• Block

• Command

• Drop

• Effect

• Entity

• Function

Priority

Use the method below to set the priority of the recipe.

If this method is called several times only the latest will be used.

If this is called AFTER .jei() (no need to be immediatly after) this will act as the "jeiPriority" instead, defining the priority of the recipe to show in jei instead of the priority to be checked in the machine.

If no priority is set, the default value : 0 will be used.

.priority(priority)

• The priority param must be an integer value.

Jei

If the method below is called, all requirements added after that will be added to the jei property requirement list.

.jei()

This action cannot be inverted, you must add all your recipe requirements before calling it.

Requirements added after this method will only be displayed in jei but not executed by the machine. Learn more here.

Reset on error

If the method below is called, the recipe will reset the machine instead of erroring when a requirement throw an error.

.resetOnError()

Note : When the machine is reset its inventory remains the same, but all already consumed inputs are lost.

Hide in JEI

Call the following method anywhere in your recipe builder to make the recipe hidden in JEI.

The recipe will still work in the machine but won't show in JEI.

.hide()

Examples :

Example 1

A 100 tick recipe that use 5mB of water, 5mB of any fluid with tag lava and 20FE per tick to create a stone.

onEvent('recipes', event => {

  event.recipes.custommachinery.custom_machine("custommachinery:stone_generator", 100)
  .requireFluid(Fluid.of("minecraft:water", 5))
  .requireFluidTag("#minecraft:lava", 5)
  .requireEnergyPerTick(20)
  .produceItem(Item.of("minecraft:stone", 1))
})

Example 2

A 200 tick recipe that use 1 item with tag stone and 20FE per tick to create 1 cobblestone, 1 gravel with 50% chance and 1 sand with 10% chance.

onEvent('recipes', event => {

  event.recipes.custommachinery.custom_machine("custommachinery:power_crusher", 200)
  .requireItemTag("#forge:stone", 1)
  .requireEnergyPerTick(20)
  .produceItem(Item.of("minecraft:cobblestone", 1))
  .produceItem(Item.of("minecraft:gravel", 1)).chance(0.5)
  .produceItem(Item.of("minecraft:sand", 1)).chance(0.1)
})