# Economy System

The Economy system provides a comprehensive currency management system for your server, allowing users to earn, spend, and track their balances. The system includes both Checking and Cash balances, with various administrative tools for managing the economy.

## <mark style="color:red;">Server Admin Setup</mark>

### Currency Configuration

```
/currency-config [emoji] [name]
```

* View or set the server's currency name and emoji
* Emoji must be from your server
* Name must be 2-10 characters
* Emoji must be a valid Discord emoji

### **Add Balance**

```
/add-balance <amount> <user> [balance_type] [private_message]
```

* Adds balance to a user's account
* Amount: 1 to 100,000,000
* Balance type: Checking (default) or Cash
* Private message option for discretion

### **Remove Balance**

```
/remove-balance <amount> <user> [balance_type]
```

* Removes balance from a user's account
* Amount: 1 to 100,000,000
* Balance type: Checking (default) or Cash

### **Reset All Balance**

```
/reset-all-balance <balance_type>
```

* Resets all users' balances to zero
* Balance type: Cash Balance, Checking Balance, or Both
* Requires confirmation
* Cooldown: 5 uses per month
* Requires Administrator permission

### **Get All Balance**

```
/get-all-balance
```

* Downloads a CSV file containing all users' balances
* Cooldown: 30 uses per month
* Requires Manage Server permission

## <mark style="color:yellow;">For Community Members</mark>

### Check Balance

```
/balance [user] [private_message]
```

* View your own or another user's balance
* Shows both Checking and Cash balances
* Private message option for discretion
* Includes withdraw button for your own balance

### Balance Types

#### *Checking Account*

* *Primary balance for earned income*
* *All rewards and earnings go here*
* *Must be withdrawn to Cash to spend*
* *Used for investments and other features*

#### *Cash Balance*

* *Spendable balance*
* *Can be used for purchases*
* *Can be invested to earn more*
* *Withdrawn from Checking account*

### Leaderboard

```
/leaderboard [balance_type] [page]
```

* View server's wealthiest members
* Balance type: Checking (default) or Cash
* Shows top 10 users per page
* Cooldown: 10 uses per hour

### Best Practices for Server Admins

1. Set an appropriate currency name and emoji that fits your server's theme
2. Use private messages for sensitive balance operations
3. Be cautious with balance resets and large balance modifications
4. Regularly monitor the economy using the leaderboard
5. Use the CSV export feature for detailed economic analysis
6. Consider implementing additional features like:
   * Regular economic events
   * Investment opportunities
   * Trading systems
   * Tax systems
