> For the complete documentation index, see [llms.txt](https://zoomiescore.gitbook.io/zoomiescore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zoomiescore.gitbook.io/zoomiescore-docs/community/economy.md).

# economy

A per-server currency (coins) with earning loops, gambling, a shop, and a bank.

## Earning coins

| Command  | Cooldown | Payout                             |
| -------- | -------- | ---------------------------------- |
| `/daily` | 24h      | Base daily drop                    |
| `/work`  | 1h       | Random job payout                  |
| `/fish`  | 5m       | Randomised catch (rarity-tiered)   |
| `/hunt`  | 5m       | Randomised catch                   |
| `/mine`  | 5m       | Randomised ore drop                |
| `/beg`   | 5m       | Small variable amount              |
| `/crime` | 20m      | High payout, chance to fail (fine) |

`/pay user amount` — transfer coins to another member. No fee.

## Bank

`/bank`, `/deposit amount`, `/withdraw amount` — bank balance is safe from `/rob`, wallet is not.

## Gambling

| Command                                | How it works                            |
| -------------------------------------- | --------------------------------------- |
| `/coinflip amount choice:heads\|tails` | 1:1 payout on win                       |
| `/dice amount target:1-6`              | Roll a d6, matching target pays 5×      |
| `/slots amount`                        | 3-reel, jackpot on triple match         |
| `/roulette`                            | Full roulette (colours + numbers)       |
| `/blackjack`                           | Standard rules; bot dealer stands on 17 |

Buy `/lottery-buy` tickets at 50c each. Draws with `/lottery-draw` (mods only) split the pot among ticket-holders weighted by tickets bought.

## Rob

`/rob user` — attempt to steal from another user's **wallet**. Chance of success is capped; failed robberies incur a fine to the victim. Bank balance is untouched.

## Shop & inventory

```
/shop                         → browse everything on sale
/buy item:<name> qty:<n>      → purchase
/inventory                    → see what you own
```

## Leaderboards

```
/coinleaderboard              → top 10 richest members in this server
/achievements                 → your unlocked achievements
```

## Quests

```
/quest                        → your active quests (auto-refreshed daily)
/claim-quest                  → claim rewards for completed quests
```

## Isolation

Every economy balance and every inventory row is keyed on `(user_id, guild_id)` — coins earned in one server never spill into another. A user is essentially a different economy citizen per server.
