> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/core/currencies.md).

# Currencies

EdPets ships lightweight **internal currencies** used by boosts, enhancements and (by default) upgrades — one file per currency in `currencies/`. Shipped: `boost-tickets`, `special-boost-tickets`, `enhancement-tickets`.

```yaml
# currencies/boost-tickets.yml
display-name: 'Boost Tickets'
singular: 'Boost Ticket'
plural: 'Boost Tickets'
starting-value: 0
command:
  name: boostticket
  aliases: [boosttickets]
  admin-permission: edpets.currency.admin
  pay-enabled: false
messages:            # optional — defaults apply when omitted
  balance: '&3&l[!] &b{player}''s balance: &f{balance} &b{currency}'
```

Each currency registers its own command: `/<name> <balance|give|take|pay|set> [player] [amount]` (`give/take/set` need the admin permission; append `-s` for silent console pipelines). Balances live on the player's data and support offline players.

## Paying with other plugins' economies

Anywhere EdPets charges something (upgrades, fusion, backpack upgrades) takes an `economy` section that either names an internal currency **or** bridges an external plugin:

```yaml
economy:
  currency: boost-tickets            # internal
# — or —
economy:
  display-name: '&eTokens'           # shown in menus ({currency} placeholder)
  balance-placeholder: '%pinnaprison_currency_balance_tokens%'
  withdraw-commands:
    - 'tokens take {player} {amount} -s'
  deposit-commands:                  # used by refunds
    - 'tokens give {player} {amount} -s'
```

Balance placeholder: `%edpets_currency_<id>%`.