Economy Integration

Economy Integration

The Auction House and paid crates need a currency. CelestialCosmetics is not tied to any specific economy plugin — pick a mode in config.yml under economy.economy-mode.

economy:
  economy-mode: vault      # vault | eddungeons | commands
  currency: credits        # currency id (eddungeons / commands)
  currency-display: Credits
  balance-placeholder: '%some_balance_placeholder%'   # commands mode only
  commands:
    give: '{currency} give {player} {amount}'
    take: '{currency} remove {player} {amount}'

If the chosen mode can't start (plugin missing, placeholder not resolving…), purchases are disabled with a clear console error — the plugin never silently hands out free items.

Modes

vault

Hooks into any Vault-compatible economy (EssentialsX, CMI, and most others). This is the Minecraft standard. Note: Vault only exposes the server's main balance, so the currency field is ignored in this mode.

eddungeons

Direct hook into the EdDungeons Currency API, for custom currencies (credits, gems…). The currency field selects which one. Individual crates can charge a different currency with their own currency: field.

commands

Works with literally any currency plugin: read the balance from a placeholder and charge/pay with console commands. Offline sellers are paid on their next login.

Ready-made commands configs

PlayerPoints:

economy:
  economy-mode: commands
  balance-placeholder: '%playerpoints_points%'
  commands:
    give: 'points give {player} {amount}'
    take: 'points take {player} {amount}'

Any credits-style plugin (e.g. RivalCredits): set balance-placeholder to its balance placeholder and commands.give / commands.take to its give/take commands.

Vault money via commands (EssentialsX):

economy:
  economy-mode: commands
  balance-placeholder: '%vault_eco_balance%'
  commands:
    give: 'eco give {player} {amount}'
    take: 'eco take {player} {amount}'

Placeholders in templates

• {currency} → the currency id
• {player} → the player name
• {amount} → the amount (plain number)

Note for networks

This plugin syncs cosmetics across servers (Network Sync), but not currency — your economy plugin must be network-aware itself for balances to match across servers.

---

Next: GUI Customization