> ## Documentation Index
> Fetch the complete documentation index at: https://heimdall.gg/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy

> Virtual server currency - earning coins, tipping members, daily claims, and the leaderboard.

The economy system gives your server a virtual currency that members earn and spend through games and daily claims. The currency is server-specific - balances do not carry across servers.

![Games Economy](https://mintcdn.com/bifrost-77/cWdWsyIXuC0bGrEs/images/Games_Economy.png?fit=max\&auto=format\&n=cWdWsyIXuC0bGrEs\&q=85\&s=33fcc2e549f016abbcdcf288e11f89a4)

## Checking your balance

```text theme={null}
/balance [user]
```

Displays your current coin balance. If you specify a user, it shows that member's balance instead (subject to whether they have made their balance visible).

## Daily claim

```text theme={null}
/dailycoins
```

Claims your daily coin allocation. Members can run this once per cooldown period (24 hours by default). The amount awarded is set in [**Games > Configuration > Economy**](https://bot.bifrost.gg/go/games/config/economy).

Administrators can also create additional claim commands with custom amounts and cooldowns using the `/economy claim` configuration.

## Tipping other members

```text theme={null}
/tip <user> <amount>
```

Transfers coins from your balance to another member. The tip is immediate and cannot be reversed. Use this to reward helpful members, pay for services within the game economy, or share winnings.

## Leaderboard

```text theme={null}
/leaderboard
```

Displays the top coin holders on your server ranked by balance. The leaderboard is server-specific.

Administrators can also view the full leaderboard in the dashboard under [**Games > Players**](https://bot.bifrost.gg/go/games/players), which includes more detail than the in-Discord version.

## Claim rewards

The `/economy claim` command allows administrators to set up one-time or recurring claim events. Members run the command to receive a reward defined by the administrator. Configure claim events in [**Games > Configuration**](https://bot.bifrost.gg/go/games/config).

## Managing member balances

Administrators can view and adjust individual member balances through the dashboard at [**Games > Players**](https://bot.bifrost.gg/go/games/players). Select a member and use the balance adjustment tools to add, remove, or set their balance directly. All adjustments are logged.

## Transaction history

The dashboard at [**Games > Transactions**](https://bot.bifrost.gg/go/games/transactions) shows a log of all economy transactions: daily claims, tips, game wins and losses, and admin adjustments. Each entry shows the member, the amount, the type of transaction, and the timestamp.

## Currency customisation

Configure the currency name, emoji, daily claim amount, and starting balance in [**Games > Configuration > Economy**](https://bot.bifrost.gg/go/games/config/economy). Changing the currency name does not affect existing balances.

## Required permissions

| Action | Permission key |
| - | - |
| Checking balance and claiming | `games.use` (default allow) |
| Tipping | `games.use` (default allow) |
| Managing player balances | `games.manage` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.