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.

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, \texttt{i32::MAX}]
`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, \mathrm{tank\ capacity}] for transfers because machine code casts to int.	\texttt{i64}
`pressure`Optional	Pressure level; default 0.	\texttt{i32}
`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	Output chance; omit for a guaranteed output. Some machines roll each item of the stack separately.	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, \texttt{i32::MAX}] each; \sum_i w_i \le \texttt{i32::MAX}
`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, \mathrm{tank\ capacity}] for transfers because machine code casts to int.	\texttt{i64}
`pressure`Optional	Pressure level; default 0.	\texttt{i32}
`duration`Optional	Process duration in ticks; defaults to 0.	\texttt{i32}
`power`Optional	HE demand; defaults to 0.	\texttt{i64}
`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 pools containing the recipe; a pooled recipe needs a blueprint of one of them in the machine.
`blueprint_pools_528`Optional	Replaces blueprint_pools while the enable_528 flag holds.
`auto_switch_group`Optional	Translation key grouping recipes; the machine switches to the group member whose first item input matches its first input slot.
`order`Optional	Sort position within the recipe table; lower values first, default 2147483647.	\texttt{i32}

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.

NTM machine recipe types, hbm:crafting_shaped, hbm:crafting_shapeless and hbm:material_distribution reject unknown fields. Both loaders accept fabric:load_conditions and neoforge:conditions in these files.

These formats also accept _kubejs_changed_marker, which KubeJS adds to recipes it creates or edits.

Guides

Recipe identifiers

Shared fields

On this page

Recipes

GuidesCopy Anchor Link

Recipe identifiersCopy Anchor Link

Shared fieldsCopy Anchor Link

On this page

Guides

Recipe identifiers

Shared fields