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 Shop declares folia-supported: true. All scheduling goes through the
region-aware schedulers, which behave identically on Paper and its forks.
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. One known blocker was
found and removed during development: the MAX_HEALTH attribute constant,
renamed in 1.21.3, which would have crashed on 1.21.0 through 1.21.2.
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.
Economies¶
Ember Shop is not tied to our own economy. It uses whatever Vault provides, and falls back to talking to Ember Coins directly when Vault is absent — which is what makes it work on Folia, where Vault does not run at all.
| Economy | Version | |
|---|---|---|
| Ember Coins | 0.1.0 | Via Vault, and directly when Vault is absent |
| ExcellentEconomy | 2.8.0 | |
| EssentialsX | 2.22.0 |
The startup line tells you which one it found:
Items from other plugins¶
Ember Shop stores whole item stacks, so any item can be listed by holding it and clicking. A written reference is only needed for items you cannot hold, such as a head you have not bought yet.
| 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 |
HeadDatabase was verified on a live server with 93,121 heads loaded and resolvable. The rest are written against each plugin's documented API but have not been run on a server yet, and we would rather say that than imply a test we did not do.
Every hook is optional. A missing plugin turns one reference form off; it never stops the shop from loading.
Known conflicts¶
The /shop command. Every shop plugin wants it, and whichever loads first
takes it. Ember Shop's primary command is /embershop, with shop as an alias
that steps aside automatically when another plugin already owns the name. Ours
is always reachable as /embershop.
Two Vault economies. If you run Ember Coins alongside another economy
plugin, whichever claims the Vault slot first decides which balance the shop
spends. Set register-with-vault: false in Ember Coins, or remove the other
economy. See Ember Coins compatibility.
Known not working¶
| Any Vault-based shop on Folia | Vault does not run on Folia, so third-party shops fall back to their own default economy. Ember Shop and Ember Coins talk to each other directly and are unaffected. |