This page is about the format for custom crafting table recipes added by SlimeKnights mods. For the format of vanilla crafting table recipes, see the Minecraft Wiki on recipes.

This page covers the format for custom crafting table recipes added by SlimeKnights mods since 1.16.

Common Shaped Fields

See also: Minecraft Wiki on Shaped Recipes

Most shaped crafting table recipes share the following fields:

  • (Object): The recipe object.
    • category (String, since 1.20): Recipe book category for this recipe, may be equipment, building, redstone, or misc (default).
    • show_notification (Boolean, since 1.20): If true (default), a notification will be shown when unlocking this recipe.
    • group (String): If set, this recipe will be grouped in the recipe book with other recipes that have the same group.
    • pattern (Array): A list of strings representing the shaped pattern in the crafting table for this recipe.
      • (String): A single row in the shaped pattern. Each character represents an input, matching a character from key.
    • key (Object): A mapping from single character keys to the corresponding ingredients for pattern.
      • <character> (Item Ingredient): Ingredient corresponding to the character <character> in pattern.
    • result (Item Stack): Resulting item stack for this recipe.

Common Shapeless Fields

See also: Minecraft Wiki on Shapeless Recipes

Most shapeless crafting table recipes share the following fields:

  • (Object): The recipe object.
    • category (String, since 1.20): Recipe book category for this recipe, may be equipment, building, redstone, or misc (default).
    • show_notification (Boolean, since 1.20): If true (default), a notification will be shown when unlocking this recipe.
    • group (String): If set, this recipe will be grouped in the recipe book with other recipes that have the same group.
    • ingredients (Array): A list of ingredients for this recipe. Each one matches a distinct item that must appear in the crafting grid.
    • result (Item Stack): Resulting item stack for this recipe.

Shaped Retextured

The shaped retextured recipe from Mantle defines a shaped crafting table recipe where the output has it’s texture set based on one of the inputs. This is notably used in Tinkers’ Construct to texture the legs of tables and the metal of the anvil, along with in Inspirations to texture bookshelves and enlightened bushes.

Shaped retextured recipes have the following format:

  • (Object): The recipe object.
    • type (Resource Location): Always mantle:crafting_shaped_retextured.
    • All common shaped fields.
    • texture (Item Ingredient): Ingredient determining the texture to apply to the output. Typically should match a single entry in key, if it matches multiple behavior may be unpredictable.
    • match_all (Boolean):
      • If true, all inputs matching texture must be the same item. If any mismatch, the output will be created with no texture (effectively using the default from it’s block model).
      • If false (default), the first input matching texture is used as the texture, regardless of if the rest match.

Shaped Fallback

The shaped fallback recipe from Mantle used to create a fallback recipe that fails to match if any recipes from the list of alternatives match. This recipe can be used when a block has multiple variants for vanilla blocks, but a default recipe is desired for non-vanilla blocks of the same type.

The shaped fallback recipe has the following format:

  • (Object): The recipe object.
    • type (Resource Location): Always mantle:crafting_shaped_fallback.
    • All common shaped fields.
    • alternatives (Array): List of alternative recipes IDs. If any of them match the input, this recipe will not match.
      • (Resource Location): An alternative recipe ID. Must be the ID of either a minecraft:crafting_shaped or minecraft:crafting_shapeless recipe.

Tool Repair

Tinkers’ Construct adds several custom recipes related to tool repairing, which are covered more in depth on the relevant page.

  • tconstruct:crafting_table_repair: Defines repairing modifiable tools using repair kits in the crafting table. See tool recipes for more information.
  • tconstruct:specialized_repair_kit: Recipe format from before 1.19.2 for repairing tools without materials using repair kits in the crafting table. See tool recipes for more information.
  • tconstruct:crafting_modifier_repair: Defines repairing a tool with a specific modifier in the crafting table using a standard ingredient. See modifier repair recipes for more information.
  • tconstruct:crafting_modifier_material_repair: Defines repairing a tool with a specific modifier in the crafting table using a repair kit with a specific material. See modifier repair recipes for more information.

Material

These recipes are used to craft tools or tool parts in the crafting table, setting materials based on the inputs. They are notbably used to craft travelers gear.

Shaped Material

Since 1.20.1

The shaped materials recipe allows combining 1 or more tool parts or material items to craft a tool with materials. As a shaped recipe, the arrangement of items is important. Additionally, it allows a single material to show up multiple times, making it more ideal for non-tool parts.

It has the following format:

  • (Object): The recipe object.
    • type (Resource Location): Always tconstruct:crafting_shaped_materials.
    • All common shaped fields.
    • result (Item Stack): Resulting item stack for this recipe. Expected to be an IModifiable or IMaterialItem
    • parts (String): Each character represents a part, matching a character from key. The order of the parts matches the order of materials on the item. Must be length 1 if result is an IMaterialItem.
    • extra_materials (Array): Additional materials to add to the item after the part materials. If unset, defaults to an empty list. Cannot be set if result is an IMaterialItem.

Typically, the material or material value ingredients should be used for any ingredients listed in parts.

Shapeless Material

Since 1.20.1

The shapeless materials recipe allows combining 1 or more tool parts or material items to craft a tool with materials. As a shapeless recipe, the parts may be placed anywhere in the crafting grid. Importantly, this means if there are duplicate parts, the first to appear in the grid will set an early material index.

It has the following format:

  • (Object): The recipe object.
    • type (Resource Location): Always tconstruct:crafting_shapeless_materials.
    • All common shapeless fields.
    • result (Item Stack): Resulting item stack for this recipe. Expected to be an IModifiable or IMaterialItem
    • parts (Integer): Number of parts present in this recipe. Parts will be selected from the start of ingredients. For example, if parts is 2, the first 2 ingredients will be parts. Must be 1 if result is an IMaterialItem.
    • extra_materials (Array): Additional materials to add to the item after the part materials. If unset, defaults to an empty list. Cannot be set if result is an IMaterialItem.

Typically, the material or material value ingredients should be used for any ingredients up to the number in parts.

Legacy Shaped Material

Until 1.21

The legacy shaped material recipe allows combining a number of material value ingredients to set the materials on a tool. The way it worked was too restrictive, so Shaped Material was written to replace it.

To choose the material, 1 or more material value ingredients should be used, which will automatically be selected and used to set the first material.

It has the following format:

  • (Object): The recipe object.
    • type (Resource Location): Always tconstruct:crafting_shaped_material.
    • All common shaped fields.
    • result (Item Stack): Resulting item stack for this recipe. Expected to be an IModifiable.
    • extra_materials (Array): Additional materials to add to the item after the ingredient material. If unset, defaults to an empty list. Cannot be set if result is an IMaterialItem.