> For the complete documentation index, see [llms.txt](https://discortics.com/llms.txt). A consolidated single-file corpus is available at [llms-full.txt](https://discortics.com/llms-full.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://discortics.com/guides/economy.md).

# Economy

Balances and items belong to one server. Money can't move between servers.

## Before you begin

- You need **Manage Server** to change settings or manage the shop.
- Members don't need any special permission.
- Discortics needs **Send Messages** and **Embed Links**.
- Role rewards need **Manage Roles** and a Discortics role above them.

## Set up your currency

### Dashboard Setup

1. Open **Dashboard → Economy**.
2. In **Basic**, choose an emoji under **Currency**.
3. Set the daily reward, work reward, and transfer tax under **Rewards**.
4. Save with the save bar.
5. Test `/economy daily` and `/economy work` in Discord.

### Discord Command Setup

1. Run `/economy settings`.
2. Select **Emoji** and send an emoji, or `default` for the standard coin.
3. Select **Daily** and enter the minimum and maximum.
4. Select **Work** and enter the minimum, maximum, and cooldown in seconds.
5. Select **Tax** and enter a value from `0` to `100`.
6. Test `/economy daily` and `/economy work`.

## Settings

| Setting      | What it does                                       | Default                        |
| ------------ | -------------------------------------------------- | ------------------------------ |
| **Currency** | A Unicode emoji or a custom emoji from this server | Standard coin                  |
| **Daily**    | Random reward, once per UTC calendar day           | `6,000`–`10,000`               |
| **Work**     | Random reward, with a cooldown                     | `1,000`–`3,750`, `300` seconds |
| **Tax**      | Percentage taken from `/economy share`             | `0` turns it off               |

**Reset** in `/economy settings` restores these defaults. It doesn't delete balances, inventories, or shop items.

## Limits

| Resource              | Public | Prime | Custom |
| --------------------- | -----: | ----: | -----: |
| Shop items per server |      5 |    10 |     20 |

If you move to a lower plan, items over the limit can't be bought or managed. The oldest items stay active.

## Earn money

Rewards and games use your **wallet**. Your **bank** is safe from sharing, shops, games, and robbery.

| Command           | What it does                            | Cooldown     |
| ----------------- | --------------------------------------- | ------------ |
| `/economy daily`  | Claim your daily reward                 | One UTC day  |
| `/economy work`   | Earn a work reward                      | Set by staff |
| `/economy beg`    | Ask for a small donation                | 15 minutes   |
| `/economy search` | Search a location. You never lose money | 15 minutes   |
| `/economy crime`  | High reward, but failing costs you      | 30 minutes   |

## Manage money

| Command                                  | What it does                                                                      |
| ---------------------------------------- | --------------------------------------------------------------------------------- |
| `/economy balance user:`                 | Shows wallet, bank, and net worth                                                 |
| `/economy deposit amount:500`            | Moves money to your bank. Accepts a number or `all`                               |
| `/economy withdraw amount:500`           | Moves money to your wallet. Accepts a number                                      |
| `/economy share user:@member amount:500` | Sends wallet money. Minimum `100`, and over `9,999` asks to confirm               |
| `/economy rob target:@member`            | Takes part of their wallet, or you pay them. Both need `1,000`. 7-second cooldown |
| `/leaderboards module:Economy`           | Shows the top 100 by wallet plus bank                                             |

## Earning settings

Open **Dashboard → Economy → Basic → Rewards** to configure **Daily**, **Work**, **Beg**, **Search**, **Crime**, and **Robbery**. Set reward ranges, cooldowns, failure chances, and the applicable fine or stolen-wallet percentages. Existing defaults remain until you customize a command.

### Role salaries

In **Advanced → Role Salaries**, select **Add Salary** to choose a role, amount, and collection interval. Members run `/economy salary` or `;salary` to collect all available salaries for their current roles. Each role has its own cooldown. Missed collections do not accumulate, and earning buffs do not increase salaries.

You can configure **3 salaries on Free, 10 on Premium, and 25 on Custom**, with amounts from 1 to 1,000,000 and intervals from one minute to 30 days. Salaries above your plan’s limit remain saved and are paused until there is capacity again.

Cooldown and duration pickers display days, hours, minutes, and seconds. For example, choose 2 minutes and 30 seconds for a 150-second interval.

### Chat money

In **Advanced**, use the **Chat Money** header toggle to reward new messages. Expand the section to adjust message rewards and cooldowns. Choose a reward range and a cooldown per member. It starts disabled, with a suggested range of 1–5 coins and a 60-second cooldown.

Bots, webhooks, commands, edited messages, and messages handled by moderation do not earn chat money. Repeated delivery of a message does not grant another payout.

## Shop

On the dashboard, select **Create Item** to open the item drawer. Fill in the item details and select **Confirm**. Editing an existing item opens the same drawer.

1. Run `/economy shop item`, or open **Dashboard → Economy → Shop**.
2. Select **Add new item**.
3. Select **Edit** to set its name, description, price, resale price, and stock.
4. Select **Reward** and choose **Role**, **Rank Banner**, or **Earning Buff**.
5. Optional: select **Required Roles**.
6. Check that the item is enabled.
7. Run `/economy shop` and make a low-cost test purchase.

| Option             | What it does                                               | Limit          |
| ------------------ | ---------------------------------------------------------- | -------------- |
| **Name**           | Required                                                   | 100 characters |
| **Description**    | What the member receives                                   | 500 characters |
| **Purchase Price** | Taken from the wallet                                      | At least `1`   |
| **Resale Price**   | Paid when selling. If unset, items are removed for 0 coins |                |
| **Stock**          | Copies available. Empty or `0` is unlimited                |                |
| **Reward**         | Up to five roles, a rank banner, or an earning buff        |                |
| **Required Roles** | The member needs one of these. Empty allows everyone       | Five roles     |

### Consumable earning buffs

Choose **Earning Buff** as an item’s type, then set a **5–100%** earnings increase and a duration from **one minute to seven days**. Members buy it and use it from their inventory.

The bonus applies to daily, work, beg, successful search/crime, and chat earnings. It does not apply to salaries, robbery, transfers, item sales, staff grants, or gambling. Daily streak bonuses apply before the buff.

Buffs do not stack. A stronger buff replaces the active buff and starts its own duration. Trying to use an equal or weaker buff leaves the item in the inventory.

### Buy and use items

1. Run `/economy shop`, select **Buy**, then choose an item and confirm.
2. Run `/economy inventory` and select **Use**. Buying doesn't apply the reward until you use it.
3. To sell, select **Sell** in your inventory. Only items on the current page are listed.

Items use the reward set at the time you use them.

> [!WARNING]
> Deleting a shop item can't be undone. Members keep their copies, but can only sell them for 0 coins.

## Games

Games use wallet money. Run a command with your bet.

| Command                                   | How it works                                                                      |
| ----------------------------------------- | --------------------------------------------------------------------------------- |
| `/economy blackjack amount:500`           | **Hit** or **Stand**. A win pays 2x, blackjack pays 2.5x, a push returns your bet |
| `/economy slots amount:500`               | Spin three symbols                                                                |
| `/economy coinflip amount:500 side:heads` | Call heads or tails                                                               |
| `/economy crash amount:500 multiplier:2`  | Win if the rocket reaches your multiplier before it crashes                       |
| `/economy cross amount:500`               | Each hop raises your multiplier. Cash out before a car hits you                   |
| `/economy mines amount:500 mines:5`       | Reveal gems on a 20-tile grid and cash out before you hit a mine                  |
| `/economy roulette bet:red amount:500`    | A shared 30-second round                                                          |

**Roulette bets:** a number from `0` to `36`, `1-12`, `13-24`, `25-36`, `1-18`, `19-36`, `1st`, `2nd`, `3rd`, `red`, `black`, `even`, or `odd`.

## Marriage

| Command                   | What it does                                    |
| ------------------------- | ----------------------------------------------- |
| `/economy marry user:`    | Propose to a member. They can accept or decline |
| `/economy marriage user:` | View a relationship status                      |
| `/economy divorce`        | End your current relationship                   |

A member can have one marriage at a time. Use [Command Permissions](/guides/commands) to limit these to certain channels.

## Reset all member data

1. Open **Dashboard → Economy → Economy Data**.
2. Select **Reset Economy Stats**.
3. Read the warning and continue.
4. Enter the confirmation text.
5. Select **Reset Stats**.

> [!WARNING]
> This permanently deletes every member's balances, inventories, and rank banners. Settings and shop items stay.

## Troubleshooting

**I can't buy an item with money in my bank.** Shops use your wallet. Run `/economy withdraw amount:` first.

**A shop item didn't give its reward.** Run `/economy inventory` and select **Use**.

**Discortics can't give a shop role.** Give it **Manage Roles** and move its role above the reward role. Integration roles can't be assigned.

**A purchase fails.** Check your wallet, the item's stock and status, and its required roles.

Prefer one-line commands? See [Direct Commands](/guides/command-arguments).