Skip to main content

The souls economy

Souls are a currency you earn by killing, banked inside a soul gem, and spent by enchants that demand them. They give you a way to gate powerful effects behind a resource the player has to grind for.

The soul gem​

A soul gem is a distinct item players carry. It has two jobs:

  • It banks souls. With souls.deposit-on-any-kill enabled (the default), every kill deposits souls into the carried gem — souls-per-kill by default, with optional per-mob overrides (a Wither might be worth 100, a player 10).
  • It is a spend switch. Right-click the gem to toggle soul mode on or off. Souls only get spent while soul mode is on — that is the gate that lets soul-cost enchants and the REMOVE_SOULS effect draw from your balance.

The gem's lore shows the running total via the {SOUL_COLOR} token, color-coded by tier (white → green → aqua → pink as the count climbs).

Combining and splitting​

Drag one gem onto another to combine them — their souls sum into a single gem. Use /splitsouls <amount> (or its alias /se split <amount>) to carve some souls off into a fresh gem. This makes souls tradeable and storable.

Spending souls​

An enchant can charge a soul-cost per activation, and the REMOVE_SOULS effect can debit a balance directly. Spending does not draw on one nominated gem — it draws on a cross-gem soul pool:

  • The balance is the sum. While soul mode is on, the spendable total is every carried gem's souls added together. Ten gems of 5 souls spend exactly like one gem of 50.
  • Spends are all-or-nothing. If the pool can't cover the full cost, nothing is debited and the enchant simply doesn't fire — there is no partial spend.
  • Gems drain least-full-first. Once a cost is charged, it comes out of the emptiest gems first, which tidies small gems away instead of nibbling every gem at once.

The player must still be in soul mode for any of this to happen; out of soul mode, a soul-cost enchant is a no-op.

The master deposit switch lives at souls.deposit-on-any-kill in config.yml; the rest of the soul economy is the gem's own item file.