Skip to content

Custom Crafting Recipes

DaFuqs edited this page Sep 8, 2026 · 1 revision

Vanilla crafting recipes can be gated! Well, visually, at least. Everyone knowing the exact ingredients will always be able to craft them, but recipe viewers show them as gated.

General Properties

Entry Type Default Description
group string empty A string that represents a recipe group. Recipes with a common group will only trigger a single unlock popup, if multiple are unlocked at once. Add a localization string "recipeGroup.spectrum.<<your_group_string>>" so the toast popup is properly localized
required_advancement advancement_identifier empty The advancement a player needs to have to be able to see this recipe. Spectrum will automatically show a recipe unlock toast when this advancement has been gotten and the Pedestal has the correct tier
reveal_secret_advancement advancement_identifier empty If set, the recipe shows up as a secret in recipe viewers at first, until the player has the set advancement. You can set a hint by adding a lang key recipe.spectrum.<recipe_type_id>.secret.<recipe_id>.hint
additional_recipe_viewer_results itemstack list empty Items that will be considered an "output" of the recipe for recipe viewers when pressing "R". Has no gameplay relevance, but is a nice QoL thing for your players, if your recipe does something funky.
result item_stack Output item stack, supports NBT

Shaped Recipes

Properties

Entry Type Description
pattern crafting_pattern A shaped crafting pattern in size up to 3x3
key item_keys A list of pattern entries mapped to an ingredients (item or tag)

Example: The crafting recipe of the Ender Dropper

{
  "type": "spectrum:gated_crafting_shaped",
  "required_advancement": "spectrum:hidden/collect_shards/amethyst",
  "pattern": [
    "W",
    "W"
  ],
  "key": {
    "W": [
      {
        "item": "spectrum:polished_amethyst"
      }
    ]
  },
  "result": {
    "id": "spectrum:amethyst_pillar",
    "count": 2
  }
}

Shapeless Recipes

Properties

Entry Type Description
ingredients ingredient list List of Ingredients

Example: The crafting recipe of CMY tier Pedestal

{
  "type": "spectrum:gated_crafting_shapeless",
  "required_advancement": "spectrum:hidden/collect_shards/amethyst",
  "group": "compacting",
  "ingredients": [
    {
      "item": "spectrum:polished_amethyst"
    }
  ],
  "result": {
    "id": "minecraft:amethyst_shard",
    "count": 9
  }
}

Clone this wiki locally