Recipe (Java Edition)

Recipes provide a structured way for players to perform item and block transformations in-game. Every crafting, smelting, blasting, campfire cooking, smoking, stonecutting and smithing recipe uses this system. Recipes are data driven and can be configured by data packs.

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. Advancements can be configured to award recipes when triggered; in vanilla, there are many 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 is added to the player's recipe book. Discovered recipes are stored in the player's [NBT Compound / JSON Object] recipeBook NBT.

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.

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 recipe book can also be used in the furnace, showing exclusively smelting recipes.

The anvil, cartography table, loom, brewing stand, and grindstone don't use the recipe system; they use different, hardcoded systems for their mechanics.

Vanilla recipes are stored as separate JSON files in the data/minecraft/recipe folder in the .minecraft/versions/<version>/<version>.jar file. This folder can be found by changing the extension of the .jar file to .zip and navigating within it.

Custom recipe files are stored in the data/<namespace>/recipe folder of a data pack. A recipe with ID foo:path/to/file would have its JSON file located at data/foo/recipe/path/to/file.json within a data pack. Data packs that load later with a recipe file in same resource location replace the existing recipe.

Recipe JSON files have different structures dependent on their type, but they all have a [String] type tag in its root tag. These types are listed below.

Represents a recipe in a blast furnace.

Usage example json:

{
  "type": "minecraft:blasting",
  "category": "misc",
  "cookingtime": 100,
  "experience": 0.1,
  "group": "coal",
  "ingredient": "minecraft:coal_ore",
  "result": {
    "id": "minecraft:coal"
  }
}

Name	Ingredients	Smelting recipe	Description
Coal	Coal Ore + Any fuel	0.1	Illustrative recipe

Represents a recipe in a campfire.

Usage example json:

{
  "type": "minecraft:campfire_cooking",
  "category": "food",
  "cookingtime": 600,
  "experience": 0.35,
  "ingredient": "minecraft:potato",
  "result": {
    "id": "minecraft:baked_potato"
  }
}

Even though all vanilla campfire cooking recipes have a cook time of 600 ticks, the default is 100 ticks.

Campfire recipes do not trigger the recipe_unlocked criteria.

Represents a shaped crafting recipe in a crafting table, the survival inventory and the crafter.

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

Usage example json:

{
  "type": "minecraft:crafting_shaped",
  "category": "misc",
  "key": {
    "A": "minecraft:milk_bucket",
    "B": "minecraft:sugar",
    "C": "minecraft:wheat",
    "E": "#minecraft:eggs"
  },
  "pattern": [
    "AAA",
    "BEB",
    "CCC"
  ],
  "result": {
    "count": 1,
    "id": "minecraft:cake"
  }
}

Ingredients	Crafting recipe	Description
Milk Bucket + Sugar + Any Egg + Wheat		Illustrative recipe.

Represents a shapeless crafting recipe in a crafting table, the survival inventory and the crafter.

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

Usage example json:

{
  "type": "minecraft:crafting_shapeless",
  "category": "equipment",
  "ingredients": [
    "minecraft:iron_ingot",
    "minecraft:flint"
  ],
  "result": {
    "count": 1,
    "id": "minecraft:flint_and_steel"
  }
}

Ingredients	Crafting recipe	Description
Iron Ingot + Flint		Illustrative recipe.

If the recipe contains the same 9 ingredients, it turns into minecraft:crafting_shaped recipe.

Represents a crafting recipe in a crafting table, a crafter and the survival inventory.

When matched, output copies the input item stack, changing the item type but preserving all stack components.

Usage example json:

{
  "type": "minecraft:crafting_transmute",
  "category": "misc",
  "group": "shulker_box_dye",
  "input": "#minecraft:shulker_boxes",
  "material": "minecraft:blue_dye",
  "result": {
    "id": "minecraft:blue_shulker_box"
  }
}

Ingredients	Crafting recipe	Description
Any Shulker Box + Blue Dye		Illustrative recipe.

Represents a crafting recipe in a crafting table, a crafter and the survival inventory that is handled with built-in logic instead of being data-driven.

When the vanilla data pack is disabled, they can be used to re-enable desired built-in crafting recipes.

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

• crafting_special_armordye

The armor dyeing recipe.

Regular recipes cannot handle multiple dyes.

• crafting_special_bannerduplicate

The banner copying recipe.

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

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

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

• crafting_special_firework_star
• crafting_special_firework_star_fade

The firework star crafting recipes and their fade additions.

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

• crafting_special_mapcloning

The map copying recipe.

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

• crafting_special_mapextending

The map zooming recipe.

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

• crafting_special_repairitem

The item repair recipe.

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

• crafting_special_shielddecoration

The shield pattern application recipe.

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

• crafting_special_tippedarrow

The tipped arrow recipe.

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

The decorated pot recipe in a crafting table and a crafter.

Represents a recipe in a furnace.

Usage example json:

{
  "type": "minecraft:smelting",
  "category": "blocks",
  "cookingtime": 200,
  "experience": 0.1,
  "ingredient": "minecraft:stone_bricks",
  "result": {
    "id": "minecraft:cracked_stone_bricks"
  }
}

Name	Ingredients	Smelting recipe	Description
Cracked Stone Bricks	Stone Bricks + Any fuel	0.1	Illustrative recipe

Represents a upgrading recipe in a smithing table.

The resulting item copies the components of the base item. Usage example json:

{
  "type": "minecraft:smithing_transform",
  "addition": "#minecraft:netherite_tool_materials",
  "base": "minecraft:diamond_axe",
  "result": {
    "id": "minecraft:netherite_axe"
  },
  "template": "minecraft:netherite_upgrade_smithing_template"
}

Ingredients	Smithing recipe	Description
Netherite Upgrade + Diamond Axe + Netherite Ingot		Illustrative recipe.

Represents a trimming recipe in a smithing table.

Adds NBT Tags for the trim to the base item. Usage example json:

{
  "type": "minecraft:smithing_trim",
  "addition": "#minecraft:trim_materials",
  "base": "#minecraft:trimmable_armor",
  "pattern": "minecraft:silence",
  "template": "minecraft:silence_armor_trim_smithing_template"
}

Ingredients	Smithing recipe	Description
Silence Armor Trim + Any Armor Piece + Any Material		Illustrative recipe.

Represents a recipe in a smoker.

Usage example json:

{
  "type": "minecraft:smoking",
  "category": "food",
  "cookingtime": 100,
  "experience": 0.35,
  "ingredient": "minecraft:beef",
  "result": {
    "id": "minecraft:cooked_beef"
  }
}

Name	Ingredients	Smelting recipe	Description
Steak	Raw Beef + Any fuel	0.35	Illustrative recipe.

Represents a recipe in a stonecutter.

Usage example json:

{
  "type": "minecraft:stonecutting",
  "ingredient": "minecraft:cobbled_deepslate",
  "result": {
    "count": 1,
    "id": "minecraft:cobbled_deepslate_stairs"
  }
}

Ingredients	Cutting recipe	Description
Cobbled Deepslate		Illustrative recipe.

Issues relating to "Recipe (Java Edition)" are maintained on the bug tracker. Issues should be reported and viewed there.

• Recipe Generator on misode.github.io