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

# Economy commands reference

# Economy Commands Reference (Audit)

Last updated: 2026-04-19

This file documents all economy commands currently wired through `/economy`, their defaults, permission model, aliases, configuration support from dashboard `/commands`, prefix support, and `/commands` browser visibility.

## Permission model (global)

For command execution, the following applies:

1. **If command is disabled** in `guild_command_configs`, it is blocked for everyone.
2. Otherwise, `CommandGuard` checks restrictions (roles/channels/required permissions/cooldown).
3. **Bypass roles/users** for restriction checks:
   * Server owner
   * Administrator
   * Manage Guild
   * Bot managers (`dashboard_manager_users`, `dashboard_manager_roles`)
4. Some commands add **extra in-command checks** (notably `economy reset` and `economy manage`).

## Dashboard configurability

All commands listed in the table are represented in dashboard command settings as `economy ...` keys and support:

* enabled/disabled
* aliases
* allowed role ids
* allowed channel ids
* required permissions
* cooldown

Backend sync for economy runtime flags/cooldowns is implemented in `server/routes/dashboard.js` under module `commands`.

## Command matrix

| Command key             | Slash usage                                 | Description                        | Default aliases | Default required permissions (dashboard) | Extra runtime permission check                                                        | Prefix support (`/economy` router) | In `/commands` browser |
| ----------------------- | ------------------------------------------- | ---------------------------------- | --------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------- | ---------------------- |
| economy balance         | `/economy balance [user]`                   | Check your wallet and bank balance | `bal`           | none                                     | none                                                                                  | yes                                | yes                    |
| economy daily           | `/economy daily`                            | Claim daily reward                 | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy weekly          | `/economy weekly`                           | Claim weekly reward                | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy work            | `/economy work`                             | Work for coins                     | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy beg             | `/economy beg`                              | Beg for coins                      | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy hustle          | `/economy hustle`                           | Hustle for coins                   | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy crime           | `/economy crime`                            | Risky crime for coins              | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy blackjack       | `/economy games blackjack <bet>`            | Play blackjack                     | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy roulette        | `/economy games roulette <bet> <space>`     | Play roulette                      | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy slots           | `/economy games slots <bet>`                | Play slots                         | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy lottery         | `/economy games lottery <amount>`           | Join lottery                       | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy cockfight       | `/economy games cockfight <bet>`            | Bet on cockfight                   | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy rps             | `/economy games rps <bet> [opponent]`       | RPS with bet                       | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy tictactoe       | `/economy games tictactoe <bet> [opponent]` | TicTacToe with bet                 | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy coinflip        | `/economy games coinflip <bet> <side>`      | Coinflip with bet                  | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy rob             | `/economy rob <user>`                       | Attempt robbery                    | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy deposit         | `/economy deposit <amount>`                 | Deposit to bank                    | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy withdraw        | `/economy withdraw <amount>`                | Withdraw from bank                 | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy pay             | `/economy pay <user> <amount>`              | Pay another user                   | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy drop            | `/economy drop <amount> [limit] [duration]` | Drop wallet coins                  | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy shop            | `/economy shop`                             | Open shop                          | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy buy             | `/economy buy <item>`                       | Buy item                           | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy sell            | `/economy sell <item>`                      | Sell item                          | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy use             | `/economy use <item>`                       | Use item                           | none            | none                                     | none                                                                                  | yes                                | yes                    |
| economy give            | `/economy give <user> <item>`               | Give item                          | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy inventory       | `/economy inventory [user]`                 | View inventory                     | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy item            | `/economy item <item>`                      | View item info                     | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy itemleaderboard | `/economy itemleaderboard <item>`           | Top by item ownership              | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy leaderboard     | `/economy leaderboard`                      | Top richest users                  | none            | none                                     | none                                                                                  | no                                 | yes                    |
| economy reset           | `/economy reset [user] [type] [everyone]`   | Reset balances/inventory           | none            | `ManageGuild`                            | **Must be economy manager** (`owner` or `ManageGuild` or economy manager users/roles) | no                                 | yes                    |
| economy manage          | `/economy manage [user]`                    | Manage balances/items/coupons      | none            | `ManageGuild`                            | **Must be economy manager** (`owner` or `ManageGuild` or economy manager users/roles) | no                                 | yes                    |

## Notes

* `/commands` browser now renders slash mentions for slash-capable commands, including economy subcommands in mention form:
  * Example: `</economy balance:COMMAND_ID>`
* If a slash command id cannot be resolved in cache/API, fallback is plain text usage.
* Dashboard entry `economy coinflip` shows usage with `<heads|tails>` while slash option name is `side`; behavior is correct, label wording differs only.