Workbench config

Guide how to create and configure new workbenches.

You can create unlimited workbenches by copying and adjusting the default.yml config file in the workbenches folder.

The ID of the workbench is the same as its config filename. For example default.yml workbench will have the ID: default.

Here is an example workbench config:

# Title of the workbench inventory
title: "Craft Item"

# How many rows should the workbench inventory have?
rows: 6

# Result slot is where the result of the recipe will be placed.
result-slot: 23

# Matrix slots are used to assemble the recipe.
matrix-slots: [ 10, 11, 12, 19, 20, 21, 28, 29, 30 ]

# Quick crafting slots are used to craft items without assembling the recipe in the recipe.
quick-crafting-slots: [ 16, 25, 34 ]

# Where should we put the items that indicate the completion of a recipe?
completion-indicator-slots: [ 45, 46, 47, 48, 49, 50, 51, 52, 53 ]

# This is an experimental feature and it will probably be experimental forever.
# Turning this on might cause performance issues.
include-vanilla-recipes-in-quick-crafting: false

# Options when a recipe is opened from the recipe book
recipe-book:
  # Title in the recipe book when you view a recipe from this workbench
  title: "Crafting recipe"
  # Previous recipe slot button (only when using grouping)
  prev-recipe-slot: 52
  # Next recipe slot button (only when using grouping)
  next-recipe-slot: 53
  # Recipe result slot
  result-slot: 25
  # Back slot if applicable
  back-slot: 45
  # Additional custom items to map to the recipe view inventory
  custom-items: { }

# Other custom items to add to the workbench inventory
# For example some cosmetic stuff
custom-items: { }

# You can also override every default item here for this workbench that are
# defined in the menus/workbench_defaults.yml

Default items

The menus/workbench_defaults.yml file holds the default title, rows, filler and the items shared by every workbench. You can override any of these in a workbench config by using the same key; the options you set are merged on top of the default item.

Key	Description
`invalid-result-item`	Displayed in the result slot when there is no valid recipe in the matrix. Don't use AIR here.
`empty-quick-craft-item`	Displayed in a quick crafting slot when there is nothing to quick craft.
`no-permission-quick-craft-item`	Displayed in a quick crafting slot the player has no permission for.
`blueprint-completed-item`	Displayed in the completion indicator slots when the recipe is complete.
`blueprint-not-completed-item`	Displayed in the completion indicator slots when the recipe is not complete.
`next-recipe-item` / `previous-recipe-item`	Buttons to page through grouped recipes in the recipe view.
`back-item`	Back button in the recipe view.

Quick crafting

The quick crafting slots show recipes the player can craft right away from the items in their inventory. Clicking one crafts the recipe without assembling it in the matrix. Each slot requires the aurora.quickcraft.<workbench>.<slot> permission, where <slot> is the inventory slot number (for example aurora.quickcraft.default.16). Recipes with quick-craft: false never show up here.