How to make a Recipe

Recipes

Each recipe is a YAML file in recipes/<workstation>/. The file name (without .yml) is the recipe ID. An _example_<workstation>.yml is provided in each folder (e.g. recipes/brewing_stand/_example_brewing.yml).

Common Config

These fields exist on every recipe type.

enabled: true
# category: main # optional - category ID to assign this recipe to in the GUI

type: crafting_table # workstation type (see table above)

output: netherite_sword name:"&6Example Sword" # eco item lookup format
lore: [] # optional extra lore on the output item

give-result-item: true # false = no item given; fire libreforge effects instead
# effects:
#   - id: give_xp
#     args:
#       xp: 100
# conditions: []

# price: # optional - requires the player to pay a price to craft this recipe
#   value: "100" # expression, supports placeholders
#   type: "coins" # price factory name (coins, xpl, etc.), or an item name to charge an item price instead
#   display: "&a%value% coins" # optional - falls back to lang.yml's price-display section for this type if omitted

permission: "" # optional - see Permissions section below

locked-by-default: false # hide recipe until unlocked per-player
show-when-locked: false # if true, show recipe in GUI even when locked
locked-lore:
  - "&cUnlock this recipe to craft it."

visibility-conditions: [] # libreforge - hide from GUI if not met
crafting-conditions: [] # libreforge - block crafting if not met
unlock-conditions: [] # auto-unlock on join if met

Items use eco item lookup format.

Permissions

Every recipe is gated by a permission node, whether or not you set one.

• permission: "" (blank/default) - the recipe auto-gets its own node, ecocrafting.recipe.<id> (<id> = the yml file name). Plugin ships ecocrafting.recipe.* at default: true, so every player has every recipe's node out of the box. To lock one recipe down, revoke its specific node (e.g. ecocrafting.recipe.netherite_sword) from a group in your permissions plugin - no yml edit needed.

• permission: "some.custom.node" - overrides the auto node entirely for this recipe. Use this to put several recipes behind one shared node (e.g. myserver.tier.netherite on 5 different recipes) so ops grant/revoke the whole tier in one go instead of per-recipe. Not covered by the ecocrafting.recipe.* default - you grant it yourself.

Workstation Config

Each section below shows only the fields unique to that workstation. All common fields above apply too.

Crafting Table

type: crafting_table

# 3x3 grid, left-to-right top-to-bottom. Empty slots = "".
recipe:
  - diamond
  - diamond
  - diamond
  - diamond
  - netherite_ingot
  - diamond
  - diamond
  - diamond
  - diamond

shapeless: false # true = any slot order
symmetry: false # true = register all rotations/mirrors automatically
support-crafter: false # true = also fires in the vanilla Crafter block

Furnace

type: furnace

input: raw_iron # item placed in the smelting slot
cook-time: 200 # ticks (200 = 10 seconds, vanilla default)
experience: 0.7 # XP orbs dropped when result is taken

Blast Furnace

type: blast_furnace

input: raw_gold
cook-time: 100 # ticks (blast furnace is 2× faster; vanilla = 100)
experience: 1.0

Smoker

type: smoker

input: potato
cook-time: 100 # ticks (smoker is 2× faster for food)
experience: 0.35

Campfire

type: campfire

input: rabbit
cook-time: 600 # ticks (campfire is slow; vanilla = 600)
experience: 0.35

Smithing Table

type: smithing_table

template: netherite_upgrade_smithing_template
base: diamond_sword
addition: netherite_ingot

Stonecutter

type: stonecutter

input: stone

# Multiple outputs supported - each appears as a separate option in the UI.
outputs:
  - item: stone_slab
    lore: []
    give-result-item: true

  - item: stone_stairs
    lore:
      - "&7Crafted from stone"
    give-result-item: true

  # give-result-item: false on an output fires effects instead of giving the item
  - item: stone_brick_wall
    lore: []
    give-result-item: false
    effects:
      - id: give_xp
        args:
          xp: 25
    conditions: []

Brewing Stand

type: brewing_stand

base: glass_bottle # item in the bottle slots (can be an existing potion)
ingredient: nether_wart # item in the ingredient slot (top)
brew-time: 20 # ticks to brew (20 = 1 second)

Grindstone

type: grindstone

item1: enchanted_book # left slot (required)
item2: enchanted_book # right slot (optional - omit for single-item recipes)

Anvil

type: anvil

base: iron_sword # item in the left slot (required)
material: diamond # item in the right slot (optional - omit for rename-only)
result-name: "&bDiamond-Edged Sword" # optional - renames the result
repair-cost: 3 # levels shown and consumed

Villager Trade

type: villager

input1: emerald # first trade ingredient (required)
input2: book # second trade ingredient (optional)

profession: FARMER # optional - restrict to this profession
min-level: 1 # optional - minimum villager level (1-5; 0 = any)
chance: 1.0 # probability this trade appears on a villager (0.0-1.0)
wandering-trader: false # true = inject into WanderingTrader instead
villager-xp: 0 # XP awarded to the villager on trade completion

Where to go next

• Recipe formats: Recipes for the shared reference on ingredient keys and which plugins support what.

• Build a category: How to Make a Category to group recipes in the browser GUI.

• Plugin config: Plugin Config for the GUI and sound settings.

• Commands: Commands and Permissions for locking/unlocking recipes.