Skip to content

Crafting Recipes

Crafting recipes are used for the player inventory crafting grid, crafting table, and auto-crafter.

Properties


result Result

Defines the resulting item that this recipe produces.

formula Formula

Defines the crafting recipe evaluation logic.

hocon
type = crafting
priority = 10
group = "group_name"
conditions {
  // Condition settings
}
formula {
  // Formula settings
}
result {
  // Result settings
}

Formula Formula

The formula defines the crafting logic used to evaluate the items in the grid.

Shapeless type = shapeless

A crafting formula with a list of ingredients that can be arranged in any order.

Properties

ingredients list<Ingredient>

A list of ingredients required for the recipe. See Ingredient documentation.

hocon
type = shapeless
ingredients = [
  {
    // Ingredient settings
  },
  // ...
]

Shaped type = shaped

A crafting formula that requires ingredients to be arranged in a specified shape. Ingredients are mapped to characters in the shape.

Properties


mappedIngredients Map<char, Ingredient>

A map of character identifiers to Ingredients

shape Shape

The shape of the recipe.

hocon
type = shaped
mappedIngredients = {
  I: {
    // Ingredient settings
  },
  // ...
}
shape {
  // Shape settings
}

Shape Shape

The layout and symmetry settings for a shaped recipe.

Properties


rows list<String>

The rows of the recipe shape.

symmetry Symmetry optional

Symmetry settings for the shape.

trim boolean optional

Whether the shape should be trimmed.

This removes any trailing empty columns and rows from the shape. Which allows shapes that only take up a fraction of the grid to be placed in different places.
For example, a 2x2 recipe may be placed in each of the corners.

When disabled items must be placed exactly where they are in the shape including empty slots.

hocon
rows = [
  "ISI",
  " S ",
  " S "
]
symmetry {
  // Shape symmetry settings
}
trim = true

Shape Symmetry Symmetry

Symmetry settings for the shape.

Properties


horizontal optional

Whether horizontal symmetry is applied.

vertical optional

Whether vertical symmetry is applied.

rotate optional

Whether rotation symmetry is applied.
This allows the recipe to be rotated within the grid i.e. horizontal and vertical symmetry combined, equals rotated.
When disable it must either be horizontal or vertical symmetry.

hocon
horizontal = false
vertical = false
rotate = false