Modules

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.

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
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
<shaped> </shaped> A shaped crafting recipe node.
Sub-elements Value/Children
<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
symbol Required The 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</ingredient>
    </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> Required An ingredient used in this recipe.
A shapeless recipe requires at least one ingredient.
Single Material Pattern
Shapeless Ingredient Attributes
Attribute Description Value
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
<smelt> </smelt> A custom smelting recipe.
Sub-elements Value/Children
<ingredient> | <i> Required Unique 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>