# Economy

## <mark style="color:blue;">Overview</mark>

Tired of a quiet server? The **Economy** addon is the perfect solution to get your members interacting, competing, and sticking around for the long haul. This comprehensive virtual currency system rewards members for the activities they already do - and encourages them to do more.

***

## <mark style="color:blue;">Table of Contents</mark>

1. **Features**
2. **Installation**
3. **How It Works**
4. **Commands**

***

## <mark style="color:blue;">Features</mark>

### <mark style="color:yellow;">Earning Coins</mark>

Members can earn coins through **20+ unique activities**:

**Social Activities:**

* <mark style="color:red;">**Message Sending**</mark> - Earn coins for staying active in chat
* <mark style="color:red;">**Voice Calls**</mark> - Get rewarded for every minute in voice channels
* <mark style="color:red;">**Server Invites**</mark> - Bonus coins for bringing new members
* <mark style="color:red;">**Suggestions & Polls**</mark> - Earn for voting and having suggestions approved
* <mark style="color:red;">**Birthdays**</mark> - Special birthday coin rewards

**Progression Activities:**

* <mark style="color:red;">**Level Ups**</mark> - Bonus coins when ranking up
* <mark style="color:red;">**Starboard Messages**</mark> - Rewards for popular messages
* <mark style="color:red;">**Daily & Weekly Claims**</mark> - Regular income with streak bonuses
* <mark style="color:red;">**Quests**</mark> - Complete daily and weekly challenges

**Interactive Activities:**

* <mark style="color:red;">**Games**</mark> - Play guess-the-number, hangman, RPS, trivia, and more
* <mark style="color:red;">**Game Wagers**</mark> - Bet coins on games for multiplied rewards
* <mark style="color:red;">**Jobs**</mark> - Take on roles like Fisher to earn passive income
* <mark style="color:red;">**Counting Game**</mark> - Participate in the counting channel

**Economy Activities:**

* <mark style="color:red;">**Begging**</mark> - Try your luck begging for coins
* <mark style="color:red;">**Robbing**</mark> - Steal from other members (with risks!)
* <mark style="color:red;">**Spying**</mark> - Check other users' wealth

***

### <mark style="color:yellow;">Spending Coins</mark>

**Built-in Shop System:**

* <mark style="color:red;">**Roles**</mark> - Purchase exclusive or VIP roles
* <mark style="color:red;">**Boosters**</mark> - Buy coin multipliers for increased earnings
* <mark style="color:red;">**Lootboxes**</mark> - Try your luck with random rewards
* <mark style="color:red;">**Custom Messages**</mark> - Send messages to specific channels
* <mark style="color:red;">**Tebex Coupons**</mark> - Redeem real store discounts
* <mark style="color:red;">**Configurable Items**</mark> - Create unlimited custom shop items

**Advanced Features:**

* Rank-locked items (require specific levels to purchase)
* One-time purchase restrictions
* Multiple reward types per item
* Custom emojis and descriptions

***

### <mark style="color:yellow;">Engagement Features</mark>

* <mark style="color:red;">**Streak Bonuses**</mark> - Daily and weekly claim streaks with increasing rewards
* <mark style="color:red;">**Game Wagers**</mark> - Configurable betting system with multipliers
* <mark style="color:red;">**Banking System**</mark> - Deposit, withdraw, and protect your coins
* <mark style="color:red;">**Cooldown Management**</mark> - Prevent spam and balance the economy
* <mark style="color:red;">**Punishment System**</mark> - Automatic coin deduction for rule violations

***

## <mark style="color:blue;">Installation</mark>

{% hint style="warning" %}
**This is a premium addon!** You must purchase this addon separately and have a valid license.
{% endhint %}

1. Download the Economy addon files from your purchase
2. Extract all files into the `plugins/` folder of your Athena Bot installation
3. Restart your bot to load the addon
4. Configure the addon using the `economy.json` file in your `configuration/` folder

***

## <mark style="color:blue;">How It Works</mark>

### <mark style="color:yellow;">1. Members Earn Coins</mark>

Your members automatically earn coins by participating in server activities. You control exactly how many coins each activity grants through the configuration file.

### <mark style="color:yellow;">2. Coins Are Stored Safely</mark>

Members can use the banking system to:

* **Deposit** coins for safekeeping (protected from robbery)
* **Withdraw** coins when needed
* **Spy** on other members to see their wealth
* View their total **balance** and **rank**

### <mark style="color:yellow;">3. Members Spend in the Shop</mark>

Use the `/shop` command to browse and purchase items. The shop supports:

* Multiple items with custom emojis and descriptions
* Rank requirements to unlock premium items
* One-time or unlimited purchase items
* Automatic reward delivery (roles, boosters, etc.)

### <mark style="color:yellow;">4. Engage with Activities</mark>

Members can increase their earnings through:

* **Daily/Weekly Claims** with streak bonuses
* **Game Wagers** for multiplied rewards
* **Jobs** for alternative income sources
* **Quests** for bonus challenges
* **Boosters** for temporary coin multipliers

***

## <mark style="color:blue;">Commands</mark>

### <mark style="color:yellow;">User Commands</mark>

**Banking & Balance:**

* `/bank info` - View your bank account details
* `/bank deposit <amount>` - Store coins in your bank
* `/bank withdraw <amount>` - Take coins from your bank
* `/bank spy <user>` - Check another user's wallet (cooldown applies)
* `/coins` - View your current coin balance
* `/rank` - Check your economy rank and leaderboard position

**Earning Coins:**

* `/claim daily` - Claim your daily reward (24h cooldown)
* `/claim weekly` - Claim your weekly reward (7d cooldown)
* `/beg` - Beg for coins (cooldown applies)
* `/rob <user>` - Attempt to steal coins from another user (cooldown applies)
* `/job fisher` - Start fishing to earn coins
* `/quests daily` - View and track daily quests
* `/quests weekly` - View and track weekly quests

**Shop & Items:**

* `/shop` - Browse and purchase items from the shop
* `/lootbox` - Open your lootboxes for random rewards
* `/booster list` - View available and active boosters
* `/booster activate <booster>` - Activate a coin multiplier booster

***

### <mark style="color:yellow;">Admin Commands</mark>

**Economy Management:**

* `/economyadmin coins <user> <amount>` - Add or remove coins from a user
* `/economyadmin karma <user> <amount>` - Adjust a user's karma points
* `/economyadmin lootbox <user> <amount>` - Give lootboxes to a user
* `/economyadmin booster <user> <booster>` - Grant boosters to users
* `/economyadmin reset <user>` - Reset a user's economy data

***

## <mark style="color:blue;">Getting Started</mark>

{% hint style="success" %}
**Quick Start Guide:**

1. Install the addon and restart your bot
2. Configure coin rewards for activities in `economy.json`
3. Set up shop items with roles and rewards
4. Adjust cooldowns and wager limits to your preference
5. Monitor the economy and adjust values as needed
   {% endhint %}

{% hint style="info" %}
**Balancing Tips:**

* Start with lower coin values and increase if needed
* Monitor the richest members to prevent inflation
* Use cooldowns to prevent grinding/exploitation
* Make premium items expensive to maintain value
* Consider one-time purchases for exclusive rewards
* Test the economy in a private channel first
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iynxdev.com/premium-addons/economy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.