Crafting Recipes

The crafting module allows custom shaped and shapeless crafting recipes and smelting products. Vanilla recipes for a specific material can also be disabled to prevent crafting of that material except with the new recipe.

Crafting Element

Element	Description
<crafting> </crafting>	Node containing the custom crafting recipes.

Sub-elements		Value/Children
<shaped>	A shaped crafting recipe node.	Shaped Recipe Sub-elements
<shapeless>	A custom shapeless recipe node.	Shapeless Recipe Sub-elements
<smelt>	A custom smelting recipe.	Smelt Recipe Sub-elements
<disable>	Disable all vanilla recipes for this item.	Single Material Pattern

Recipe Attributes

Attribute	Description	Value	Default
override	Disable all vanilla recipes for the same item. This is a convenient alternative to the <disable> element.	true/false	false
override-all	Override all vanilla recipes resulting in this material.	true/false	false

Recipe Sub-elements

Element	Description	Value
<result>	RequiredUniqueThe result of this recipe, only one result is allowed per recipe. Accepts all attributes and sub-elements of a normal kit item.	Item

Shaped Recipes

Shaped recipes require that their items are arranged in a specific location on the crafting grid.

The crafting grid is represented inside <shape> using <row> elements. A <row> element contains a string with up to 3 symbols specifying the ingredient at that spot in the grid. An ingredients symbol is defined in the <ingredient symbol=""> attribute.

A shaped recipe does not need to specify all 3 rows of a crafting grid, only one row is required. All columns in a shaped recipe need to be the same width. Blank ingredient spots are specifed with a dot .

Element	Description
<shaped> </shaped>	A shaped crafting recipe node.

Sub-elements		Value/Children
<shape>	RequiredUniqueAn ingredient used in this recipe. Only one shape per recipe is allowed.	<row>
<ingredient>|<i>	Required An ingredient used in this recipe. A shaped recipe requires at least one ingredient.	Single Material Pattern

Shape Sub-elements

Element	Description	Value
<row>	A row in the recipe crafting shape.	Row String

Shaped Ingredient Attributes

Attribute	Description	Value	Default
symbol	RequiredThe symbol used to specify this ingredients grid location in the recipe.	Single Character	A-Z 0-9

Examples

<crafting>
    <!-- Add custom shaped recipe and disable vanilla recipes for the same item. -->
    <shaped override="true">
        <result material="stone pickaxe">
            <enchantment level="2">durability</enchantment>
        </result>
        <shape>
            <row>FFF</row>
            <row>.S.</row>
            <row>.S.</row>
        </shape>
        <ingredient symbol="F">flint</ingredient >
        <ingredient symbol="S">stick</i>
    </shaped>

    <!-- 3x1 recipe, cheaper gold ingots -->
    <shaped override="true">
        <result material="gold ingot"/>
        <shape>
            <row>GGG</row>
        </shape>
        <ingredient symbol="G">gold nugget</ingredient >
    </shaped>
</crafting>

Shapeless Recipes

Unlike a shaped recipe, shapeless recipes do not require that their items are arranged in any specific way in the crafting grid.

Element	Description
<shapeless> </shapeless>	A custom shapeless recipe node.

Sub-elements		Value/Children
<ingredient>|<i>	RequiredAn ingredient used in this recipe. A shapeless recipe requires at least one ingredient.	Single Material Pattern

Shapeless Ingredient attributes

Attribute	Description	Value	Default
amount	Amount of items of this type required for this recipe. Items must be in separate slots, not stacked, for this recipe to work.	Number	1-9

Examples

<crafting>
    <shapeless>
        <result material="redstone"/>
        <ingredient>sugar</ingredient>
        <ingredient amount="3">ink sack:1</ingredient>
    </shapeless>
</crafting>

Smelt Recipes

Smelt recipes specify what a material gets smelted into in a furnace.

Element	Description
<smelt> </smelt>	A custom smelting recipe.

Sub-elements		Value/Children
<ingredient>|<i>	RequiredUniqueAn ingredient used in this recipe. A smelt recipe only accepts one ingredient.	Single Material Pattern

Examples

<crafting>
    <smelt>
        <result amount="16" material="torch"/>
        <ingredient>stick</ingredient>
    </smelt>
</crafting>