Crafting input state

The input_state field of shaped and shapeless NTM crafting recipes declares component requirements and a preservation destination. Both loaders use the same field format.

An omitted rule accepts pristine stacks: stacks without component changes relative to their item definition. Modified inputs must satisfy an explicit state requirement or retain their changed state in the result or crafting remainder.

FieldsCopy Anchor Link

Each rule accepts components, predicates, and preserve. Undefined selectors, unsupported fields or destinations, and multiple result carriers fail recipe loading.

Required stateCopy Anchor Link

components compares complete registered component values. predicates uses registered component predicates. Both use the schemas described under Ingredients and Components. A rule's requirements add to the claims of its ingredient; each changed component must be claimed or preserved.

For an ingot named Required, set the rule on its shaped symbol or shapeless index:

"input_state": {
  "I": {
    "components": {"minecraft:custom_name": {"text": "Required"}}
  }
}

Result carrierCopy Anchor Link

"preserve": "result" copies the selected input's component changes to the output. Exactly one input occurrence supplies that state, and result.count must be 1. Shaped cropping and mirroring retain the symbol binding; shapeless assignment selects the stack attached to the declared ingredient index.

Result component fields may add values. Matching refuses an override that replaces a changed value carried by the actual input. An override that contradicts an exact preserved component requirement fails recipe loading.

Crafting remainderCopy Anchor Link

"preserve": "remainder" requires the input's actual crafting remainder to retain its changed state. NTM crafting tools gain their usual one point of wear. An item without a crafting remainder never matches this rule. The Combinator Funnel discards remainders and refuses modified inputs bound to this rule.

Shipped recipe data/hbm/recipe/ball_dynamite.json; ingredient 3 accepts either Laboratory Glassware item:

{
  "type": "hbm:crafting_shapeless",
  "ingredients": [
    "#c:dusts/saltpeter",
    "minecraft:sugar",
    "minecraft:sand",
    "#hbm:tools/chemistry_set"
  ],
  "input_state": {
    "3": {
      "preserve": "remainder"
    }
  },
  "result": {
    "count": 2,
    "id": "hbm:ball_dynamite"
  }
}

Component requirements still apply: an explicit zero-damage demand accepts only an undamaged input.