Skip to content

Compatibility

Everything on this page was run on a live server. Where something has not been tested it says so rather than being left to imply.

Server software

Tested on
Paper 26.2-121 Works
Purpur 26.2-2632 Works
Folia 26.2-7 Works, with no Vault present

Ember Coins declares folia-supported: true. All scheduling goes through the region-aware schedulers, and balances are written atomically, which matters more on Folia than anywhere else because several regions can be paying each other at the same moment.

Does it work on 1.21?

Probably, but it has not been tested there. The plugin declares api-version: 1.21, uses no NMS and touches no server internals, so there is nothing version-specific left that we know of.

Everything on this page was verified on 26.2. Treat 1.21.x as untested rather than supported, and tell us on Discord if you run it there.

Plugins that spend Ember Coins

Ember Coins registers itself with Vault at the highest service priority, so anything economy-aware picks it up with no configuration at all. These were installed alongside it and hooked on their own:

Plugin Version
Ember Shop 0.1.0 Native, no Vault needed
EconomyShopGUI Premium 6.3.1 All 27 shop sections
ChestShop 3.12.2 build 353
VotingPlugin 7.1.1 Vault economy hook
EcoShop 2026.35.1 One config change, below

What their consoles printed, unedited:

[EconomyShopGUI-Premium] Successfully hooked into Vault and using Ember Coins as economy provider
[EconomyShopGUI-Premium] Completed loading 1 economy provider(s) for all 27 shop sections.
[ChestShop] Using Ember Coins as the Economy provider now.
[VotingPlugin] Successfully hooked into vault economy!

EcoShop needs one config change

EcoShop ships pricing everything as type: coins, which is one of eco's own price factories rather than Vault. Change it to type: $, the Vault factory, and it spends Ember Coins like everything else.

Nothing to do with this plugin. It is EcoShop's default and it behaves the same way with any economy provider.

Custom items for the coin

The coin is a real item, so it can be any item your server already has. Every hook is optional and reached at runtime.

Plugin Reference form
HeadDatabase 4.24.0 hdb:1234 Verified live
ItemsAdder itemsadder:pack:id Implemented, not yet run
Oraxen oraxen:id Implemented, not yet run
Nexo nexo:id Implemented, not yet run
MMOItems mmoitems:TYPE:ID Implemented, not yet run
EcoItems eco:id Implemented, not yet run

ModelEngine is separate from all of the above. It attaches a model to the dropped coin entity, so the coin spins on the floor as a 3D object rather than a flat icon. The item and the model are configured independently, and neither requires the other.

Known conflicts

Two Vault economies. This is the only conflict that causes real damage. If another economy plugin also claims the Vault slot, which one wins depends on load order, and balances appear to disagree depending on which plugin asked.

The fix is one line. Set register-with-vault: false and Ember Coins keeps its own currencies while leaving your main economy alone — useful if you want gems and tokens alongside an EssentialsX balance.

Multi-currency through Vault. 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 quietly move the wrong money.

Known not working

ShopGUIPlus 1.113.0 Crashes on enable on MC 26.2 inside NmsUtils.extractNmsVersion, before it reaches any economy at all. Not related to Ember Coins; it fails identically with every provider we tried.
Any Vault-based plugin on Folia Vault does not run on Folia. Plugins that reach money only through Vault fall back to their own default economy there. Ember Shop talks to us directly and is unaffected.