Recipe (Java Edition)

This article needs to be updated.

 

Please update this article to reflect recent updates or newly available information. The talk page may contain suggestions.
Reason: Many changes in Java Edition 26.1 Snapshot 5 are not documented.

It has been suggested that this page be split into Recipe (Java Edition) and Recipe definition.

 ^[discuss]

If this split affects many pages, or may potentially be controversial, do not split until a consensus has been reached.

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 identifier 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

This section describes content that is currently in development for Java Edition.

 

This content has appeared in development versions for Java Edition 26.3, but the full update adding it has not been released yet.

Represents a recipe in a brewing stand.

Usage example json:

{
  "type": "minecraft:brewing",
  "input": {
    "item": "minecraft:potion",
    "potion_contents": {
      "potion": "minecraft:water"
    }
  },
  "output": {
    "components": {
      "minecraft:potion_contents": {
        "potion": "minecraft:awkward"
      }
    },
    "id": "minecraft:potion"
  },
  "reagent": {
    "item": "minecraft:nether_wart"
  }
}

Ingredients	Brewing recipe
Nether Wart + Water Bottle

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 an armor dyeing recipe in a crafting table, the survival inventory and the crafter.

Usage example json:

{
  "type": "minecraft:crafting_dye",
  "category": "misc",
  "dye": "#minecraft:dyes",
  "group": "dyed_armor",
  "result": {
    "id": "minecraft:leather_horse_armor"
  },
  "target": "minecraft:leather_horse_armor"
}

Represents a crafing recipe in a Crafting Table and Crafter. With one item in the center and eight other items around it. The result keeps the potion_contents from the source item.

Used for the Tipped Arrow crafting recipe.

[NBT Compound / JSON Object]: The root tag.

• [String] type: minecraft:crafting_imbue
• [String] category: Optional. Controls to which recipe book category the recipe belongs to. Available values are: equipment, building, misc, and redstone. Defaults to misc.
• [String] group: Optional. A string identifier. Used to group multiple recipes together in the recipe book. Recipes with same group identifier but different categories splits into two different groups.
• [Boolean] show_notification: Optional. Determines if a notification is shown when unlocking the recipe. Defaults to true
• [String] source: The ingredient which is in the center of the crafting grid.
• [String] material

: The ingredient which is in the eight other slots.

• [NBT Compound / JSON Object] result: The output item of the recipe.
  • [String] id: An item ID.
  • [Int] count: Optional. The amount of the item. Defaults to 1.
  • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

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 or, optionally, the original 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 *[removed in Java Edition 26.1]

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.

Additional fields:

• [String] banner: The item used for both the source and target. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
• [NBT Compound / JSON Object] result: The output item of the recipe. Preserves all components of the source item.
  • [String] id: An item ID.
  • [Int] count: Optional. The amount of the item. Defaults to 1.
  • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

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

Additional fields:

• [String] source: Ingredient to be used as source book. written_book_contents required to match recipe. Will be kept in crafting grid. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
• [String] material: Ingredient to target the item to be cloned. Number of items beyond the first one will be added to the result stack size. Can be one of an [String] ID, a [String] tag with #, or an [NBT List / JSON Array] array containing IDs.
• [NBT List / JSON Array] allowed_generations

: Integer range describing the allowed value of generation field of written_book_contents. Must be a subrange of [0, 2]. Defaults to [0, 1]

• • [Int]: The minimum generation.
  • [Int]: The maximum generation.
• [NBT Compound / JSON Object] result: The output item of the recipe. Preserves all components of the source item, but generation field in written_book_contents is incremented by 1.
  • [String] id: An item ID.
  • [Int] count: Optional. The amount of the item. Defaults to 1.
  • [NBT Compound / JSON Object] components: Optional. Additional information about the item. See item components.

• 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 *[removed in Java Edition 26.1]

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 *[removed in Java Edition 26.1]

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