Recipe (Bedrock Edition)
Minecraft Wiki article. Categories: Bedrock_Edition, Bedrock_Edition_specific_information, Minecraft_Education_specific_information, Minecraft_Education
This article is reproduced from Recipe (Bedrock Edition) on the Minecraft Wiki. Mirrored from revision 3703029. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.
Recipes provide a structured way for players to perform item and block transformations in-game. Every crafting, smelting, brewing, blasting, campfire cooking, smoking, stonecutting and smithing recipe uses this system. Recipes are data driven and can be configured by 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 /recipe command.
Once a recipe has been discovered, it is added to the player's recipe book.
Usage
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. The game rule recipesUnlock 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 anvil, cartography table, loom, and grindstone don't use the recipe system; they use different, hardcoded systems for their mechanics.
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_tableor 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 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
AlwaysUnlockedandPlayerInWater.
- [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.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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_tablefor the crafting table,stonecutterfor 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 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
AlwaysUnlockedandPlayerInWater.
- [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.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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 | 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
furnacefor the standard furnace,blast_furnacefor the blast furnace,smokerfor the smoker,campfirefor the campfire andsoul_campfirefor 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.
- [NBT List / JSON Array] unlock: Defines the items that unlock the recipe.
- [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
AlwaysUnlockedandPlayerInWater.
- [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.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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_tableit 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_templatesbut has no effect on custom items with that tag.
- [String] tag: Used to set an item tag using
- [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_armorsUsing this tag on a custom item allows the custom armor to be trimmed.
- [String] tag: Used to set an item tag for the recipe being used
- [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_materialsusing this tag on a custom item has no effect.
- [String] tag: Used to set an item tag for the recipe being used
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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_tableit 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_materialstag can be placed. - [String] result: Used to set an item as a recipe result.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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_standdoes 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.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
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_standdoes 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.
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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 |
Illustrative recipe. |
recipe_material_reduction
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_reducerdoes 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.
- [Int] count: Optional. Number of items as result example
- [NBT Compound / JSON Object]:
- [NBT Compound / JSON Object] description: Required in any type of recipe, it contains the identifier of a recipe.
- [String] format_version: Used to set the version your recipe should work on e.g.
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
| Bedrock Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.12.0 | beta 1.12.0.2 | Introduced the recipe system for most crafting recipes. | |||||
| 1.19.40 | Preview 1.19.40.22 | Added tag key to the recipe JSON format. | |||||
| 1.20.10 | Preview 1.20.10.20 | Added unlock field to the recipe JSON format. | |||||
| 26.40 | Preview 26.40.30 | minecraft:recipe_smithing_transform now accepts items tagged with minecraft:transform_materials in its addition field instead of just netherite ingot. | |||||
Issues
Issues relating to "Recipe (Bedrock Edition)" are maintained on the bug tracker. Issues should be reported and viewed there.
External links
Navigation
Sources
- Recipe (Bedrock Edition) — Minecraft Wiki, CC BY-NC-SA 3.0, revision 3703029.