Recipes

NTM recipe files live under data/<namespace>/recipe/<path>.json. See the Minecraft Wiki data pack reference for vanilla recipe formats; this page covers NTM recipe fields and behavior.

Start with a bundled file of the same type from your installed mod jar. Machine recipe types add fields and interpret outputs differently.

Guides

Recipe identifiers

Name	Example	Meaning
Recipe resource ID	`hbm:custom_machine/custom_machine.paper_press`	Identifies the JSON resource and determines which file an override replaces
Recipe `type`	`hbm:custom_machine`	Selects the recipe parser and machine recipe table
Custom-machine `recipe_key`	`paperPress`	Connects custom-machine definitions to their process recipes
Recipe `name`	`custom_machine.paper_press`	Internal lookup name; defaults to the last segment of the resource path

Internal names must be unique within a recipe table. Different resource IDs can produce the same default name; a lookup by that name reaches one row.

Shared fields

The machine recipe reference gives each machine its recipe formats and examples.

Field	Meaning and default	Range
`type`	Selects the recipe format.
`name`Optional	Internal lookup name; defaults to the last segment of the recipe resource path.
`input_items`Optional	Ordered counted item inputs; defaults to an empty list.
`ingredient`	Item ID, item tag, or loader ingredient object.
`count`Optional	Items required from one stack; default 1. The item stack limit bounds a usable count.	1 to 2³¹−1
`components`Optional	Exact item-component values.
`predicates`Optional	Item-component predicates.
`input_fluids`Optional	Ordered fluid inputs with amount and pressure; defaults to an empty list.
`type`	Registered fluid ID.
`amount`	Amount in mB; use 1–tank capacity for transfers because machine code casts to int.	−2⁶³ to 2⁶³−1
`pressure`Optional	Pressure level; default 0.	−2³¹ to 2³¹−1
`output_items`Optional	Fixed or weighted item-output positions; defaults to an empty list.
`item ID`	Fixed output: String form for one item.
`id`	Item ID in a stack object.
`count`Optional	Stack size; default 1.	1–99
`components`Optional	Item-component values.
`chance`Optional	Chance for the whole stack; omit for a guaranteed output.	Rounds to weight 1–999 of 1000
`data`	Weighted choice: Stack object or an empty object for no output.
`weight`	Relative selection weight; a positive total selects an output.	0 to 2³¹−1 each; sum ≤2³¹−1
`output_fluids`Optional	Ordered fluid outputs with amount and pressure; defaults to an empty list.
`type`	Registered fluid ID.
`amount`	Amount in mB; use 1–tank capacity for transfers because machine code casts to int.	−2⁶³ to 2⁶³−1
`pressure`Optional	Pressure level; default 0.	−2³¹ to 2³¹−1
`duration`Optional	Process duration in ticks; defaults to 0.	−2³¹ to 2³¹−1
`power`Optional	HE demand; defaults to 0.	−2⁶³ to 2⁶³−1
`icon`Optional	Stack template displayed for the recipe; otherwise derived from the output.
`id`	Item ID.
`count`Optional	Stack size; default 1.	1–99
`components`Optional	Item-component values.
`icon_from_input`Optional	Derives the display icon from the first item input when true; defaults to false.
`name_wrapper`Optional	Translation key applied around the displayed recipe name.
`custom_localization`Optional	Resolves the internal name as a translation key when true; defaults to false.
`blueprint_pools`Optional	Blueprint pool identities associated with the recipe.
`blueprint_pools_528`Optional	Alternate blueprint pools while the 528 flag is active.
`auto_switch_group`Optional	Identity grouping recipes for automatic input switching.
`order`Optional	Sort position within the recipe table; lower values first, default 2147483647.	−2³¹ to 2³¹−1

Individual machines set operational input and output requirements and may consume only part of the shared record. Loader condition wrappers are separate from these fields.

GuidesCopy Anchor Link

Recipe identifiersCopy Anchor Link

Shared fieldsCopy Anchor Link

On this page

Guides

Recipe identifiers

Shared fields