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	Value/Children
<crafting> </crafting>	Node containing the custom crafting recipes.
Sub-elements
<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 just 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	Type
<result>	Required Unique The 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	Value/Children
<shaped> </shaped>	A shaped crafting recipe node.
Sub-elements
<shape>	Required Unique An 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

Example

<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	Value/Children
<shapeless> </shapeless>	A custom shapeless recipe node.
Sub-elements
<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

Example

<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	Value/Children
<smelt> </smelt>	A custom smelting recipe.
Sub-elements
<ingredient>|<i>	RequiredUnique An ingredient used in this recipe. A smelt recipe only accepts one ingredient.	Single Material Pattern

Example

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