Integrations
How other Exylia plugins pay in these currencies, Vault plugins, PlaceholderAPI, ExyliaAnalytics, the plugins it loads before, and Folia.
Other Exylia plugins
ExyliaLib talks to economies and keeps none of its own. ExyliaEconomy is one of them: every stored, item and experience currency registers with the library's economy facade, so a shop, a market, a kit, a reward or a mission in any Exylia plugin prices and pays in them by id, with nothing written for this plugin in particular.
What that gives every plugin on the server:
- One list of currencies, in the sort order set in
/economyadmin, for every currency picker. - One permission rule: a currency that names a permission is hidden and refused for anyone without it, in every plugin that asks.
- One look: name, symbol, decimals and format, including the display-only overlays for
vaultandpoints. - One ledger: whatever reason a plugin pays with —
shop:sell,market:fee— is a ledger line, shown with the label inmessages.yml. - One event: every change to a stored balance fires ExyliaLib's
BalanceChangeEvent, once, on the server that wrote it — so a change queued on one server and applied on another is announced once, where it lands.
ExyliaSurvivalCore loads after ExyliaEconomy for this reason: its shop, market, auctions, orders, trades, boosters and rewards all pay through the facade.
Vault plugins
Everything that only speaks Vault — ShopGUIPlus, EconomyShopGUI, ChestShop, QuickShop, Jobs, zAuctionHouse, AuctionHouse and the rest — runs on the stored currency published to Vault. See Vault.
plugin.yml lists these under loadbefore, so ExyliaEconomy enables first and they find the Vault economy
during their own enable: ExyliaSurvivalCore, ExyliaMines, ShopGUIPlus, EconomyShopGUI, ChestShop,
QuickShop, Jobs, zAuctionHouseV3 and AuctionHouse.
PlaceholderAPI
With PlaceholderAPI installed, every placeholder is exposed under the plugin's identifier,
%exyliaeconomy_…%, with no expansion to download. Without it, they still work inside every Exylia
plugin's own files. See Placeholders.
ExyliaAnalytics
When ExyliaAnalytics is installed, each server hands it the money supply of every stored currency: the sum of every balance and how many players hold any, read from the database a minute after the start and every ten minutes after that. A per-server currency is reported under its per-server key. The individual movements reach ExyliaAnalytics through the balance-change events.
See ExyliaAnalytics' economy page for what the dashboard does with them.
Folia
folia-supported: true. Every message, menu and inventory change runs on the thread that owns the player,
the periodic sweeps run off the main thread, and nothing waits on the database on a game thread.
Something missing on this page? Tell us on Discord