Recipe

From Minecraft Wiki
Jump to: navigation, search
Java Edition.png
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.

Obtaining[edit | edit source]

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.

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

Recipes do not need to be discovered for the player to be able to use them, unless /gamerule doLimitedCrafting is set to false.

JSON format[edit | edit source]

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

All recipe JSON files are structured according to the following format:


  • The root tag.

    •  type: The type of crafting recipe. Can be one of these 15 types.

    •  group: An identifier. Used to group multiple recipes together in the recipe book.

    •  pattern: A list of keys used to describe the 3x3 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 shaped crafting.

      •  (A key): The single character representing this item.

    •  ingredients: A list of ingredients used for shapeless crafting.

    •  result: The output item of the recipe.

      •  count: The amount of the item.

      •  data: The metadata of the item.[until 1.13]

      •  item: An item ID.

History[edit | edit source]

Official release
1.12 17w13a Introduced the recipe system for most crafting recipes.
17w16a Added 'group' key to the recipe json format.
Upcoming
1.13 17w47a Removed 'data' key from the recipe json format.
17w48a Custom recipes can now be added to data packs.
Added these 13 special crafting types.
Converted various special crafting recipes to the recipe system using the special crafting types.
17w49a Added 'tag' key to the recipe json format.

Issues[edit | edit source]

Issues relating to “Recipe” are maintained on the issue tracker. Report issues there.

References[edit | edit source]