Recipe

This article is about the Java and Bedrock Edition recipe system. For crafting recipes, see Crafting § Complete recipe list. For smelting recipes, see Smelting § Recipes. For brewing recipes, see Brewing § Recipes. For the command, see Commands/recipe.

Recipes provide a structured way for players to perform item and block transformations in-game. Every crafting, smelting, blasting, campfire cooking, smoking, stonecutting and smithing recipe uses this system. In Bedrock Edition, brewing recipes also use this system. Recipes are data driven and can be configured by data packs in Java Edition or add-ons in Bedrock Edition.

Obtaining

Recipes can be obtained in various ways. Acquiring an item from the recipe causes the player to automatically discover it. Recipes can also be granted using the /recipe command. In Java Edition, as a reward for completing an advancement, there are multiple advancements that grant recipes which trigger when, for example, the player obtains an item required in the recipe.

Once a recipe has been discovered, it is added to the player's recipe book. In Java Edition, discovered recipes are stored in the player's [NBT Compound / JSON Object] recipeBook NBT.

Usage

Main article: Recipe book

Discovered recipes can be found in the player's recipe book. However, recipes do not need to be discovered for the player to be able to use them, unless the doLimitedCrafting game rule is enabled. In Bedrock Edition there is the game rule recipesUnlock which disables the unlocking of recipes making them all accessible and visible.

Recipes appear in the inventory's recipe book if they are 2×2 in size, otherwise they will only appear if the player is using a crafting table. In Java Edition the recipe book can also be used in the furnace, showing exclusively smelting recipes.

Anvil, cartography table, loom, brewing stand[Java Edition only], and grindstone don't use a recipe system: they use another system.

Java Edition JSON format

Vanilla recipes are stored as separate JSON files in the data/minecraft/recipe folder in the .minecraft/versions/<version>/<version>.jar file. This folder can be found by changing the extension of the .jar file to .zip and navigating within it.

Custom recipe files are stored in the data/<namespace>/recipe folder of a data pack. A recipe with ID foo:path/to/file would have its JSON file located at data/foo/recipe/path/to/file.json within a data pack. Data packs that load later with a recipe file in same resource location replace the existing recipe.

Recipe JSON files have different structures dependent on their type, but they all have a [String] type tag in its root tag. These types are listed below.

blasting

Represents a recipe in a blast furnace.

  • [NBT Compound / JSON Object] The root tag.
    • [String] type: minecraft:blasting
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: blocks and misc. Defaults to misc.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [String][NBT List / JSON Array] ingredient: The ingredient for the recipe. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [Int] cookingtime: Optional. The cook time of the recipe in ticks. Defaults to 100.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.
    • [Double] experience: Optional. The output experience of the recipe.

Usage example json:

{
  "type": "minecraft:blasting",
  "category": "misc",
  "cookingtime": 100,
  "experience": 0.1,
  "group": "coal",
  "ingredient": "minecraft:coal_ore",
  "result": {
    "id": "minecraft:coal"
  }
}
Name Ingredients Smelting recipe Description
Coal Coal Ore +
Any fuel
Invicon Coal Ore.png: Inventory sprite for Coal Ore in Minecraft as shown in-game linking to Coal Ore with description: Coal Ore
Invicon Coal.png: Inventory sprite for Coal in Minecraft as shown in-game linking to Coal with description: CoalInvicon Charcoal.png: Inventory sprite for Charcoal in Minecraft as shown in-game linking to Charcoal with description: CharcoalInvicon Oak Log.png: Inventory sprite for Oak Log in Minecraft as shown in-game linking to Oak Log with description: LogInvicon Oak Planks.png: Inventory sprite for Oak Planks in Minecraft as shown in-game linking to Oak Planks with description: Overworld PlanksInvicon Lava Bucket.png: Inventory sprite for Lava Bucket in Minecraft as shown in-game linking to Lava Bucket with description: Lava BucketInvicon Block of Coal.png: Inventory sprite for Block of Coal in Minecraft as shown in-game linking to Block of Coal with description: Block of Coal

Invicon Coal.png: Inventory sprite for Coal in Minecraft as shown in-game linking to Coal with description: Coal0.1
Illustrative recipe

campfire_cooking

Represents a recipe in a campfire.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:campfire_cooking
    • [String][NBT List / JSON Array] ingredient: The ingredient for the recipe. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [Int] cookingtime: Optional. The cook time of the recipe in ticks. Defaults to 100.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

Usage example json:

{
  "type": "minecraft:campfire_cooking",
  "category": "food",
  "cookingtime": 600,
  "experience": 0.35,
  "ingredient": "minecraft:potato",
  "result": {
    "id": "minecraft:baked_potato"
  }
}

Even though all vanilla campfire cooking recipes have a cook time of 600 ticks, the default is 100 ticks.

Campfire recipes do not trigger the recipe_unlocked criteria.

crafting_shaped

Represents a shaped crafting recipe in a crafting table, the survival inventory and the crafter.

The key used in the pattern may be any single character except , the space character, which is reserved for empty slots in a recipe.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:crafting_shaped
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [Boolean] show_notification: Optional. Determines if a notification is shown when unlocking the recipe. Defaults to true.
    • [NBT List / JSON Array] pattern: A list of single-character keys used to describe a pattern for shaped crafting. Each row in the crafting grid is one string in this list containing 3 or less keys. All strings in this list need to have the same amount of keys. A space can be used to indicate an empty spot.
    • [NBT Compound / JSON Object] key: All keys used for this shaped crafting recipe.
      • [String][NBT List / JSON Array] (A key): An item that corresponds to this key. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [Int] count: Optional. The amount of the item. Falls back to 1 if the field is absent.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

Usage example json:

{
  "type": "minecraft:crafting_shaped",
  "category": "misc",
  "key": {
    "A": "minecraft:milk_bucket",
    "B": "minecraft:sugar",
    "C": "minecraft:wheat",
    "E": "#minecraft:eggs"
  },
  "pattern": [
    "AAA",
    "BEB",
    "CCC"
  ],
  "result": {
    "count": 1,
    "id": "minecraft:cake"
  }
}
Ingredients Crafting recipe Description
Milk Bucket +
Sugar +
Any Egg +
Wheat
Invicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Sugar.png: Inventory sprite for Sugar in Minecraft as shown in-game linking to Sugar with description: SugarInvicon Egg.png: Inventory sprite for Egg in Minecraft as shown in-game linking to Egg with description: EggInvicon Blue Egg.png: Inventory sprite for Blue Egg in Minecraft as shown in-game linking to Blue Egg with description: Blue EggInvicon Brown Egg.png: Inventory sprite for Brown Egg in Minecraft as shown in-game linking to Brown Egg with description: Brown EggInvicon Sugar.png: Inventory sprite for Sugar in Minecraft as shown in-game linking to Sugar with description: SugarInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: WheatInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: WheatInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: Wheat
Invicon Cake.png: Inventory sprite for Cake in Minecraft as shown in-game linking to Cake with description: Cake
Illustrative recipe.

crafting_shapeless

Represents a shapeless crafting recipe in a crafting table, the survival inventory and the crafter.

The ingredients list must have at least one and at most nine entries.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:crafting_shapeless
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [NBT List / JSON Array] ingredients: A list of entries for this shapeless crafting recipe. Must have 1 to 9 entries.
      • [String][NBT List / JSON Array]: An entry made of a single ingredient or a list of acceptable ingredients. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [Int] count: Optional. The amount of the item. Defaults to 1.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

Usage example json:

{
  "type": "minecraft:crafting_shapeless",
  "category": "equipment",
  "ingredients": [
    "minecraft:iron_ingot",
    "minecraft:flint"
  ],
  "result": {
    "count": 1,
    "id": "minecraft:flint_and_steel"
  }
}
Ingredients Crafting recipe Description
Iron Ingot +
Flint
Invicon Iron Ingot.png: Inventory sprite for Iron Ingot in Minecraft as shown in-game linking to Iron Ingot with description: Iron IngotInvicon Flint.png: Inventory sprite for Flint in Minecraft as shown in-game linking to Flint with description: Flint
Invicon Flint and Steel.png: Inventory sprite for Flint and Steel in Minecraft as shown in-game linking to Flint and Steel with description: Flint and Steel
Illustrative recipe.

If the recipe contains same 9 ingredients, it turns into minecraft:crafting_shaped recipe.

crafting_transmute

Represents a crafting recipe in a crafting table, a crafter and the survival inventory.

When matched, output copies the input item stack, changing the item type but preserving all stack components.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:crafting_transmute
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [String][NBT List / JSON Array] input: Ingredient for item to copy. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String][NBT List / JSON Array] material: Additional ingredient to use. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String] result: The output item of the recipe. It keeps item components from the input.

Usage example json:

{
  "type": "minecraft:crafting_transmute",
  "category": "misc",
  "group": "shulker_box_dye",
  "input": "#minecraft:shulker_boxes",
  "material": "minecraft:blue_dye",
  "result": {
    "id": "minecraft:blue_shulker_box"
  }
}
Ingredients Crafting recipe Description
Any Shulker Box +
Blue Dye
Invicon White Shulker Box.png: Inventory sprite for White Shulker Box in Minecraft as shown in-game linking to White Shulker Box with description: White Shulker BoxInvicon Light Gray Shulker Box.png: Inventory sprite for Light Gray Shulker Box in Minecraft as shown in-game linking to Light Gray Shulker Box with description: Light Gray Shulker BoxInvicon Gray Shulker Box.png: Inventory sprite for Gray Shulker Box in Minecraft as shown in-game linking to Gray Shulker Box with description: Gray Shulker BoxInvicon Black Shulker Box.png: Inventory sprite for Black Shulker Box in Minecraft as shown in-game linking to Black Shulker Box with description: Black Shulker BoxInvicon Brown Shulker Box.png: Inventory sprite for Brown Shulker Box in Minecraft as shown in-game linking to Brown Shulker Box with description: Brown Shulker BoxInvicon Red Shulker Box.png: Inventory sprite for Red Shulker Box in Minecraft as shown in-game linking to Red Shulker Box with description: Red Shulker BoxInvicon Orange Shulker Box.png: Inventory sprite for Orange Shulker Box in Minecraft as shown in-game linking to Orange Shulker Box with description: Orange Shulker BoxInvicon Yellow Shulker Box.png: Inventory sprite for Yellow Shulker Box in Minecraft as shown in-game linking to Yellow Shulker Box with description: Yellow Shulker BoxInvicon Lime Shulker Box.png: Inventory sprite for Lime Shulker Box in Minecraft as shown in-game linking to Lime Shulker Box with description: Lime Shulker BoxInvicon Green Shulker Box.png: Inventory sprite for Green Shulker Box in Minecraft as shown in-game linking to Green Shulker Box with description: Green Shulker BoxInvicon Cyan Shulker Box.png: Inventory sprite for Cyan Shulker Box in Minecraft as shown in-game linking to Cyan Shulker Box with description: Cyan Shulker BoxInvicon Light Blue Shulker Box.png: Inventory sprite for Light Blue Shulker Box in Minecraft as shown in-game linking to Light Blue Shulker Box with description: Light Blue Shulker BoxInvicon Blue Shulker Box.png: Inventory sprite for Blue Shulker Box in Minecraft as shown in-game linking to Blue Shulker Box with description: Blue Shulker BoxInvicon Purple Shulker Box.png: Inventory sprite for Purple Shulker Box in Minecraft as shown in-game linking to Purple Shulker Box with description: Purple Shulker BoxInvicon Magenta Shulker Box.png: Inventory sprite for Magenta Shulker Box in Minecraft as shown in-game linking to Magenta Shulker Box with description: Magenta Shulker BoxInvicon Pink Shulker Box.png: Inventory sprite for Pink Shulker Box in Minecraft as shown in-game linking to Pink Shulker Box with description: Pink Shulker BoxInvicon Blue Dye.png: Inventory sprite for Blue Dye in Minecraft as shown in-game linking to Blue Dye with description: Blue Dye
Invicon Blue Shulker Box.png: Inventory sprite for Blue Shulker Box in Minecraft as shown in-game linking to Blue Shulker Box with description: Blue Shulker Box
Illustrative recipe.

crafting_special_*

Represents a crafting recipe in a crafting table, a crafter and the survival inventory that is handled with built-in logic instead of being data-driven.

When the vanilla data pack is disabled, they can be used to re-enable desired built-in crafting recipes.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: A resource location indicating the type of serializer of the recipe.
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.

Unlike most other recipe types, they do not have a group field and cannot be displayed in recipe books.

  • crafting_special_armordye
The armor dyeing recipe.
Regular recipes cannot handle multiple dyes.
  • crafting_special_bannerduplicate
The banner copying recipe.
Regular recipes cannot copy NBT data associated to the banner item.
  • crafting_special_bookcloning
The written book copying recipe.
Regular recipes cannot copy NBT data associated to the written book item and cannot control the generation of copies.
  • crafting_special_firework_rocket
The firework rocket recipe using firework stars.
Regular recipes cannot handle inputs flexibly or add NBT data from a firework star to the firework rocket.
  • crafting_special_firework_star
  • crafting_special_firework_star_fade
The firework star crafting recipes and their fade additions.
Regular recipes cannot handle inputs flexibly or add NBT data to the firework star.
  • crafting_special_mapcloning
The map copying recipe.
Regular recipes cannot copy NBT data associated to the map item.
  • crafting_special_mapextending
The map zooming recipe.
Regular recipes cannot update NBT data associated to the map item.
  • crafting_special_repairitem
The item repair recipe.
Regular recipes cannot update damage data associated to the tool item.
  • crafting_special_shielddecoration
The shield pattern application recipe.
Regular recipes cannot add NBT data from a banner item to a shield item.
  • crafting_special_tippedarrow
The tipped arrow recipe.
Regular recipes cannot copy NBT data from a lingering potion item to a tipped arrow item.

crafting_decorated_pot

The decorated pot recipe in a crafting table and a crafter.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:crafting_decorated_pot
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.

smelting

Represents a recipe in a furnace.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:smelting
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: food, blocks, and misc. Defaults to misc.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [String][NBT List / JSON Array] ingredient: The ingredient for the recipe. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [Int] cookingtime: Optional. The cook time of the recipe in ticks. Defaults to 200.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.
    • [Double] experience: Optional. The output experience of the recipe.

Usage example json:

{
  "type": "minecraft:smelting",
  "category": "blocks",
  "cookingtime": 200,
  "experience": 0.1,
  "ingredient": "minecraft:stone_bricks",
  "result": {
    "id": "minecraft:cracked_stone_bricks"
  }
}
Name Ingredients Smelting recipe Description
Cracked Stone Bricks Stone Bricks +
Any fuel
Invicon Stone Bricks.png: Inventory sprite for Stone Bricks in Minecraft as shown in-game linking to Stone Bricks with description: Stone Bricks
Invicon Coal.png: Inventory sprite for Coal in Minecraft as shown in-game linking to Coal with description: CoalInvicon Charcoal.png: Inventory sprite for Charcoal in Minecraft as shown in-game linking to Charcoal with description: CharcoalInvicon Oak Log.png: Inventory sprite for Oak Log in Minecraft as shown in-game linking to Oak Log with description: LogInvicon Oak Planks.png: Inventory sprite for Oak Planks in Minecraft as shown in-game linking to Oak Planks with description: Overworld PlanksInvicon Lava Bucket.png: Inventory sprite for Lava Bucket in Minecraft as shown in-game linking to Lava Bucket with description: Lava BucketInvicon Block of Coal.png: Inventory sprite for Block of Coal in Minecraft as shown in-game linking to Block of Coal with description: Block of Coal

Invicon Cracked Stone Bricks.png: Inventory sprite for Cracked Stone Bricks in Minecraft as shown in-game linking to Cracked Stone Bricks with description: Cracked Stone Bricks0.1
Illustrative recipe

smithing_transform

Represents a upgrading recipe in a smithing table.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:smithing_transform
    • [String][NBT List / JSON Array] template: Optional. Ingredient specifying an item to act as the template. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String][NBT List / JSON Array] base: Ingredient specifying an item to be upgraded. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String][NBT List / JSON Array] addition: Optional. Ingredient specifying an item to be added. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [NBT Compound / JSON Object] result: Item specifying the resulting upgraded item.
      • [String] id: An item ID.
      • [Int] count: Optional. The amount of the item. Defaults to 1.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

The resulting item copies the components of the base item. Usage example json:

{
  "type": "minecraft:smithing_transform",
  "addition": "#minecraft:netherite_tool_materials",
  "base": "minecraft:diamond_axe",
  "result": {
    "id": "minecraft:netherite_axe"
  },
  "template": "minecraft:netherite_upgrade_smithing_template"
}
Ingredients Smithing recipe Description
Netherite Upgrade +
Diamond Axe +
Netherite Ingot
Invicon Netherite Upgrade Smithing Template.png: Inventory sprite for Netherite Upgrade Smithing Template in Minecraft as shown in-game linking to Netherite Upgrade Smithing Template with description: Netherite Upgrade Smithing Template Applies to:  Diamond Equipment Ingredients:  Netherite IngotInvicon Diamond Axe.png: Inventory sprite for Diamond Axe in Minecraft as shown in-game linking to Diamond Axe with description: Diamond Axe When in Main Hand:  9 Attack Damage  1 Attack SpeedInvicon Netherite Ingot.png: Inventory sprite for Netherite Ingot in Minecraft as shown in-game linking to Netherite Ingot with description: Netherite IngotInvicon Netherite Axe.png: Inventory sprite for Netherite Axe in Minecraft as shown in-game linking to Netherite Axe with description: Netherite Axe When in Main Hand:  10 Attack Damage  1 Attack Speed
Illustrative recipe.

smithing_trim

Represents a trimming recipe in a smithing table.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:smithing_trim
    • [String][NBT List / JSON Array] template: Optional. Ingredient specifying an item to act as the template. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String][NBT List / JSON Array] base: Ingredient specifying an item to be trimmed. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [String][NBT List / JSON Array] addition: Optional. Ingredient specifying an item to be added. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.

Adds NBT Tags for the trim to the base item. Usage example json:

{
  "type": "minecraft:smithing_trim",
  "addition": "#minecraft:trim_materials",
  "base": "#minecraft:trimmable_armor",
  "pattern": "minecraft:silence",
  "template": "minecraft:silence_armor_trim_smithing_template"
}
Ingredients Smithing recipe Description
Silence Armor Trim +
Any Armor Piece +
Any Material
Invicon Silence Armor Trim Smithing Template.png: Inventory sprite for Silence Armor Trim Smithing Template in Minecraft as shown in-game linking to Silence Armor Trim Smithing Template with description: Silence Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Iron Chestplate.png: Inventory sprite for Iron Chestplate in Minecraft as shown in-game linking to Iron Chestplate with description: Iron Chestplate When on Chest: +6 ArmorInvicon Golden Leggings.png: Inventory sprite for Golden Leggings in Minecraft as shown in-game linking to Golden Leggings with description: Golden Leggings When on Legs: +3 ArmorInvicon Diamond Boots.png: Inventory sprite for Diamond Boots in Minecraft as shown in-game linking to Diamond Boots with description: Diamond Boots When on Feet: +3 Armor +2 Armor ToughnessInvicon Copper Boots.png: Inventory sprite for Copper Boots in Minecraft as shown in-game linking to Copper Boots with description: Copper Boots When on Feet: +1 ArmorInvicon Chainmail Chestplate.png: Inventory sprite for Chainmail Chestplate in Minecraft as shown in-game linking to Chainmail Chestplate with description: Chainmail Chestplate When on Chest: +5 ArmorInvicon Leather Pants.png: Inventory sprite for Leather Pants in Minecraft as shown in-game linking to Leather Pants with description: Leather Pants When on Legs: +2 ArmorInvicon Turtle Shell.png: Inventory sprite for Turtle Shell in Minecraft as shown in-game linking to Turtle Shell with description: Turtle Shell When on Head: +2 ArmorInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Iron Chestplate.png: Inventory sprite for Iron Chestplate in Minecraft as shown in-game linking to Iron Chestplate with description: Iron Chestplate When on Chest: +6 ArmorInvicon Golden Leggings.png: Inventory sprite for Golden Leggings in Minecraft as shown in-game linking to Golden Leggings with description: Golden Leggings When on Legs: +3 ArmorInvicon Copper Boots.png: Inventory sprite for Copper Boots in Minecraft as shown in-game linking to Copper Boots with description: Copper Boots When on Feet: +1 ArmorInvicon Diamond Boots.png: Inventory sprite for Diamond Boots in Minecraft as shown in-game linking to Diamond Boots with description: Diamond Boots When on Feet: +3 Armor +2 Armor ToughnessInvicon Chainmail Chestplate.png: Inventory sprite for Chainmail Chestplate in Minecraft as shown in-game linking to Chainmail Chestplate with description: Chainmail Chestplate When on Chest: +5 ArmorInvicon Leather Pants.png: Inventory sprite for Leather Pants in Minecraft as shown in-game linking to Leather Pants with description: Leather Pants When on Legs: +2 ArmorInvicon Turtle Shell.png: Inventory sprite for Turtle Shell in Minecraft as shown in-game linking to Turtle Shell with description: Turtle Shell When on Head: +2 ArmorInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Amethyst Shard.png: Inventory sprite for Amethyst Shard in Minecraft as shown in-game linking to Amethyst Shard with description: Amethyst ShardInvicon Copper Ingot.png: Inventory sprite for Copper Ingot in Minecraft as shown in-game linking to Copper Ingot with description: Copper IngotInvicon Diamond.png: Inventory sprite for Diamond in Minecraft as shown in-game linking to Diamond with description: DiamondInvicon Emerald.png: Inventory sprite for Emerald in Minecraft as shown in-game linking to Emerald with description: EmeraldInvicon Resin Brick.png: Inventory sprite for Resin Brick in Minecraft as shown in-game linking to Resin Brick with description: Resin BrickInvicon Gold Ingot.png: Inventory sprite for Gold Ingot in Minecraft as shown in-game linking to Gold Ingot with description: Gold IngotInvicon Iron Ingot.png: Inventory sprite for Iron Ingot in Minecraft as shown in-game linking to Iron Ingot with description: Iron IngotInvicon Lapis Lazuli.png: Inventory sprite for Lapis Lazuli in Minecraft as shown in-game linking to Lapis Lazuli with description: Lapis LazuliInvicon Nether Quartz.png: Inventory sprite for Nether Quartz in Minecraft as shown in-game linking to Nether Quartz with description: Nether QuartzInvicon Netherite Ingot.png: Inventory sprite for Netherite Ingot in Minecraft as shown in-game linking to Netherite Ingot with description: Netherite IngotInvicon Redstone Dust.png: Inventory sprite for Redstone Dust in Minecraft as shown in-game linking to Redstone Dust with description: Redstone DustInvicon Gold Ingot.png: Inventory sprite for Gold Ingot in Minecraft as shown in-game linking to Gold Ingot with description: Gold IngotInvicon Diamond.png: Inventory sprite for Diamond in Minecraft as shown in-game linking to Diamond with description: DiamondInvicon Emerald.png: Inventory sprite for Emerald in Minecraft as shown in-game linking to Emerald with description: EmeraldInvicon Lapis Lazuli.png: Inventory sprite for Lapis Lazuli in Minecraft as shown in-game linking to Lapis Lazuli with description: Lapis LazuliInvicon Redstone Dust.png: Inventory sprite for Redstone Dust in Minecraft as shown in-game linking to Redstone Dust with description: Redstone DustInvicon Resin Brick.png: Inventory sprite for Resin Brick in Minecraft as shown in-game linking to Resin Brick with description: Resin BrickInvicon Amethyst Trim Netherite Helmet.png: Inventory sprite for Amethyst Trim Netherite Helmet in Minecraft as shown in-game linking to Amethyst Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Amethyst Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Copper Trim Iron Chestplate.png: Inventory sprite for Copper Trim Iron Chestplate in Minecraft as shown in-game linking to Copper Trim Iron Chestplate with description: Iron Chestplate Upgrade:  &zArmor Trim  Copper Material When on Chest: +6 ArmorInvicon Diamond Trim Golden Leggings.png: Inventory sprite for Diamond Trim Golden Leggings in Minecraft as shown in-game linking to Diamond Trim Golden Leggings with description: Golden Leggings Upgrade:  Armor Trim  Diamond Material When on Legs: +3 ArmorInvicon Emerald Trim Diamond Boots.png: Inventory sprite for Emerald Trim Diamond Boots in Minecraft as shown in-game linking to Emerald Trim Diamond Boots with description: Diamond Boots Upgrade:  Armor Trim  Emerald Material When on Feet: +3 Armor +2 Armor ToughnessInvicon Resin Trim Copper Boots.png: Inventory sprite for Resin Trim Copper Boots in Minecraft as shown in-game linking to Resin Trim Copper Boots with description: Copper Boots Upgrade:  Armor Trim  Resin Material When on Feet: +1 ArmorInvicon Gold Trim Chainmail Chestplate.png: Inventory sprite for Gold Trim Chainmail Chestplate in Minecraft as shown in-game linking to Gold Trim Chainmail Chestplate with description: Chainmail Chestplate Upgrade:  Armor Trim  Gold Material When on Chest: +5 ArmorInvicon Iron Trim Leather Pants.png: Inventory sprite for Iron Trim Leather Pants in Minecraft as shown in-game linking to Iron Trim Leather Pants with description: Leather Pants Upgrade:  Armor Trim  Iron Material When on Legs: +2 ArmorInvicon Lapis Trim Turtle Shell.png: Inventory sprite for Lapis Trim Turtle Shell in Minecraft as shown in-game linking to Lapis Trim Turtle Shell with description: Turtle Shell Upgrade:  Armor Trim  Lapis Material When on Head: +2 ArmorInvicon Quartz Trim Netherite Helmet.png: Inventory sprite for Quartz Trim Netherite Helmet in Minecraft as shown in-game linking to Quartz Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Quartz Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Netherite Trim Iron Chestplate.png: Inventory sprite for Netherite Trim Iron Chestplate in Minecraft as shown in-game linking to Netherite Trim Iron Chestplate with description: Iron Chestplate Upgrade:  Armor Trim  Netherite Material When on Chest: +6 ArmorInvicon Redstone Trim Golden Leggings.png: Inventory sprite for Redstone Trim Golden Leggings in Minecraft as shown in-game linking to Redstone Trim Golden Leggings with description: Golden Leggings Upgrade:  &yArmor Trim  Redstone Material When on Legs: +3 ArmorInvicon Gold Trim Copper Boots.png: Inventory sprite for Gold Trim Copper Boots in Minecraft as shown in-game linking to Gold Trim Copper Boots with description: Copper Boots Upgrade:  Armor Trim  Gold Material When on Feet: +1 ArmorInvicon Diamond Trim Diamond Boots.png: Inventory sprite for Diamond Trim Diamond Boots in Minecraft as shown in-game linking to Diamond Trim Diamond Boots with description: Diamond Boots Upgrade:  Armor Trim  Diamond Material When on Feet: +3 Armor +2 Armor ToughnessInvicon Emerald Trim Chainmail Chestplate.png: Inventory sprite for Emerald Trim Chainmail Chestplate in Minecraft as shown in-game linking to Emerald Trim Chainmail Chestplate with description: Chainmail Chestplate Upgrade:  Armor Trim  Emerald Material When on Chest: +5 ArmorInvicon Lapis Trim Leather Pants.png: Inventory sprite for Lapis Trim Leather Pants in Minecraft as shown in-game linking to Lapis Trim Leather Pants with description: Leather Pants Upgrade:  Armor Trim  Lapis Material When on Legs: +2 ArmorInvicon Redstone Trim Turtle Shell.png: Inventory sprite for Redstone Trim Turtle Shell in Minecraft as shown in-game linking to Redstone Trim Turtle Shell with description: Turtle Shell Upgrade:  &yArmor Trim  Redstone Material When on Head: +2 ArmorInvicon Resin Trim Netherite Helmet.png: Inventory sprite for Resin Trim Netherite Helmet in Minecraft as shown in-game linking to Resin Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Resin Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback Resistance
Illustrative recipe.

smoking

Represents a recipe in a smoker.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:smoking
    • [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: food. Defaults to food.
    • [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
    • [String][NBT List / JSON Array] ingredient: The ingredient for the recipe. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [Int] cookingtime: Optional. The cook time of the recipe in ticks. Defaults to 100.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.
    • [Double] experience: Optional. The output experience of the recipe.

Usage example json:

{
  "type": "minecraft:smoking",
  "category": "food",
  "cookingtime": 100,
  "experience": 0.35,
  "ingredient": "minecraft:beef",
  "result": {
    "id": "minecraft:cooked_beef"
  }
}
Name Ingredients Smelting recipe Description
Steak Raw Beef +
Any fuel
Invicon Raw Beef.png: Inventory sprite for Raw Beef in Minecraft as shown in-game linking to Raw Beef with description: Raw Beef
Invicon Coal.png: Inventory sprite for Coal in Minecraft as shown in-game linking to Coal with description: CoalInvicon Charcoal.png: Inventory sprite for Charcoal in Minecraft as shown in-game linking to Charcoal with description: CharcoalInvicon Oak Log.png: Inventory sprite for Oak Log in Minecraft as shown in-game linking to Oak Log with description: LogInvicon Oak Planks.png: Inventory sprite for Oak Planks in Minecraft as shown in-game linking to Oak Planks with description: Overworld PlanksInvicon Lava Bucket.png: Inventory sprite for Lava Bucket in Minecraft as shown in-game linking to Lava Bucket with description: Lava BucketInvicon Block of Coal.png: Inventory sprite for Block of Coal in Minecraft as shown in-game linking to Block of Coal with description: Block of Coal

Invicon Steak.png: Inventory sprite for Steak in Minecraft as shown in-game linking to Steak with description: Steak0.35
Illustrative recipe.

stonecutting

Represents a recipe in a stonecutter.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] type: minecraft:stonecutting
    • [String][NBT List / JSON Array] ingredient: The ingredient for the recipe. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
    • [NBT Compound / JSON Object] result: The output item of the recipe.
      • [String] id: An item ID.
      • [Int] count: Optional. The amount of the item. Defaults to 1.
      • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

Usage example json:

{
  "type": "minecraft:stonecutting",
  "ingredient": "minecraft:cobbled_deepslate",
  "result": {
    "count": 1,
    "id": "minecraft:cobbled_deepslate_stairs"
  }
}
Ingredients Cutting recipe Description
Cobbled Deepslate
Invicon Cobbled Deepslate.png: Inventory sprite for Cobbled Deepslate in Minecraft as shown in-game linking to Cobbled Deepslate with description: Cobbled DeepslateInvicon Cobbled Deepslate Stairs.png: Inventory sprite for Cobbled Deepslate Stairs in Minecraft as shown in-gameInvicon Cobbled Deepslate Stairs.png: Inventory sprite for Cobbled Deepslate Stairs in Minecraft as shown in-game linking to Cobbled Deepslate Stairs with description: Cobbled Deepslate Stairs
Illustrative recipe.

Bedrock Edition JSON format

Vanilla recipes are stored as separate JSON files in the behavior_packs/vanilla/recipes or behavior_packs/<version> /recipes within the game files.

Vanilla recipes can be easily accessed in the behavior_pack/recipes folder on the official sample github for addons.

Custom recipe files are stored in the behavior_packs/<add-on name>/recipes in a add-on, but it is allowed to add the recipe to a subfolder, allowing the creation of new recipes and the editing of vanilla recipes.

Recipe JSON files have different structures depending on their type. These types are listed below.

recipe_shaped

Represents a crafting recipe with shape in a crafting table, the inventory, and the crafter.

The key used in the pattern can be any single character except the space character , which is reserved for empty slots in a recipe, can also be omitted to accept the recipe format in any location that has enough space. This format is the only format that accepts multiple results.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_shaped: Used to define the recipe type.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. This can be a crafting_table or a custom crafting table tag.
      • [String] group: Optional used only for information as it has no known use.
      • [NBT List / JSON Array] pattern: A list of single-character keys used to describe a pattern for creating shapes. Each row in the creation grid is a sequence in this list containing 3 or fewer keys. All strings in this list must have the same number of keys. A space can be used to indicate empty space.
      • [NBT Compound / JSON Object] key: All keys used for this crafting recipe with shape.
        • [NBT Compound / JSON Object] A key:
          • [String] item: Used to define an item or block with the id example minecraft:emerald_block.
          • [String] data: Optional. Integer or Molang expression for dynamic variants.
          • [String] tag: Used to define an item tag example minecraft:planks also accepts custom tags.
      • [NBT List / JSON Array] unlock: Defines the items that unlock the recipe when caught.
        • [NBT Compound / JSON Object]:
        • [String] item: Used to define an item or block that unlocks the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [String] tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
        • [String] context: Used to unlock recipes with context currently only known values are AlwaysUnlocked and PlayerInWater.
      • [NBT Compound / JSON Object] result: Defines the recipe result.
        • [String] item: Used to define an item or block that you will receive when crafting the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [Int] count: Optional. Number of items manufactured example 3.
      • [Int] priority: Optional, used to give priority if the same recipe exists in duplicate.

Usage example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_shaped": {
    "description": {
    "identifier": "minecraft:cake"
    },

    
    "tags": [ "crafting_table" ],
    "pattern": [
      "AAA",
      "BEB",
      "CCC"
    ],
    "key": {
      "A": {
        "item": "minecraft:bucket",
        "data": 1
      },
      "B": {
        "item": "minecraft:sugar"
      },
      "C": {
        "item": "minecraft:wheat"
      },
      "E": {
        "tag": "minecraft:egg"
      }
    },
	"unlock": [
      {
        "tag": "minecraft:egg"
      }
    ],
   "result": {
      "item": "minecraft:cake",
      "count": 1
    } // for single result

    "result": [
      { "item": "minecraft:cake" },
      { "item": "minecraft:bucket", "count": 3, "data": 0 } // to have multiple results
    ]
  }
}
Ingredients Crafting recipe Description
Milk Bucket +
Sugar +
Any Egg +
Wheat
Invicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Milk Bucket.png: Inventory sprite for Milk Bucket in Minecraft as shown in-game linking to Milk Bucket with description: Milk BucketInvicon Sugar.png: Inventory sprite for Sugar in Minecraft as shown in-game linking to Sugar with description: SugarInvicon Egg.png: Inventory sprite for Egg in Minecraft as shown in-game linking to Egg with description: EggInvicon Blue Egg.png: Inventory sprite for Blue Egg in Minecraft as shown in-game linking to Blue Egg with description: Blue EggInvicon Brown Egg.png: Inventory sprite for Brown Egg in Minecraft as shown in-game linking to Brown Egg with description: Brown EggInvicon Sugar.png: Inventory sprite for Sugar in Minecraft as shown in-game linking to Sugar with description: SugarInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: WheatInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: WheatInvicon Wheat.png: Inventory sprite for Wheat in Minecraft as shown in-game linking to Wheat with description: Wheat
Invicon Cake.png: Inventory sprite for Cake in Minecraft as shown in-game linking to Cake with description: Cake
Illustrative recipe.

recipe_shapeless

Represents a shapeless crafting recipe in a crafting table, inventory and the crafter, and is also used for the stonecutter.

The ingredient list must have at least one and a maximum of nine entries. Unlike a recipe shaped, multiple results are not possible.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_shapeless: Used to set the type recipe shapeless.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. This can be crafting_table for the crafting table, stonecutter for the stonecutter, or a custom crafting table tag.
      • [String] group: Optional used only for information as it has no known use.
      • [NBT List / JSON Array] ingredients: All items used for this shapeless crafting recipe.
        • [NBT Compound / JSON Object]:
          • [String] item: Used to define an item or block with the id example minecraft:emerald_block.
          • [String] data: Optional. Integer or Molang expression for dynamic variants.
          • [String] tag: Used to define an item tag example minecraft:planks also accepts custom tags.
      • [NBT List / JSON Array] unlock: Defines the items that unlock the recipe when purchased.
        • [NBT Compound / JSON Object]:
        • [String] item: Used to define an item or block that unlocks the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [String] tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
        • [String] context: Used to unlock recipes with context currently only known values are AlwaysUnlocked and PlayerInWater.
      • [NBT Compound / JSON Object] result: Defines the result of the recipe.
        • [String] item: Used to define an item or block that you will receive when crafting the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [Int] count: Optional. Number of items produced example 3.
      • [Int] priority: Optional, used to give priority if the same recipe exists in duplicate.

Crafting table example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_shapeless": {
    "description": {
    "identifier": "minecraft:flint_and_steel"
    },

    
    "tags": [ "crafting_table" ],
    "ingredients": [
      {
        "item": "minecraft:iron_ingot"
      },
      {
        "item": "minecraft:flint"
      }
    ],
	"unlock": [
      {
        "item": "minecraft:flint"
	  },
	  {
		"item": "minecraft:obsidian"
      }
    ],
    "result": {
      "item": "minecraft:flint_and_steel"
    }
  }
}
Ingredients Crafting recipe Description
Iron Ingot +
Flint
Invicon Iron Ingot.png: Inventory sprite for Iron Ingot in Minecraft as shown in-game linking to Iron Ingot with description: Iron IngotInvicon Flint.png: Inventory sprite for Flint in Minecraft as shown in-game linking to Flint with description: Flint
Invicon Flint and Steel.png: Inventory sprite for Flint and Steel in Minecraft as shown in-game linking to Flint and Steel with description: Flint and Steel
Illustrative recipe.

Stonecutter Example Json:

{
    "format_version": "1.20.10",
    "minecraft:recipe_shapeless": {
        "description": {
            "identifier": "minecraft:polished_deepslate_stairs_from_cobbled_deepslate_stonecutting"
        },
      "tags": ["stonecutter"],
        "ingredients": [
            {
                "data": 0,
                "item": "minecraft:cobbled_deepslate"
            }
        ],
        "unlock": [
          {
            "item": "minecraft:cobbled_deepslate"
          }
        ],
        "result": {
            "count": 1,
            "data": 0,
            "item": "minecraft:polished_deepslate_stairs"
        },
      "priority": 0
    }
}
Ingredients Cutting recipe Description
Cobbled Deepslate
Invicon Cobbled Deepslate.png: Inventory sprite for Cobbled Deepslate in Minecraft as shown in-game linking to Cobbled Deepslate with description: Cobbled DeepslateInvicon Cobbled Deepslate Stairs.png: Inventory sprite for Cobbled Deepslate Stairs in Minecraft as shown in-gameInvicon Cobbled Deepslate Stairs.png: Inventory sprite for Cobbled Deepslate Stairs in Minecraft as shown in-game linking to Cobbled Deepslate Stairs with description: Cobbled Deepslate Stairs
Illustrative recipe.

recipe_furnace

Represents a smelting recipe in a furnace, blast furnace, smoker, campfire and the soul campfire.

It is not possible to set the amount of experience you will receive when smelting the item.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_furnace: Used to set the type of smelting recipe.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. It can be furnace for the standard furnace, blast_furnace for the blast furnace, smoker for the smoker, campfire for the campfire and soul_campfire for the soul campfire. Unlike it does not support custom tags.
      • [String] group: Optional used only for information as it has no known use.
      • [NBT Compound / JSON Object] input: All items used for this smelting recipe.
        • [String] item: Used to define an item or block with the id example minecraft:diamond_chestplate.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [String] tag: Used to define an item tag example minecraft:planks also accepts custom tags.
      • [NBT List / JSON Array] unlock: Defines the items that unlock the recipe, but without use as there is no recipe book for smelting blocks.
        • [NBT Compound / JSON Object]:
        • [String] item: Used to define an item or block that unlocks the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [String] tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
        • [String] context: Used to unlock recipes with context currently only known values are AlwaysUnlocked and PlayerInWater.
      • [NBT Compound / JSON Object] output: Defines the result of the recipe.
        • [String] item: Used to define an item or block that you will receive when crafting the recipe.
        • [String] data: Optional. Integer or Molang expression for dynamic variants.
        • [Int] count: Optional. Number of items manufactured example 3.
      • [Int] priority: Optional, used to give priority if the same recipe exists in duplicate.

Usage example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_furnace": {
    "description": {
    "identifier": "minecraft:furnace_log"
    },
    "unlock": [
      {
        "tag": "minecraft:logs_that_burn"
      }
    ],
    "tags": ["furnace"],
    "input": {
      "tag": "minecraft:logs_that_burn"
    },
    "output": {
      "item": "minecraft:charcoal",
      "count": 1
     },
    "priority": -1
  }
}
Ingredients Smelting recipe Description
Any Log or 
Any Stripped Log +
Any fuel
Invicon Oak Log.png: Inventory sprite for Oak Log in Minecraft as shown in-game linking to Oak Log with description: Oak LogInvicon Spruce Log.png: Inventory sprite for Spruce Log in Minecraft as shown in-game linking to Spruce Log with description: Spruce LogInvicon Birch Log.png: Inventory sprite for Birch Log in Minecraft as shown in-game linking to Birch Log with description: Birch LogInvicon Jungle Log.png: Inventory sprite for Jungle Log in Minecraft as shown in-game linking to Jungle Log with description: Jungle LogInvicon Acacia Log.png: Inventory sprite for Acacia Log in Minecraft as shown in-game linking to Acacia Log with description: Acacia LogInvicon Dark Oak Log.png: Inventory sprite for Dark Oak Log in Minecraft as shown in-game linking to Dark Oak Log with description: Dark Oak LogInvicon Mangrove Log.png: Inventory sprite for Mangrove Log in Minecraft as shown in-game linking to Mangrove Log with description: Mangrove LogInvicon Cherry Log.png: Inventory sprite for Cherry Log in Minecraft as shown in-game linking to Cherry Log with description: Cherry LogInvicon Pale Oak Log.png: Inventory sprite for Pale Oak Log in Minecraft as shown in-game linking to Pale Oak Log with description: Pale Oak LogInvicon Stripped Oak Log.png: Inventory sprite for Stripped Oak Log in Minecraft as shown in-game linking to Stripped Oak Log with description: Stripped Oak LogInvicon Stripped Spruce Log.png: Inventory sprite for Stripped Spruce Log in Minecraft as shown in-game linking to Stripped Spruce Log with description: Stripped Spruce LogInvicon Stripped Birch Log.png: Inventory sprite for Stripped Birch Log in Minecraft as shown in-game linking to Stripped Birch Log with description: Stripped Birch LogInvicon Stripped Jungle Log.png: Inventory sprite for Stripped Jungle Log in Minecraft as shown in-game linking to Stripped Jungle Log with description: Stripped Jungle LogInvicon Stripped Acacia Log.png: Inventory sprite for Stripped Acacia Log in Minecraft as shown in-game linking to Stripped Acacia Log with description: Stripped Acacia LogInvicon Stripped Dark Oak Log.png: Inventory sprite for Stripped Dark Oak Log in Minecraft as shown in-game linking to Stripped Dark Oak Log with description: Stripped Dark Oak LogInvicon Stripped Mangrove Log.png: Inventory sprite for Stripped Mangrove Log in Minecraft as shown in-game linking to Stripped Mangrove Log with description: Stripped Mangrove LogInvicon Stripped Cherry Log.png: Inventory sprite for Stripped Cherry Log in Minecraft as shown in-game linking to Stripped Cherry Log with description: Stripped Cherry LogInvicon Stripped Pale Oak Log.png: Inventory sprite for Stripped Pale Oak Log in Minecraft as shown in-game linking to Stripped Pale Oak Log with description: Stripped Pale Oak Log
Invicon Coal.png: Inventory sprite for Coal in Minecraft as shown in-game linking to Coal with description: CoalInvicon Charcoal.png: Inventory sprite for Charcoal in Minecraft as shown in-game linking to Charcoal with description: CharcoalInvicon Oak Log.png: Inventory sprite for Oak Log in Minecraft as shown in-game linking to Oak Log with description: LogInvicon Oak Planks.png: Inventory sprite for Oak Planks in Minecraft as shown in-game linking to Oak Planks with description: Overworld PlanksInvicon Lava Bucket.png: Inventory sprite for Lava Bucket in Minecraft as shown in-game linking to Lava Bucket with description: Lava BucketInvicon Block of Coal.png: Inventory sprite for Block of Coal in Minecraft as shown in-game linking to Block of Coal with description: Block of Coal

Invicon Charcoal.png: Inventory sprite for Charcoal in Minecraft as shown in-game linking to Charcoal with description: Charcoal
Illustrative recipe.

recipe_smithing_trim

Represents a smithing recipe at a smithing table for adding trims.

It is not possible to create a custom one this is for documentation purposes only.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_smithing_trim: Used to set the type of smithing recipe.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. It can be smithing_table it does not support custom tags.
      • [NBT Compound / JSON Object] template: Used to define a template.
        • [String] tag: Used to set an item tag using minecraft:trim_templates but has no effect on custom items with that tag.
      • [NBT Compound / JSON Object] base: Defines the base items that will be used.
        • [String] tag: Used to set an item tag for the recipe being used minecraft:trimmable_armors Using this tag on a custom item allows the custom armor to be trimmed.
      • [NBT Compound / JSON Object] addition: Used to define a material.
        • [String] tag: Used to set an item tag for the recipe being used minecraft:trim_materials using this tag on a custom item has no effect.

Usage example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_smithing_trim": {
    "description": {
      "identifier": "minecraft:smithing_armor_trim"
    },
    "tags": [ "smithing_table" ],
    "template": {
      "tag": "minecraft:trim_templates"
    },
    "base": {
      "tag": "minecraft:trimmable_armors"
    },
    "addition": {
      "tag": "minecraft:trim_materials"
    }
  }
}
Ingredients Smithing recipe Description
Any Armor Trim +
Any Armor Piece +
Any Material
Invicon Bolt Armor Trim Smithing Template.png: Inventory sprite for Bolt Armor Trim Smithing Template in Minecraft as shown in-game linking to Bolt Armor Trim Smithing Template with description: Bolt Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Coast Armor Trim Smithing Template.png: Inventory sprite for Coast Armor Trim Smithing Template in Minecraft as shown in-game linking to Coast Armor Trim Smithing Template with description: Coast Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Dune Armor Trim Smithing Template.png: Inventory sprite for Dune Armor Trim Smithing Template in Minecraft as shown in-game linking to Dune Armor Trim Smithing Template with description: Dune Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Eye Armor Trim Smithing Template.png: Inventory sprite for Eye Armor Trim Smithing Template in Minecraft as shown in-game linking to Eye Armor Trim Smithing Template with description: Eye Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Flow Armor Trim Smithing Template.png: Inventory sprite for Flow Armor Trim Smithing Template in Minecraft as shown in-game linking to Flow Armor Trim Smithing Template with description: Flow Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Host Armor Trim Smithing Template.png: Inventory sprite for Host Armor Trim Smithing Template in Minecraft as shown in-game linking to Host Armor Trim Smithing Template with description: Host Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Raiser Armor Trim Smithing Template.png: Inventory sprite for Raiser Armor Trim Smithing Template in Minecraft as shown in-game linking to Raiser Armor Trim Smithing Template with description: Raiser Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Rib Armor Trim Smithing Template.png: Inventory sprite for Rib Armor Trim Smithing Template in Minecraft as shown in-game linking to Rib Armor Trim Smithing Template with description: Rib Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Sentry Armor Trim Smithing Template.png: Inventory sprite for Sentry Armor Trim Smithing Template in Minecraft as shown in-game linking to Sentry Armor Trim Smithing Template with description: Sentry Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Shaper Armor Trim Smithing Template.png: Inventory sprite for Shaper Armor Trim Smithing Template in Minecraft as shown in-game linking to Shaper Armor Trim Smithing Template with description: Shaper Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Silence Armor Trim Smithing Template.png: Inventory sprite for Silence Armor Trim Smithing Template in Minecraft as shown in-game linking to Silence Armor Trim Smithing Template with description: Silence Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Snout Armor Trim Smithing Template.png: Inventory sprite for Snout Armor Trim Smithing Template in Minecraft as shown in-game linking to Snout Armor Trim Smithing Template with description: Snout Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Spire Armor Trim Smithing Template.png: Inventory sprite for Spire Armor Trim Smithing Template in Minecraft as shown in-game linking to Spire Armor Trim Smithing Template with description: Spire Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Tide Armor Trim Smithing Template.png: Inventory sprite for Tide Armor Trim Smithing Template in Minecraft as shown in-game linking to Tide Armor Trim Smithing Template with description: Tide Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Vex Armor Trim Smithing Template.png: Inventory sprite for Vex Armor Trim Smithing Template in Minecraft as shown in-game linking to Vex Armor Trim Smithing Template with description: Vex Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Ward Armor Trim Smithing Template.png: Inventory sprite for Ward Armor Trim Smithing Template in Minecraft as shown in-game linking to Ward Armor Trim Smithing Template with description: Ward Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Wayfinder Armor Trim Smithing Template.png: Inventory sprite for Wayfinder Armor Trim Smithing Template in Minecraft as shown in-game linking to Wayfinder Armor Trim Smithing Template with description: Wayfinder Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Wild Armor Trim Smithing Template.png: Inventory sprite for Wild Armor Trim Smithing Template in Minecraft as shown in-game linking to Wild Armor Trim Smithing Template with description: Wild Armor Trim Smithing Template Applies to:  Armor Ingredients:  Ingot & CrystalsInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Iron Chestplate.png: Inventory sprite for Iron Chestplate in Minecraft as shown in-game linking to Iron Chestplate with description: Iron Chestplate When on Chest: +6 ArmorInvicon Golden Leggings.png: Inventory sprite for Golden Leggings in Minecraft as shown in-game linking to Golden Leggings with description: Golden Leggings When on Legs: +3 ArmorInvicon Diamond Boots.png: Inventory sprite for Diamond Boots in Minecraft as shown in-game linking to Diamond Boots with description: Diamond Boots When on Feet: +3 Armor +2 Armor ToughnessInvicon Copper Boots.png: Inventory sprite for Copper Boots in Minecraft as shown in-game linking to Copper Boots with description: Copper Boots When on Feet: +1 ArmorInvicon Chainmail Chestplate.png: Inventory sprite for Chainmail Chestplate in Minecraft as shown in-game linking to Chainmail Chestplate with description: Chainmail Chestplate When on Chest: +5 ArmorInvicon Leather Pants.png: Inventory sprite for Leather Pants in Minecraft as shown in-game linking to Leather Pants with description: Leather Pants When on Legs: +2 ArmorInvicon Turtle Shell.png: Inventory sprite for Turtle Shell in Minecraft as shown in-game linking to Turtle Shell with description: Turtle Shell When on Head: +2 ArmorInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Iron Chestplate.png: Inventory sprite for Iron Chestplate in Minecraft as shown in-game linking to Iron Chestplate with description: Iron Chestplate When on Chest: +6 ArmorInvicon Golden Leggings.png: Inventory sprite for Golden Leggings in Minecraft as shown in-game linking to Golden Leggings with description: Golden Leggings When on Legs: +3 ArmorInvicon Copper Boots.png: Inventory sprite for Copper Boots in Minecraft as shown in-game linking to Copper Boots with description: Copper Boots When on Feet: +1 ArmorInvicon Diamond Boots.png: Inventory sprite for Diamond Boots in Minecraft as shown in-game linking to Diamond Boots with description: Diamond Boots When on Feet: +3 Armor +2 Armor ToughnessInvicon Chainmail Chestplate.png: Inventory sprite for Chainmail Chestplate in Minecraft as shown in-game linking to Chainmail Chestplate with description: Chainmail Chestplate When on Chest: +5 ArmorInvicon Leather Pants.png: Inventory sprite for Leather Pants in Minecraft as shown in-game linking to Leather Pants with description: Leather Pants When on Legs: +2 ArmorInvicon Turtle Shell.png: Inventory sprite for Turtle Shell in Minecraft as shown in-game linking to Turtle Shell with description: Turtle Shell When on Head: +2 ArmorInvicon Netherite Helmet.png: Inventory sprite for Netherite Helmet in Minecraft as shown in-game linking to Netherite Helmet with description: Netherite Helmet When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Amethyst Shard.png: Inventory sprite for Amethyst Shard in Minecraft as shown in-game linking to Amethyst Shard with description: Amethyst ShardInvicon Copper Ingot.png: Inventory sprite for Copper Ingot in Minecraft as shown in-game linking to Copper Ingot with description: Copper IngotInvicon Diamond.png: Inventory sprite for Diamond in Minecraft as shown in-game linking to Diamond with description: DiamondInvicon Emerald.png: Inventory sprite for Emerald in Minecraft as shown in-game linking to Emerald with description: EmeraldInvicon Resin Brick.png: Inventory sprite for Resin Brick in Minecraft as shown in-game linking to Resin Brick with description: Resin BrickInvicon Gold Ingot.png: Inventory sprite for Gold Ingot in Minecraft as shown in-game linking to Gold Ingot with description: Gold IngotInvicon Iron Ingot.png: Inventory sprite for Iron Ingot in Minecraft as shown in-game linking to Iron Ingot with description: Iron IngotInvicon Lapis Lazuli.png: Inventory sprite for Lapis Lazuli in Minecraft as shown in-game linking to Lapis Lazuli with description: Lapis LazuliInvicon Nether Quartz.png: Inventory sprite for Nether Quartz in Minecraft as shown in-game linking to Nether Quartz with description: Nether QuartzInvicon Netherite Ingot.png: Inventory sprite for Netherite Ingot in Minecraft as shown in-game linking to Netherite Ingot with description: Netherite IngotInvicon Redstone Dust.png: Inventory sprite for Redstone Dust in Minecraft as shown in-game linking to Redstone Dust with description: Redstone DustInvicon Gold Ingot.png: Inventory sprite for Gold Ingot in Minecraft as shown in-game linking to Gold Ingot with description: Gold IngotInvicon Diamond.png: Inventory sprite for Diamond in Minecraft as shown in-game linking to Diamond with description: DiamondInvicon Emerald.png: Inventory sprite for Emerald in Minecraft as shown in-game linking to Emerald with description: EmeraldInvicon Lapis Lazuli.png: Inventory sprite for Lapis Lazuli in Minecraft as shown in-game linking to Lapis Lazuli with description: Lapis LazuliInvicon Redstone Dust.png: Inventory sprite for Redstone Dust in Minecraft as shown in-game linking to Redstone Dust with description: Redstone DustInvicon Resin Brick.png: Inventory sprite for Resin Brick in Minecraft as shown in-game linking to Resin Brick with description: Resin BrickInvicon Amethyst Trim Netherite Helmet.png: Inventory sprite for Amethyst Trim Netherite Helmet in Minecraft as shown in-game linking to Amethyst Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Amethyst Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Copper Trim Iron Chestplate.png: Inventory sprite for Copper Trim Iron Chestplate in Minecraft as shown in-game linking to Copper Trim Iron Chestplate with description: Iron Chestplate Upgrade:  &zArmor Trim  Copper Material When on Chest: +6 ArmorInvicon Diamond Trim Golden Leggings.png: Inventory sprite for Diamond Trim Golden Leggings in Minecraft as shown in-game linking to Diamond Trim Golden Leggings with description: Golden Leggings Upgrade:  Armor Trim  Diamond Material When on Legs: +3 ArmorInvicon Emerald Trim Diamond Boots.png: Inventory sprite for Emerald Trim Diamond Boots in Minecraft as shown in-game linking to Emerald Trim Diamond Boots with description: Diamond Boots Upgrade:  Armor Trim  Emerald Material When on Feet: +3 Armor +2 Armor ToughnessInvicon Resin Trim Copper Boots.png: Inventory sprite for Resin Trim Copper Boots in Minecraft as shown in-game linking to Resin Trim Copper Boots with description: Copper Boots Upgrade:  Armor Trim  Resin Material When on Feet: +1 ArmorInvicon Gold Trim Chainmail Chestplate.png: Inventory sprite for Gold Trim Chainmail Chestplate in Minecraft as shown in-game linking to Gold Trim Chainmail Chestplate with description: Chainmail Chestplate Upgrade:  Armor Trim  Gold Material When on Chest: +5 ArmorInvicon Iron Trim Leather Pants.png: Inventory sprite for Iron Trim Leather Pants in Minecraft as shown in-game linking to Iron Trim Leather Pants with description: Leather Pants Upgrade:  Armor Trim  Iron Material When on Legs: +2 ArmorInvicon Lapis Trim Turtle Shell.png: Inventory sprite for Lapis Trim Turtle Shell in Minecraft as shown in-game linking to Lapis Trim Turtle Shell with description: Turtle Shell Upgrade:  Armor Trim  Lapis Material When on Head: +2 ArmorInvicon Quartz Trim Netherite Helmet.png: Inventory sprite for Quartz Trim Netherite Helmet in Minecraft as shown in-game linking to Quartz Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Quartz Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback ResistanceInvicon Netherite Trim Iron Chestplate.png: Inventory sprite for Netherite Trim Iron Chestplate in Minecraft as shown in-game linking to Netherite Trim Iron Chestplate with description: Iron Chestplate Upgrade:  Armor Trim  Netherite Material When on Chest: +6 ArmorInvicon Redstone Trim Golden Leggings.png: Inventory sprite for Redstone Trim Golden Leggings in Minecraft as shown in-game linking to Redstone Trim Golden Leggings with description: Golden Leggings Upgrade:  &yArmor Trim  Redstone Material When on Legs: +3 ArmorInvicon Gold Trim Copper Boots.png: Inventory sprite for Gold Trim Copper Boots in Minecraft as shown in-game linking to Gold Trim Copper Boots with description: Copper Boots Upgrade:  Armor Trim  Gold Material When on Feet: +1 ArmorInvicon Diamond Trim Diamond Boots.png: Inventory sprite for Diamond Trim Diamond Boots in Minecraft as shown in-game linking to Diamond Trim Diamond Boots with description: Diamond Boots Upgrade:  Armor Trim  Diamond Material When on Feet: +3 Armor +2 Armor ToughnessInvicon Emerald Trim Chainmail Chestplate.png: Inventory sprite for Emerald Trim Chainmail Chestplate in Minecraft as shown in-game linking to Emerald Trim Chainmail Chestplate with description: Chainmail Chestplate Upgrade:  Armor Trim  Emerald Material When on Chest: +5 ArmorInvicon Lapis Trim Leather Pants.png: Inventory sprite for Lapis Trim Leather Pants in Minecraft as shown in-game linking to Lapis Trim Leather Pants with description: Leather Pants Upgrade:  Armor Trim  Lapis Material When on Legs: +2 ArmorInvicon Redstone Trim Turtle Shell.png: Inventory sprite for Redstone Trim Turtle Shell in Minecraft as shown in-game linking to Redstone Trim Turtle Shell with description: Turtle Shell Upgrade:  &yArmor Trim  Redstone Material When on Head: +2 ArmorInvicon Resin Trim Netherite Helmet.png: Inventory sprite for Resin Trim Netherite Helmet in Minecraft as shown in-game linking to Resin Trim Netherite Helmet with description: Netherite Helmet Upgrade:  Armor Trim  Resin Material When on Head: +3 Armor +3 Armor Toughness +1 Knockback Resistance
Illustrative recipe.

recipe_smithing_transform

Represents a smithing recipe at a smithing table to perform a upgrading.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_smithing_transform: Used to set the type of smithing recipe.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. It can be smithing_table it does not support custom tags.
      • [String] template: Used to define a netherite upgrade accepting custom items if they have the item tag minecraft:transform_templates.
      • [String] base: Defines the base items that will be used, the custom item needs to have the item tag minecraft:transformable_items.
      • [String] addition: Used to define a base material, custom items with the minecraft:transform_materials tag can be placed, however it does not work. The only truly valid item is the netherite ingot with the id minecraft:netherite_ingot.
      • [String] result: Used to set an item as a recipe result.

Usage example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_smithing_transform": {
    "description": {
      "identifier": "minecraft:smithing_netherite_chestplate"
    },
    "tags": [ "smithing_table" ],
    "template": "minecraft:netherite_upgrade_smithing_template",
    "base": "minecraft:diamond_chestplate",
    "addition": "minecraft:netherite_ingot",
    "result": "minecraft:netherite_chestplate"
  }
}
Ingredients Smithing recipe Description
Netherite Upgrade +
Diamond Chestplate +
Netherite Ingot
Invicon Netherite Upgrade Smithing Template.png: Inventory sprite for Netherite Upgrade Smithing Template in Minecraft as shown in-game linking to Netherite Upgrade Smithing Template with description: Netherite Upgrade Smithing Template Applies to:  Diamond Equipment Ingredients:  Netherite IngotInvicon Diamond Chestplate.png: Inventory sprite for Diamond Chestplate in Minecraft as shown in-game linking to Diamond Chestplate with description: Diamond Chestplate When on Chest: +8 Armor +2 Armor ToughnessInvicon Netherite Ingot.png: Inventory sprite for Netherite Ingot in Minecraft as shown in-game linking to Netherite Ingot with description: Netherite IngotInvicon Netherite Chestplate.png: Inventory sprite for Netherite Chestplate in Minecraft as shown in-game linking to Netherite Chestplate with description: Netherite Chestplate When on Chest: +8 Armor +3 Armor Toughness +1 Knockback Resistance
Illustrative recipe.

recipe_brewing_mix

Represents a brewing recipe on a brewing stand.

Vanilla potions use this system minecraft:potion_type:<potion_effect> can be added long_ or strong_ for other types like minecraft:potion_type:strong_poison also accepted is minecraft:potion, minecraft:splash_potion and minecraft:lingering_potion.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_brewing_mix: Used to set the fermentation recipe type.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. brewing_stand does not support custom tags.
      • [String] input: Item used for this brew recipe, supports custom items and vanilla items in the format mentioned above.
      • [String] reagent: Used to define an item or block that is used as an ingredient also supports custom items.
      • [String] output: Recipe result item, supports custom items and vanilla items in the format mentioned above.

Usage example json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_brewing_mix": {
    "description": {
      "identifier": "minecraft:brew_awkward_poison"
    },
    "tags": [ "brewing_stand" ],

    "input": "minecraft:potion_type:awkward",
    "reagent": "minecraft:spider_eye",
    "output": "minecraft:potion_type:poison"
  }
}
Ingredients Brewing recipe Description
Spider Eye +
Awkward Potion

Invicon Spider Eye.png: Inventory sprite for Spider Eye in Minecraft as shown in-game linking to Spider Eye with description: Spider Eye

Invicon Awkward Potion.png: Inventory sprite for Awkward Potion in Minecraft as shown in-game linking to Awkward Potion with description: Awkward Potion No EffectsInvicon Awkward Splash Potion.png: Inventory sprite for Awkward Splash Potion in Minecraft as shown in-game linking to Awkward Splash Potion with description: Awkward Splash Potion No EffectsInvicon Awkward Lingering Potion.png: Inventory sprite for Awkward Lingering Potion in Minecraft as shown in-game linking to Awkward Lingering Potion with description: Awkward Lingering Potion No Effects


Invicon Potion of Poison.png: Inventory sprite for Potion of Poison in Minecraft as shown in-game linking to Potion of Poison with description: Potion of Poison Poison (00:45)Invicon Splash Potion of Poison.png: Inventory sprite for Splash Potion of Poison in Minecraft as shown in-game linking to Splash Potion of Poison with description: Splash Potion of Poison Poison (00:45)Invicon Lingering Potion of Poison.png: Inventory sprite for Lingering Potion of Poison in Minecraft as shown in-game linking to Lingering Potion of Poison with description: Lingering Potion of Poison Poison (00:11)
Illustrative recipe.

recipe_brewing_container

Represents a brewing recipe focused on changing one type into another in a brewing stand.

Vanilla potions use this system minecraft:potion_type:<potion_effect> can be added long_ or strong_ for other types like minecraft:potion_type:strong_poison also accepted is minecraft:potion, minecraft:splash_potion and minecraft:lingering_potion.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_brewing_container: Used to set the fermentation recipe type.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String][NBT List / JSON Array] tags: Defines where the recipe can be used. brewing_stand does not support custom tags.
      • [String] input: Item used for this brewing recipe, unlike the mix only supports vanilla potions items in the format mentioned above.
      • [String] reagent: Used to define an item or block that is used as an ingredient also supports custom items.
      • [String] output: Recipe result item, supports custom items and vanilla items in the format mentioned above.

Usage example json:

{
  "format_version": "1.20.10",
"minecraft:recipe_brewing_container": {
    "description": {
      "identifier": "minecraft:brew_potion_sulphur"
    },
    "tags": [ "brewing_stand" ],

    "input": "minecraft:potion",
    "reagent": "minecraft:gunpowder",
    "output": "minecraft:splash_potion"
  }
}
Ingredients Brewing recipe Description
Gunpowder +
Any Potion

Invicon Gunpowder.png: Inventory sprite for Gunpowder in Minecraft as shown in-game linking to Gunpowder with description: Gunpowder

Invicon Water Bottle.png: Inventory sprite for Water Bottle in Minecraft as shown in-game linking to Water Bottle with description: Water Bottle No EffectsInvicon Awkward Potion.png: Inventory sprite for Awkward Potion in Minecraft as shown in-game linking to Awkward Potion with description: Awkward Potion No EffectsInvicon Thick Potion.png: Inventory sprite for Thick Potion in Minecraft as shown in-game linking to Thick Potion with description: Thick Potion No EffectsInvicon Mundane Potion.png: Inventory sprite for Mundane Potion in Minecraft as shown in-game linking to Mundane Potion with description: Mundane Potion No EffectsInvicon Potion of Regeneration.png: Inventory sprite for Potion of Regeneration in Minecraft as shown in-game linking to Potion of Regeneration with description: Potion of Regeneration Regeneration (00:45)Invicon Potion of Swiftness.png: Inventory sprite for Potion of Swiftness in Minecraft as shown in-game linking to Potion of Swiftness with description: Potion of Swiftness Speed (03:00) When Applied: +20% SpeedInvicon Potion of Fire Resistance.png: Inventory sprite for Potion of Fire Resistance in Minecraft as shown in-game linking to Potion of Fire Resistance with description: Potion of Fire Resistance Fire Resistance (03:00)Invicon Potion of Poison.png: Inventory sprite for Potion of Poison in Minecraft as shown in-game linking to Potion of Poison with description: Potion of Poison Poison (00:45)Invicon Potion of Healing.png: Inventory sprite for Potion of Healing in Minecraft as shown in-game linking to Potion of Healing with description: Potion of Healing Instant HealthInvicon Potion of Night Vision.png: Inventory sprite for Potion of Night Vision in Minecraft as shown in-game linking to Potion of Night Vision with description: Potion of Night Vision Night Vision (03:00)Invicon Potion of Weakness.png: Inventory sprite for Potion of Weakness in Minecraft as shown in-game linking to Potion of Weakness with description: Potion of Weakness Weakness (01:30) When Applied: -4 Attack DamageInvicon Potion of Strength.png: Inventory sprite for Potion of Strength in Minecraft as shown in-game linking to Potion of Strength with description: Potion of Strength Strength (03:00) When Applied: +3 Attack DamageInvicon Potion of Slowness.png: Inventory sprite for Potion of Slowness in Minecraft as shown in-game linking to Potion of Slowness with description: Potion of Slowness Slowness (01:30) When Applied: -15% SpeedInvicon Potion of Leaping.png: Inventory sprite for Potion of Leaping in Minecraft as shown in-game linking to Potion of Leaping with description: Potion of Leaping Jump Boost (03:00) When Applied: +1 Safe Fall DistanceInvicon Potion of Harming.png: Inventory sprite for Potion of Harming in Minecraft as shown in-game linking to Potion of Harming with description: Potion of Harming Instant DamageInvicon Potion of Water Breathing.png: Inventory sprite for Potion of Water Breathing in Minecraft as shown in-game linking to Potion of Water Breathing with description: Potion of Water Breathing Water Breathing (03:00)Invicon Potion of Invisibility.png: Inventory sprite for Potion of Invisibility in Minecraft as shown in-game linking to Potion of Invisibility with description: Potion of Invisibility Invisibility (03:00) When Applied: -100% Waypoint Transmit RangeInvicon Potion of Slow Falling.png: Inventory sprite for Potion of Slow Falling in Minecraft as shown in-game linking to Potion of Slow Falling with description: Potion of Slow Falling Slow Falling (01:30)Invicon Potion of Luck.png: Inventory sprite for Potion of Luck in Minecraft as shown in-game linking to Potion of Luck with description: Potion of Luck Luck (05:00) When Applied: +1 LuckInvicon Potion of Decay.png: Inventory sprite for Potion of Decay in Minecraft as shown in-game linking to Potion of Decay with description: Potion of Decay Wither II (00:40)Invicon Potion of the Turtle Master.png: Inventory sprite for Potion of the Turtle Master in Minecraft as shown in-game linking to Potion of the Turtle Master with description: Potion of the Turtle Master Slowness IV (00:20) Resistance III (00:20) When Applied: -60% SpeedInvicon Potion of Oozing.png: Inventory sprite for Potion of Oozing in Minecraft as shown in-game linking to Potion of Oozing with description: Potion of Oozing Oozing (03:00)Invicon Potion of Infestation.png: Inventory sprite for Potion of Infestation in Minecraft as shown in-game linking to Potion of Infestation with description: Potion of Infestation Infested (03:00)Invicon Potion of Weaving.png: Inventory sprite for Potion of Weaving in Minecraft as shown in-game linking to Potion of Weaving with description: Potion of Weaving Weaving (03:00)Invicon Potion of Wind Charging.png: Inventory sprite for Potion of Wind Charging in Minecraft as shown in-game linking to Potion of Wind Charging with description: Potion of Wind Charging Wind Charged (03:00)Invicon Potion of Big.png: Inventory sprite for Potion of Big in Minecraft as shown in-game linking to Potion of Big with description: Potion of Big Big (03:00) When Applied: +1 Entity ScaleInvicon Potion of Small.png: Inventory sprite for Potion of Small in Minecraft as shown in-game linking to Potion of Small with description: Potion of Small Small (03:00) When Applied: -0.5 Entity ScaleInvicon Potion of Sticky.png: Inventory sprite for Potion of Sticky in Minecraft as shown in-game linking to Potion of Sticky with description: Potion of Sticky Sticky (01:30)


Invicon Splash Water Bottle.png: Inventory sprite for Splash Water Bottle in Minecraft as shown in-game linking to Splash Water Bottle with description: Splash Water Bottle No EffectsInvicon Awkward Splash Potion.png: Inventory sprite for Awkward Splash Potion in Minecraft as shown in-game linking to Awkward Splash Potion with description: Awkward Splash Potion No EffectsInvicon Thick Splash Potion.png: Inventory sprite for Thick Splash Potion in Minecraft as shown in-game linking to Thick Splash Potion with description: Thick Splash Potion No EffectsInvicon Mundane Splash Potion.png: Inventory sprite for Mundane Splash Potion in Minecraft as shown in-game linking to Mundane Splash Potion with description: Mundane Splash Potion No EffectsInvicon Splash Potion of Regeneration.png: Inventory sprite for Splash Potion of Regeneration in Minecraft as shown in-game linking to Splash Potion of Regeneration with description: Splash Potion of Regeneration Regeneration (00:45)Invicon Splash Potion of Swiftness.png: Inventory sprite for Splash Potion of Swiftness in Minecraft as shown in-game linking to Splash Potion of Swiftness with description: Splash Potion of Swiftness Speed (03:00) When Applied: +20% SpeedInvicon Splash Potion of Fire Resistance.png: Inventory sprite for Splash Potion of Fire Resistance in Minecraft as shown in-game linking to Splash Potion of Fire Resistance with description: Splash Potion of Fire Resistance Fire Resistance (03:00)Invicon Splash Potion of Poison.png: Inventory sprite for Splash Potion of Poison in Minecraft as shown in-game linking to Splash Potion of Poison with description: Splash Potion of Poison Poison (00:45)Invicon Splash Potion of Healing.png: Inventory sprite for Splash Potion of Healing in Minecraft as shown in-game linking to Splash Potion of Healing with description: Splash Potion of Healing Instant HealthInvicon Splash Potion of Night Vision.png: Inventory sprite for Splash Potion of Night Vision in Minecraft as shown in-game linking to Splash Potion of Night Vision with description: Splash Potion of Night Vision Night Vision (03:00)Invicon Splash Potion of Weakness.png: Inventory sprite for Splash Potion of Weakness in Minecraft as shown in-game linking to Splash Potion of Weakness with description: Splash Potion of Weakness Weakness (01:30) When Applied: -4 Attack DamageInvicon Splash Potion of Strength.png: Inventory sprite for Splash Potion of Strength in Minecraft as shown in-game linking to Splash Potion of Strength with description: Splash Potion of Strength Strength (03:00) When Applied: +3 Attack DamageInvicon Splash Potion of Slowness.png: Inventory sprite for Splash Potion of Slowness in Minecraft as shown in-game linking to Splash Potion of Slowness with description: Splash Potion of Slowness Slowness (01:30) When Applied: -15% SpeedInvicon Splash Potion of Leaping.png: Inventory sprite for Splash Potion of Leaping in Minecraft as shown in-game linking to Splash Potion of Leaping with description: Splash Potion of Leaping Jump Boost (03:00) When Applied: +1 Safe Fall DistanceInvicon Splash Potion of Harming.png: Inventory sprite for Splash Potion of Harming in Minecraft as shown in-game linking to Splash Potion of Harming with description: Splash Potion of Harming Instant DamageInvicon Splash Potion of Water Breathing.png: Inventory sprite for Splash Potion of Water Breathing in Minecraft as shown in-game linking to Splash Potion of Water Breathing with description: Splash Potion of Water Breathing Water Breathing (03:00)Invicon Splash Potion of Invisibility.png: Inventory sprite for Splash Potion of Invisibility in Minecraft as shown in-game linking to Splash Potion of Invisibility with description: Splash Potion of Invisibility Invisibility (03:00) When Applied: -100% Waypoint Transmit RangeInvicon Splash Potion of Slow Falling.png: Inventory sprite for Splash Potion of Slow Falling in Minecraft as shown in-game linking to Splash Potion of Slow Falling with description: Splash Potion of Slow Falling Slow Falling (01:30)Invicon Splash Potion of Luck.png: Inventory sprite for Splash Potion of Luck in Minecraft as shown in-game linking to Splash Potion of Luck with description: Splash Potion of Luck Luck (05:00) When Applied: +1 LuckInvicon Splash Potion of Decay.png: Inventory sprite for Splash Potion of Decay in Minecraft as shown in-game linking to Splash Potion of Decay with description: Splash Potion of Decay Wither II (00:40)Invicon Splash Potion of the Turtle Master.png: Inventory sprite for Splash Potion of the Turtle Master in Minecraft as shown in-game linking to Splash Potion of the Turtle Master with description: Splash Potion of the Turtle Master Slowness IV (00:20) Resistance III (00:20) When Applied: -60% SpeedInvicon Splash Potion of Oozing.png: Inventory sprite for Splash Potion of Oozing in Minecraft as shown in-game linking to Splash Potion of Oozing with description: Splash Potion of Oozing Oozing (03:00)Invicon Splash Potion of Infestation.png: Inventory sprite for Splash Potion of Infestation in Minecraft as shown in-game linking to Splash Potion of Infestation with description: Splash Potion of Infestation Infested (03:00)Invicon Splash Potion of Weaving.png: Inventory sprite for Splash Potion of Weaving in Minecraft as shown in-game linking to Splash Potion of Weaving with description: Splash Potion of Weaving Weaving (03:00)Invicon Splash Potion of Wind Charging.png: Inventory sprite for Splash Potion of Wind Charging in Minecraft as shown in-game linking to Splash Potion of Wind Charging with description: Splash Potion of Wind Charging Wind Charged (03:00)Invicon Splash Potion of Big.png: Inventory sprite for Splash Potion of Big in Minecraft as shown in-game linking to Splash Potion of Big with description: Splash Potion of Big Big (03:00) When Applied: +1 Entity ScaleInvicon Splash Potion of Small.png: Inventory sprite for Splash Potion of Small in Minecraft as shown in-game linking to Splash Potion of Small with description: Splash Potion of Small Small (03:00) When Applied: -0.5 Entity ScaleInvicon Splash Potion of Sticky.png: Inventory sprite for Splash Potion of Sticky in Minecraft as shown in-game linking to Splash Potion of Sticky with description: Splash Potion of Sticky Sticky (01:30)
Illustrative recipe.

recipe_material_reduction

This page describes an education-related feature.
 
This feature is available only in Minecraft Education or when enabling the "Minecraft Education features" cheat setting in Bedrock Edition.

Represents a Minecraft Education recipe in a material reducer.

  • [NBT Compound / JSON Object]: The root tag.
    • [String] format_version: Used to set the version your recipe should work on e.g. 1.20.10.
    • [NBT Compound / JSON Object] minecraft:recipe_material_reduction: Used to set the recipe type of the material reducer.
      • [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
        • [String] identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
      • [String] tags: Defines where the recipe can be used. material_reducer does not support custom tags.
      • [String] input: Item used for this recipe.
      • [NBT List / JSON Array] output: Defines the result of the recipe.
        • [NBT Compound / JSON Object]:
          • [Int] count: Optional. Number of items as result example 3.
          • [String] item: Used to define an item or block that you will receive when crafting the recipe.

Usage example json:

{
   "format_version" : "1.14",
   "minecraft:recipe_material_reduction" : {
      "description" : {
         "identifier" : "minecraft:cobblestone_wall:4"
      },
      "input" : "minecraft:andesite_wall",
      "output" : [
         {
            "count" : 33,
            "item" : "minecraft:element_14"
         },
         {
            "count" : 64,
            "item" : "minecraft:element_8"
         },
         {
            "count" : 3,
            "item" : "minecraft:element_8"
         }
      ],
      "tags" : "material_reducer"
   }
}

History

Java Edition
1.1217w13aIntroduced the recipe system for most crafting recipes.
17w16aAdded 'group' key to the recipe json format.
1.1317w47aRemoved 'data' key from the recipe json format.
17w48aCustom recipes can now be added to data packs.
Added these 13 recipe types.
Converted various special crafting recipes to the recipe system using the special recipe types.
17w49aAdded 'tag' key to the recipe json format.
18w06aSmelting recipes now use the recipe system.
Added smelting to type.
Added a string result.
Added experience.
Added cookingtime.
1.1418w43aAdded a recipe type crafting_special_suspiciousstew.
18w48aRemoved these 2 recipe types.
18w50aAdded recipe types blasting and smoking.
19w02aAdded a recipe type campfire_cooking.
19w04aAdded a recipe type stonecutting.
1.14.3pre3Re-added the recipe type crafting_special_repairitem.
1.16pre1Added the recipe type smithing.
1.18.1?Result count is mandatory in this version.
1.19.322w42aRecipe book categories are now defined for each recipe individually in the default datapack.
1.19.4
Experiment
Update 1.20
23w04aRemoved the recipe serializer smithing and replaced it with smithing_transform, and smithing_trim.
23w07aAdded a new recipe serializer crafting_decorated_pot for the new decorated pot recipe.
Added show_notification field to recipes.
1.20Pre-release 2"item": "minecraft:air" can now be used to denote an ingredient that matches an empty slot.
Pre-release 6"item": "minecraft:air" can no longer be used in data pack recipes.
Ingredients in array form are now also allowed in smithing_trim, and smithing_transform recipes on fields template, base and addition.
1.20.524w10aCan now specify item component.
1.21.224w33aThe crafting_special_suspiciousstew recipe type has been removed.
The format used for recipe ingredients has been simplified and aligned with other fields that accept item lists (like item predicates).
24w38aThe crafting_special_shulkerboxcoloring recipe type has been removed.
Instead it uses the newly added crafting_transmute, which can copy the input item stack, changing the item type but preserving all stack components.
1.21.525w02aThe crafting_transmute result field now supports specifying a count and a components patch to apply to the result.
25w04asmithing_transform recipe type: the base ingredient field is no longer optional.
smithing_trim recipe type: the base, template, and addition ingredient fields are no longer optional, added new pattern field.
Bedrock Edition
1.12.0beta 1.12.0.2Introduced the recipe system for most crafting recipes.
1.19.40Preview 1.19.40.22Added tag key to the recipe JSON format.
1.20.10Preview 1.20.10.20Added unlock field to the recipe JSON format.

Issues

Issues relating to "Recipe" are maintained on the bug tracker. Issues should be reported and viewed there.

External links

Navigation