Recipe

From Minecraft Wiki
(Redirected from Recipes)
Jump to: navigation, search
Information icon.svg
This feature is exclusive to Java Edition and Bedrock Edition.
Dinnerbone-twitter.png

The way it works in vanilla survival* is that you either "discover" a recipe by crafting it manually, or some other condition where we think "okay now you have sticks, we'll teach you how to make a pickaxe". After a recipe is "discovered" it's available in this recipe book, an optional thing you can click to in a crafting screen. From there you can see all the recipes you've discovered and how to craft them, so you don't need to google for the shape and ingredients.

*I say vanilla survival because this is customizable. For example, a custom map could require you to only craft things they've given you, and nothing else. In vanilla survival this is purely a tool to help remember recipes you don't use much, or teach you about new ones that you may not have known about.

Dinnerbone on using recipes[1]

Recipes are a way to gradually guide new players into Minecraft.[citation needed]

Recipes are data driven and be configured by data packs[Java Edition only] or add-ons[Bedrock Edition only]. All crafting, furnace, blasting, campfire cooking, smoking, cartographing[Bedrock Edition only][citation needed] and stonecutting recipes use this system. Brewing stand, cartography table[Java Edition only] and loom recipes cannot currently be controlled.

Obtaining[edit]

Recipes can be obtained in various ways. Using the recipe will automatically make 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 will be added to the player's recipe book. Discovered recipes are stored in the player's  recipeBook NBT.

Usage[edit]

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 will only show up 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 that can fit into the player's 2×2 inventory crafting grid will show up.

JSON format[edit]

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[edit]

minecraft:blasting[edit]

Represents a recipe in a blast furnace.

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

minecraft:campfire_cooking[edit]

Represents a recipe in a campfire.

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

minecraft:crafting_shaped[edit]

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.

  • The root tag.
    • Tags common to all recipes see Template:Nbt inherit/recipe/serializers/common/template
    •  pattern: A list of single-character keys used to describe a 2×2 or 3×3 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.
    •  key: All keys used for this shaped crafting recipe.
      •  (A key): The ingredient corresponding to this key.
      •  (A key): The list of ingredients corresponding to this key.
    •  result: The output item of the recipe.
      •  count: Optional. The amount of the item. Will fallback to 1 if the field is absent.
      •  item: An item ID.

minecraft:crafting_shapeless[edit]

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.

  • The root tag.
    • Tags common to all recipes see Template:Nbt inherit/recipe/serializers/common/template
    •  ingredients: A list of entries for this shapeless crafting recipe. Must have 1 to 9 entries.
      • : An entry made of a single ingredient.
      • : An entry made of a list of acceptable ingredients.
    •  result: The output item of the recipe.
      •  count: Optional. The amount of the item. Will fallback to 1 if the field is absent.
      •  item: An item ID.

minecraft:crafting_special_*[edit]

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.

  • The root tag.
    •  type: A namespaced ID indicating the type of serializer of the recipe.

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.

minecraft:smelting[edit]

Represents a recipe in a furnace.

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

minecraft:smoking[edit]

Represents a recipe in a smoker.

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

minecraft:stonecutting[edit]

Represents a recipe in a stonecutter.

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

History[edit]

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.3pre3Readded the recipe type crafting_special_repairitem.
Bedrock Edition
1.12.0beta 1.12.0.2Introduced the recipe system for most crafting recipes.

Issues[edit]

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

References[edit]