Minecraft:Recipe (Bedrock Edition)

Recipes provide a structured way for players to perform item and block transformations in-game. Every Minecraft:crafting, smelting, Minecraft:brewing, blasting, campfire cooking, smoking, stonecutting and smithing recipe uses this system. Recipes are data driven and can be configured by Minecraft:add-ons.

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

1. REDIRECT Template:Command

Template:Redr command.

Once a recipe has been discovered, it is added to the player's recipe book.

Usage

{{#vardefine:params|0 }}Template:Hatnote

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 Template:Gmr game rule is enabled. The game rule Template:Gmr can be used to disable 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.

The Minecraft:anvil, cartography table, Minecraft:loom, and Minecraft:grindstone don't use the recipe system; they use different, hardcoded systems for their mechanics.

JSON format

Vanilla recipes are stored as separate Minecraft: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 Minecraft: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 Minecraft:inventory, and the Minecraft: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.

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_shaped: Used to define the recipe type.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. This can be a crafting_table or a custom crafting table tag.
    • Template:Nbt/sprite group: Optional used only for information as it has no known use.
    • Template:Nbt/sprite 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.
    • Template:Nbt/sprite key: All keys used for this crafting recipe with shape.
      • Template:Nbt/sprite A key:
        • Template:Nbt/sprite item: Used to define an item or block with the id example minecraft:emerald_block.
        • Template:Nbt/sprite data: Optional. Integer or Minecraft:Molang expression for dynamic variants.
        • Template:Nbt/sprite tag: Used to define an item tag example minecraft:planks also accepts custom tags.
    • Template:Nbt/sprite unlock: Defines the items that unlock the recipe when caught.
      • Template:Nbt/sprite:
      • Template:Nbt/sprite item: Used to define an item or block that unlocks the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
      • Template:Nbt/sprite context: Used to unlock recipes with context currently only known values are

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr.

• • • Template:Nbt/sprite result: Defines the recipe result.
      • Template:Nbt/sprite item: Used to define an item or block that you will receive when crafting the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite count: Optional. Number of items manufactured example 3.
    • Template:Nbt/sprite priority: Optional, used to give priority if the same recipe exists in duplicate.

Usage example json: <syntaxhighlight lang="c++"> {

 "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
   ]
 }

} </syntaxhighlight>

recipe_shapeless

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

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

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_shapeless: Used to set the type recipe shapeless.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. This can be crafting_table for the crafting table, stonecutter for the Minecraft:stonecutter, or a custom crafting table tag.
    • Template:Nbt/sprite group: Optional used only for information as it has no known use.
    • Template:Nbt/sprite ingredients: All items used for this shapeless crafting recipe.
      • Template:Nbt/sprite:
        • Template:Nbt/sprite item: Used to define an item or block with the id example minecraft:emerald_block.
        • Template:Nbt/sprite data: Optional. Integer or Minecraft:Molang expression for dynamic variants.
        • Template:Nbt/sprite tag: Used to define an item tag example minecraft:planks also accepts custom tags.
    • Template:Nbt/sprite unlock: Defines the items that unlock the recipe when purchased.
      • Template:Nbt/sprite:
      • Template:Nbt/sprite item: Used to define an item or block that unlocks the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
      • Template:Nbt/sprite context: Used to unlock recipes with context currently only known values are

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr.

• • • Template:Nbt/sprite result: Defines the result of the recipe.
      • Template:Nbt/sprite item: Used to define an item or block that you will receive when crafting the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite count: Optional. Number of items produced example 3.
    • Template:Nbt/sprite priority: Optional, used to give priority if the same recipe exists in duplicate.

Crafting table example json: <syntaxhighlight lang="c++"> {

 "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"
   }
 }

} </syntaxhighlight>

Stonecutter Example Json: <syntaxhighlight lang="c++"> {

   "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
   }

} </syntaxhighlight>

recipe_furnace

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

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

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_furnace: Used to set the type of smelting recipe.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite 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.
    • Template:Nbt/sprite group: Optional used only for information as it has no known use.
    • Template:Nbt/sprite input: All items used for this smelting recipe.
      • Template:Nbt/sprite item: Used to define an item or block with the id example minecraft:diamond_chestplate.
      • Template:Nbt/sprite data: Optional. Integer or Minecraft:Molang expression for dynamic variants.
      • Template:Nbt/sprite tag: Used to define an item tag example minecraft:planks also accepts custom tags.
    • Template:Nbt/sprite unlock: Defines the items that unlock the recipe, but without use as there is no recipe book for smelting blocks.
      • Template:Nbt/sprite:
      • Template:Nbt/sprite item: Used to define an item or block that unlocks the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite tag: Used to set an item tag that unlocks the recipe, also accepts custom tags.
      • Template:Nbt/sprite context: Used to unlock recipes with context currently only known values are

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr.

• • • Template:Nbt/sprite output: Defines the result of the recipe.
      • Template:Nbt/sprite item: Used to define an item or block that you will receive when crafting the recipe.
      • Template:Nbt/sprite data: Optional. Integer or Molang expression for dynamic variants.
      • Template:Nbt/sprite count: Optional. Number of items manufactured example 3.
    • Template:Nbt/sprite priority: Optional, used to give priority if the same recipe exists in duplicate.

Usage example json: <syntaxhighlight lang="c++"> {

 "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
 }

} </syntaxhighlight>

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.

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_smithing_trim: Used to set the type of smithing recipe.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. It can be smithing_table it does not support custom tags.
    • Template:Nbt/sprite template: Used to define a template.
      • Template:Nbt/sprite tag: Used to set an item tag using minecraft:trim_templates but has no effect on custom items with that tag.
    • Template:Nbt/sprite base: Defines the base items that will be used.
      • Template:Nbt/sprite 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.
    • Template:Nbt/sprite addition: Used to define a material.
      • Template:Nbt/sprite 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: <syntaxhighlight lang="c++"> {

 "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"
   }
 }

} </syntaxhighlight>

recipe_smithing_transform

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

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_smithing_transform: Used to set the type of smithing recipe.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. It can be smithing_table it does not support custom tags.
    • Template:Nbt/sprite template: Used to define a netherite upgrade accepting custom items if they have the item tag minecraft:transform_templates.
    • Template:Nbt/sprite base: Defines the base items that will be used, the custom item needs to have the item tag minecraft:transformable_items.
    • Template:Nbt/sprite 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.
    • Template:Nbt/sprite result: Used to set an item as a recipe result.

Usage example json: <syntaxhighlight lang="c++"> {

 "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"
 }

} </syntaxhighlight>

recipe_brewing_mix

Represents a Minecraft:brewing recipe on a brewing stand.

Vanilla potions use this system minecraft:potion_type:<potion_effect> can be added

1. REDIRECT Template:Code

Template:Redr or

1. REDIRECT Template:Code

Template:Redr for other types like

1. REDIRECT Template:Code

Template:Redr also accepted is

1. REDIRECT Template:Code

Template:Redr,

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr.

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_brewing_mix: Used to set the fermentation recipe type.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. brewing_stand does not support custom tags.
    • Template:Nbt/sprite input: Item used for this brew recipe, supports custom items and vanilla items in the format mentioned above.
    • Template:Nbt/sprite reagent: Used to define an item or block that is used as an ingredient also supports custom items.
    • Template:Nbt/sprite output: Recipe result item, supports custom items and vanilla items in the format mentioned above.

Usage example json: <syntaxhighlight lang="c++"> {

 "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"
 }

} </syntaxhighlight> Template:Brewing

recipe_brewing_container

Represents a Minecraft: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

1. REDIRECT Template:Code

Template:Redr or

1. REDIRECT Template:Code

Template:Redr for other types like

1. REDIRECT Template:Code

Template:Redr also accepted is

1. REDIRECT Template:Code

Template:Redr,

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr.

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_brewing_container: Used to set the fermentation recipe type.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/spriteTemplate:Nbt/sprite tags: Defines where the recipe can be used. brewing_stand does not support custom tags.
    • Template:Nbt/sprite input: Item used for this brewing recipe, unlike the mix only supports vanilla potions items in the format mentioned above.
    • Template:Nbt/sprite reagent: Used to define an item or block that is used as an ingredient also supports custom items.
    • Template:Nbt/sprite output: Recipe result item, supports custom items and vanilla items in the format mentioned above.

Usage example json: <syntaxhighlight lang="c++"> {

 "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"
 }

} </syntaxhighlight> Template:Brewing

recipe_material_reduction

Template:Message boxTemplate:Article other Represents a Minecraft:Minecraft Education recipe in a material reducer.

• Template:Nbt/sprite: The root tag.
  • Template:Nbt/sprite format_version: Used to set the version your recipe should work on e.g.

1. REDIRECT Template:Code

Template:Redr.

• • Template:Nbt/sprite minecraft:recipe_material_reduction: Used to set the recipe type of the material reducer.
    • Template:Nbt/sprite description: Required in any type of recipe, it contains the identifier of a recipe.
      • Template:Nbt/sprite identifier: Required to detect the recipe in-game. The namespace can be omitted, but it is highly recommended to avoid conflicts.
    • Template:Nbt/sprite tags: Defines where the recipe can be used. material_reducer does not support custom tags.
    • Template:Nbt/sprite input: Item used for this recipe.
    • Template:Nbt/sprite output: Defines the result of the recipe.
      • Template:Nbt/sprite:
        • Template:Nbt/sprite count: Optional. Number of items as result example 3.
        • Template:Nbt/sprite item: Used to define an item or block that you will receive when crafting the recipe.

Usage example json: <syntaxhighlight lang="c++"> {

  "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"
  }

} </syntaxhighlight>

External links

• Recipe Generator on misode.github.io

Navigation

Editions	Merged Template:Edition Template:Edition Ports to consoles Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Discontinued Template:Edition Template:Edition Template:Edition
Development	Version history Template:LegacyBlockLink Template:EntityLink Template:FileLink Template:FileLink Template:EnvLink Template:ItemLink Template:BlockLink Template:InvLink Template:EntityLink Template:FileLink Template:EntityLink
Technical	Template:EffectLink Template:FileLink Template:FileLink Template:File com.mojang Template:FileLink Template:File Installation files Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:BlockLink Template:File Identifier Template:FileLink Template:ItemLink Template:EnvLink Template:EnvLink Anomalous Template:ItemLink Template:EnvLink § Formatting codes Simulation distance Template:BlockLink Template:FileLink Template:FileLink Template:EnvLink Template:FileLink Template:EntityLink Template:BlockLink Development resources Template:Nbt NBT format Template:Nbt Level format Template:EnvLink Protocol Template:EnvLink RakNet Creator Template:File Official documentation Template:FileLink Template:EntityLink Template:File File extensions Template:FileLink Add-ons Template:ItemLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:FileLink Template:EnvLink Template:EnvLink Template:BiomeLink Template:EnvLink Family Spawn event Template:ItemLink Template:BlockLink Template:EnvLink Template:BiomeLink Template:EnvLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink manifest.json Template:EnvLink Template:Nbt Molang Template:BlockLink
Multiplayer	Template:FileLink Featured servers Event servers Server list Template:FileLink Template:FileLink Template:FileLink Template:FileLink
Exclusive features	Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:ItemLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:EnvLink Template:PersonaLink Template:EnvLink Loading tips Template:FileLink Ray Tracing Template:BiomeLink Template:EnvLink Blocks Template:BlockLink Template:BlockLink Mobs Template:EntityLink Template:EntityLink Effects Template:EffectLink Unused Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:EntityLink Template:EntityLink Template:BiomeLink Template:EnvLink
Removed	Template:BlockLink Template:EnvLink Template:EnvLink Template:FileLink Pocket Edition protocol Legacy