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.

ElementDescriptionValue/Children
Node containing the custom crafting recipes.
Sub-elements
A shaped crafting recipe node.Shaped Recipe Sub-elements
A custom shapeless recipe node.Shapeless Recipe Sub-elements
A custom smelting recipe.Smelt Recipe Sub-elements
Disable all vanilla recipes for this item.Single Material Pattern
Recipe Attributes
AttributeDescriptionValueDefault
Disable all vanilla recipes for the same item. This is just a convenient alternative to the element.true/falsefalse
Override all vanilla recipes resulting in this material.true/falsefalse
Recipe Sub-elements
ElementDescriptionType
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 .

ElementDescriptionValue/Children
A shaped crafting recipe node.
Sub-elements
Required Unique An ingredient used in this recipe.
Only one shape per recipe is allowed.
|Required An ingredient used in this recipe.
A shaped recipe requires at least one ingredient.
Single Material Pattern
Shape Sub-elements
ElementDescriptionValue
A row in the recipe crafting shape.Row String
Shaped Ingredient Attributes
AttributeDescriptionValueDefault
RequiredThe symbol used to specify this ingredients grid location in the recipe.Single CharacterA-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.

ElementDescriptionValue/Children
A custom shapeless recipe node.
Sub-elements
|RequiredAn ingredient used in this recipe.
A shapeless recipe requires at least one ingredient.
Single Material Pattern

Shapeless Ingredient attributes

AttributeDescriptionValueDefault
Amount of items of this type required for this recipe.
Items must be in separate slots, not stacked, for this recipe to work.
Number1-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.

ElementDescriptionValue/Children
A custom smelting recipe.
Sub-elements
|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>