Content generated with AI — it may contain mistakes.

Systems

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 vault and points.
  • One ledger: whatever reason a plugin pays with — shop:sell, market:fee — is a ledger line, shown with the label in messages.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