Custom Recipes

How to rework the crafting recipes in recipes.yml, from changing one ingredient to redesigning a shape from scratch.

recipes.yml holds the crafting recipes for the Ability Shard (the reroll item) and every craftable primary ability. All of them can be reworked freely. Recipes register when the plugin enables and rebuild on /ascend reload, so a reload is enough to test a change; no restart needed.

To see what the default recipes look like in game, visit Crafting.

⚠️

The recipes-version line at the top lets new recipes merge into your file on upgrades without wiping your changes. Never edit it by hand.

The format

Each recipe has two parts:

Part	What it means
`shape`	1 to 3 rows of the crafting grid, each row up to 3 characters long. Every character is a symbol you choose; a space means an empty slot.
`ingredients`	One entry per symbol used in the shape, mapping it to a Minecraft material name.

Material names come from the official Spigot list: Material list. Use the names exactly as written there, like GOLD_INGOT or ENDER_PEARL.

The key of each recipe (the name above shape) is either shard for the reroll item, or a primary ability id (blood, phase, flame, thunder, health, rotten).

Example: the default shard recipe

The Ability Shard rerolls a player's secondary into a different random one. Its default recipe looks like this:

recipes:
  shard:
    shape:
      - "GEG"
      - "EAE"
      - "GEG"
    ingredients:
      G: GOLD_INGOT
      E: ENDER_PEARL
      A: AMETHYST_SHARD

Reading it out loud: gold ingots in the four corners (G), ender pearls on the four edges (E), and one amethyst shard in the middle (A).

Worked example: changing it

Say ender pearls are too cheap on your server and you want the shard to cost diamonds instead, in a smaller cross shape. Edit the entry like this:

recipes:
  shard:
    shape:
      - " D "
      - "DAD"
      - " D "
    ingredients:
      D: DIAMOND
      A: AMETHYST_SHARD

What changed:

The E symbol is gone, so its ingredients line is removed too. Every symbol in the shape needs a matching ingredient entry, and only those symbols should be listed.
The corners are now spaces, meaning those crafting slots must be empty.
D is a new symbol mapped to DIAMOND.

Save the file and run /ascend reload (see Commands). The old recipe is replaced immediately.

💡

Shapes do not have to fill the whole grid. A one-row recipe like "DAD" is valid, and so is a 2 by 2 layout written as two 2-character rows.

The costs are the only thing this file changes; the numbers behind each crafted ability live in Balance (abilities.yml). If a recipe refuses to register, double-check the material spelling against the Spigot list, and ask on Discord if you are stuck: discord.arrowtan.cc.