Recipes

One recipe under recipe:, or several under recipes: as a list.

Writing an ingredient

Four forms:

IRON_INGOT                    # a vanilla material
sigil:aether_ingot            # a custom item, matched by id
{ item: IRON_INGOT, amount: 2 }
[ IRON_INGOT, GOLD_INGOT ]    # any one of these

That is also what lets two recipes share a shape and differ only in whether an ingredient is custom, which vanilla recipe registration cannot express.

Shaped

recipe:
  type: shaped
  amount: 1
  shape:
    - " SI"
    - " SL"
    - "I  "
  keys:
    S: STRING
    L: LEAD
    I: sigil:aether_ingot

A space is an empty slot. The pattern may sit anywhere in the grid, as in vanilla.

Shapeless

recipe:
  type: shapeless
  ingredients:
    - sigil:aether_block
    - { item: STICK, amount: 2 }

Here amount means "this many slots of it", since each slot contributes one item per craft.

Cooking

furnace, blasting, smoking and campfire.

recipe:
  type: furnace
  input: sigil:raw_aether
  cook-time: 200
  experience: 0.7

Smithing

recipe:
  type: smithing
  base: DIAMOND_SWORD
  addition: sigil:aether_ingot
  template: NETHERITE_UPGRADE_SMITHING_TEMPLATE # optional

Stonecutting

recipe:
  type: stonecutting
  input: sigil:aether_block
  amount: 4

Keeping custom items out of vanilla recipes

By default a custom item cannot be used as an ingredient in an ordinary vanilla recipe. Without that, an Aether Ingot crafts into a plain iron block and its identity is gone.

Turn it on per item with rules.vanilla-recipes: true, or server-wide in config.yml.

Several recipes for one item

recipes:
  - type: shaped
    shape: ["III", "III", "III"]
    keys:
      I: sigil:aether_ingot
  - type: stonecutting
    input: sigil:aether_pillar
    amount: 1

Each is registered independently, so one being gated out on an older server does not affect the others.

Verify a recipe

After /sigil reload, open /sigil recipe <item>. If it is absent, read the grouped load report before changing the shape: an unknown material, custom item id, key symbol or version-gated recipe is reported against the source file. For shapeless recipes, an ingredient amount occupies that many crafting slots; it is not a stack count in one slot.