Minecraft:Recipe (Bedrock Edition): Difference between revisions

Latest revision as of 20:53, 9 April 2026

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

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.

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/sprite Template: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

REDIRECT Template:Code

Template:Redr and

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>

Template:Crafting

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.

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/sprite Template: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

REDIRECT Template:Code

Template:Redr and

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>

Template:Crafting

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>

Template:Stonecutting

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.

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/sprite Template: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

REDIRECT Template:Code

Template:Redr and

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>

Template:Smelting

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.

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/sprite Template: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>

Template:Smithing

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.

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/sprite Template: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>

Template:Smithing

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

REDIRECT Template:Code

Template:Redr or

REDIRECT Template:Code

Template:Redr for other types like

REDIRECT Template:Code

Template:Redr also accepted is

REDIRECT Template:Code

Template:Redr,

REDIRECT Template:Code

Template:Redr and

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.

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/sprite Template: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

REDIRECT Template:Code

Template:Redr or

REDIRECT Template:Code

Template:Redr for other types like

REDIRECT Template:Code

Template:Redr also accepted is

REDIRECT Template:Code

Template:Redr,

REDIRECT Template:Code

Template:Redr and

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.

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/sprite Template: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 box Template: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.

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>

History

Template:HistoryTable

Issues

Script error: No such module "Issue list".

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

Technical

Creator

Add-ons

Multiplayer

Exclusive features

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