Coins Economy

AtlasLobby includes a coins currency used to unlock cosmetics.

By default, coins are built in and stored in data/players.yml, so no economy plugin is required. If you want coins to match your server’s main economy, they can also be backed by Vault.

Configuration

Coins are configured in config.yml:

economy:
  coins:
    enabled: true
    # When true AND Vault + an economy plugin are installed, coins ARE the Vault balance.
    use-vault: false
    symbol: "&#ffd45c⛁ "
    starting-balance: 250     # granted to a new player in built-in mode
    group-digits: true        # 1,000 vs 1000

Setting	Meaning
`enabled`	Turns the coins economy on or off.
`use-vault`	When true, and Vault plus an economy plugin are installed, coins use the Vault balance.
`symbol`	Display symbol used in formatted coin values.
`starting-balance`	Coins granted to new players in built-in mode only.
`group-digits`	Formats numbers as `1,000` instead of `1000`.

Economy Modes

Mode	When it is used	Where coins are saved
Built-in	`use-vault: false`, or Vault is not present.	Balances live in `data/players.yml`; new players receive `starting-balance`.
Vault	`use-vault: true` and Vault is available.	`/al coins`, cosmetic purchases, and reward payouts read and write the Vault balance directly. `starting-balance` is ignored because Vault owns balances.

Use /al debug to confirm the active coin mode:

Coin economy: true

Earning Coins

Daily rewards can grant coins. See Rewards and Player Data.

# rewards.yml
coins:
  enabled: true
  base: 100
  per-streak: 25
  max: 1000

Menu items can also grant coins with the give_coins action:

actions:
  - "give_coins: 50"

Spending Coins

Cosmetics with a cost greater than 0 are purchased with coins the first time a player equips them. See Cosmetics.

Commands

Command	Permission	Description
`/coins`	`atlaslobby.coins` (default true)	Show your balance.
`/al coins balance [player]`	`atlaslobby.coins.admin`	Show a balance.
`/al coins give <player\|all> <amount>`	`atlaslobby.coins.admin`	Give coins.
`/al coins take <player\|all> <amount>`	`atlaslobby.coins.admin`	Remove coins.
`/al coins set <player\|all> <amount>`	`atlaslobby.coins.admin`	Set a balance.

all targets every player currently online. In Vault mode, these commands adjust the Vault balance.

Placeholders

Placeholder	Meaning
`%coins%`	Formatted balance, using symbol and digit grouping.
`%coins_raw%`	Plain numeric balance.