Recipe

Recipes are a way to gradually guide new players into Minecraft by assisting them with the usage of crafting, smelting, and other block and item transformations in-game.

Recipes are data driven and be configured by data packs in Java Edition or add-ons in Bedrock Edition. Every crafting, smelting, blasting, campfire cooking, smoking, stonecutting and smithing recipe uses this system. In Bedrock Edition, cartography tables and brewing recipes also use this system. Cartography table‌^{[Java Edition only]} and loom recipes cannot currently be controlled.

Obtaining[]

Recipes can be obtained in various ways. Using the recipe automatically makes the player discover it. Recipes can also be granted using the /recipe command or as a reward for completing an advancement. Vanilla survival has multiple advancements that grant recipes, which trigger when for example the player obtains an item required in the recipe.‌^{[Java Edition only]}

Once a recipe has been discovered, it is added to the player's recipe book.‌^{[Java Edition only]} Discovered recipes are stored in the player's  recipeBook NBT.

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 /gamerule doLimitedCrafting is set to true.

Recipes appear only if the player is using the recipe book in a block associated to the recipe's type; for example, furnace recipes only show up when the player use the recipe book in the furnace GUI. When the player is using the recipe book in the inventory, crafting recipes appear that can fit into the player's 2×2 inventory crafting grid.

JSON format[]

Custom recipes in the data/(namespace)/recipes folder of a data pack store the recipe data for that world as separate JSON files.

A recipe with ID foo:path/to/file would have its JSON file located at data/foo/recipes/path/to/file.json within a data pack.

Recipe JSON files have different structures dependent on their type, but they all have a  type tag in its root tag.

List of recipe types[]

blasting[]

Represents a recipe in a blast furnace.

The default cooking time is 100 ticks, or 5 seconds.

campfire_cooking[]

Represents a recipe in a campfire.

The default cooking time is 100 ticks, or 5 seconds, even though all vanilla campfire cooking recipes have a cook time of 600 ticks, or 30 seconds. Campfire recipes do not trigger the recipe_unlocked criteria.

crafting_shaped[]

Represents a shaped crafting recipe in a crafting table.

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

Custom NBT data tags are not allowed for the recipe's output item.

crafting_shapeless[]

Represents a shapeless crafting recipe in a crafting table.

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

Custom NBT data tags are not allowed for the recipe's output item.

crafting_special_*[]

Represents a crafting recipe in a crafting table that is handled with builtin logic instead of being data-driven.

When the "vanilla" data pack is disabled, they can be used to reenable desired builtin crafting recipes.

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

• armordye

The armor dyeing recipe.

Regular recipes cannot handle multiple dyes.

• bannerduplicate

The banner copying recipe.

Regular recipes cannot copy NBT data associated to the banner item.

• 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.

• 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.

• firework_star
• firework_star_fade

The firework star crafting and its fade addition recipes.

Regular recipes cannot handle inputs flexibly or add NBT data to the firework star.

• mapcloning

The map copying recipe.

Regular recipes cannot copy NBT data associated to the map item.

• mapextending

The map zooming recipe.

Regular recipes cannot update NBT data associated to the map item.

• repairitem

The item repair recipe.

Regular recipes cannot update damage data associated to the tool item.

• shielddecoration

The shield pattern application recipe.

Regular recipes cannot add NBT data from a banner item to a shield item.

• shulkerboxcoloring

The shulker box dyeing recipe.

Regular recipes cannot copy NBT data from a shulker box item to a dyed shulker box item.

• tippedarrow

The tipped arrow recipe.

Regular recipes cannot copy NBT data from a lingering potion item to a tipped arrow item.

• suspiciousstew

The suspicious stew recipe.

Regular recipes cannot determine the status effect from the type of flower given.

smelting[]

Represents a recipe in a furnace.

The default cooking time is 200 ticks, or 10 seconds.

smithing[]

Represents a recipe in a smithing table.

The resulting item copies the NBT tags of the base item.

smoking[]

Represents a recipe in a smoker.

The default cooking time is 100 ticks, or 5 seconds.

stonecutting[]

Represents a recipe in a stonecutter.

Unlike the  count field in shaped and shapeless crafting recipes, this  count field here is required.

History[]

Issues[]

Issues relating to "Recipe" are maintained on the bug tracker. Report issues there.

References[]