Item requirement is used to define item inputs and outputs for a custom machine recipe.
To use it you need to provide the registry name and the amount of the item you want the recipe to consume/produce.
This requirement is available in both input and output modes.
In input mode : When starting to craft the recipe, the machine will consume the desired amount of the specified item from the input slot they are in.
In output mode : When finishing to craft the recipe, the machine will produce the desired amount of the specified item and put them in the first disponible output slot.
The requirement type of item requirement is : "custommachinery:item".
Properties
The item requirement has 4 mandatory properties and 3 optional properties.
Mandatory properties
"type": "custommachinery:item"//Mandatory to define an item requirement.
Mode
Name : mode
Description :
Define the I/O mode of the requirement.
input The requirement will consume items at the start of the crafting process.
output The requirement will produce items at the end of the crafting process.
Example :
"mode": "input"
The requirement will consume items at the start of the crafting process.
Item
Name : item
Description :
The registry name of the item you want to be consumed/produced by the recipe.
It must be specified like namespace:item_registry_name with "namespace" being either "minecraft" if the item is from vanilla or a mod ID if the item is from a mod (ex : minecraft:diamond or mekanism:copper_ingot).
If the requirement mode is input you can use a tag instead, by using the # prefix like #minecraft:logs.
You can't use a tag if the requirement mode is output !
Example :
"item": "minecraft:diamond"
The item consumed/produced by the recipe will be a vanilla Diamond.
"item": "#minecraft:logs"
The recipe will consume any logs.
Note :
You can see an item registry name by activating advanced infos (F3 + H in-game) and hovering the item in an inventory.
Amount
Name : amount
Description :
An integer that define the amount of the specified item you want to be consumed/produced.
It can be higher than the maximum stack size of said item but remember that the machine need enough item inventory slots to input/output the items (ex : if you set the requirement to 20 iron chestplate the machine will need 20 input/output slots to consume/produce the items since the maximum stack size of an iron chestplate is 1).
Example :
"amount": 16
The recipe will consume/produce 16 of the specified item.
Optional properties
Chance
Name : chance
Description :
A double between 0.0 and 1.0 that define the chance of the requirement to be processed.
Default : 1
The requirement will always be processed.
Example :
"chance": 0.7
The requirement will have 70% chance to be processed.
Nbt
Name : nbt
Description :
A string that represent a nbt tag that will be required on the input item, or added to the output item.
If the item requirement is in input mode it will search for items in input slots that have AT LEAST those nbt tag, if the item have more tag it's fine as long as it have all the tags specified in this property.
The nbt tag must be defined the same way you use it in the /give command.
You can see the nbt tag of an item using /data get entity @s SelectedItem and then copy the part after tag: inside {}.
Default : nothing
No nbt tags
Example :
"nbt": "{\"test1\": true, \"Amount\": 10}"
The item requirement will search for items with nbt tag "test1" with value true and tag "Amount" with value 10.
Slot
Name : slot
Description :
The slot id of a slot you want to force the player to put the item in.
The slot id must be exactly the same as the one specified in the Item Component ID property or it will not work.
If the requirement mode is "output" the produced item will be put in the specified slot.
Default : empty
The item can be put in any slot.
Example :
"slot": "input1"
The item will be input/output only in the slot with id input1.
Examples
An item requirement that will make the recipe consume 50 vanilla cobblestone:
