From Minecraft Wiki
Jump to: navigation, search
Information icon.svg
This feature is exclusive to Java Edition.

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.


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.


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]

Custom recipes in the data/(namespace)/recipes folder of a data pack store the recipe data for that world as separate JSON files.‌[upcoming: JE 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.
        •  data: The metadata of the item.[until JE 1.13]
        •  item: An item ID.
        •  tag: A data pack item tag.‌[upcoming: JE 1.13]
    •  ingredients: A list of ingredients used for shapeless crafting.
        •  data: The metadata of the item.[until JE 1.13]
        •  item: An item ID.
        •  tag: A data pack item tag.‌[upcoming: JE 1.13]
    •  result: The output item of the recipe.
      •  count: The amount of the item.
      •  data: The metadata of the item.[until JE 1.13]
      •  item: An item ID.




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