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 |
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 |
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 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 |
Element | Description | Value |
---|---|---|
<row>
|
A row in the recipe crafting shape. | Row String |
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>
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 |
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 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>