Skip to content

Ember Coins

A multi-currency economy with money you can hold.

What it is

An economy other plugins can spend. The primary currency registers with Vault, so every economy-aware plugin on the server uses it without being told to — shops, jobs, casinos, auction houses.

More than one currency. Coins, gems and tokens out of the box, each with its own name, symbol, icon and starting balance. Any of them can be made non-transferable, for currencies that should be earned rather than traded.

Money as a thing in the world. Coins drop from mobs, sit on the ground with their value floating above them, and bank themselves when you walk over them. Players can withdraw balance back into an item to trade or store.

Installing

  1. Drop EmberCoins.jar into plugins/.
  2. Install Vault if you want other plugins to use this economy.
  3. Start the server.
[EmberCoins] Currencies: coins, gems, tokens (primary: coins)
[EmberCoins] Registered with Vault as the server economy.

Multi-currency, honestly

Vault's API predates multi-currency and has no room for it, so only the primary currency is exposed to other plugins. The rest are reachable through our commands, placeholders and API.

That split is deliberate. Pretending Vault can address several currencies produces plugins that silently move the wrong money.

Not taking over

Set register-with-vault: false, or toggle Server economy in /coins gui, and Ember Coins keeps its own currencies while leaving the main economy to whatever else you run.

Two economies is the one real conflict

If two plugins both claim the Vault economy slot, which one wins depends on load order, and balances then appear to disagree depending on which plugin asked. Run one, or turn this off.

Next