Currencies & Economy

Drako Dungeons stores profile-local wallets in dungeons.db. The current build uses the internal economy only; settings/engine.yml: economy.money-provider must remain INTERNAL.

Currency catalogue

Currencies are declared in content/currencies.yml:

schema-version: 1

currencies:
  money:
    display-name: '<green>Money</green>'
    symbol: '$'
    decimal-places: 2
  tokens:
    display-name: '<gold>Tokens</gold>'
    symbol: '✦'
    decimal-places: 0
    starting-balance: 0
    leaderboard: true

IDs are referenced by zones, rewards, purchases, abilities, armor, companions, setup scaling, and rebirth resets. money, souls, essence, and shards are core system wallets and must remain defined. Additional currency IDs can be added for custom content.

Optional currency fields include a starting balance, balance cap, and leaderboard availability. Values are rounded according to decimal-places.

Referencing currencies

Use the stable lowercase ID, not the display name:

purchase: { currency: money, amount: 25000 }
rewards:
  tokens: { amount: 3, chance: 0.10 }

Every reference is cross-validated. Removing or renaming a currency while another file still refers to it causes validation to fail.

Admin balance commands

/dga player <player> <currency> add <amount>
/dga player <player> <currency> remove <amount>
/dga player <player> <currency> set <amount>

The target profile must be loaded. Negative results and values outside the supported range are rejected.

Rebirth reset control

Currencies reset by rebirth are configured in settings/gameplay.yml:

rebirth:
  reset:
    currencies: [money]

Use currencies: [] to preserve every wallet. Every listed ID must exist in content/currencies.yml.

PlaceholderAPI balances

With PlaceholderAPI installed, each configured currency exposes compact and raw values:

%drakodungeons_currency_money%
%drakodungeons_currency_money_raw%
%drakodungeons_currency_tokens%

The shorter %drakodungeons_money% form is also resolved for configured IDs, but the explicit currency_<id> format is recommended for clarity.