Economy

Build an engaging economy system to keep your community active and rewarded!

Overview

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.

---

Table of Contents

1. Features

2. Installation

3. How It Works

4. Commands

---

Features

Earning Coins

Members can earn coins through 20+ unique activities:

Social Activities:

• Message Sending - Earn coins for staying active in chat

• Voice Calls - Get rewarded for every minute in voice channels

• Server Invites - Bonus coins for bringing new members

• Suggestions & Polls - Earn for voting and having suggestions approved

• Birthdays - Special birthday coin rewards

Progression Activities:

• Level Ups - Bonus coins when ranking up

• Starboard Messages - Rewards for popular messages

• Daily & Weekly Claims - Regular income with streak bonuses

• Quests - Complete daily and weekly challenges

Interactive Activities:

• Games - Play guess-the-number, hangman, RPS, trivia, and more

• Game Wagers - Bet coins on games for multiplied rewards

• Jobs - Take on roles like Fisher to earn passive income

• Counting Game - Participate in the counting channel

Economy Activities:

• Begging - Try your luck begging for coins

• Robbing - Steal from other members (with risks!)

• Spying - Check other users' wealth

---

Spending Coins

Built-in Shop System:

• Roles - Purchase exclusive or VIP roles

• Boosters - Buy coin multipliers for increased earnings

• Lootboxes - Try your luck with random rewards

• Custom Messages - Send messages to specific channels

• Tebex Coupons - Redeem real store discounts

• Configurable Items - 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

---

Engagement Features

• Streak Bonuses - Daily and weekly claim streaks with increasing rewards

• Game Wagers - Configurable betting system with multipliers

• Banking System - Deposit, withdraw, and protect your coins

• Cooldown Management - Prevent spam and balance the economy

• Punishment System - Automatic coin deduction for rule violations

---

Installation

This is a premium addon! You must purchase this addon separately and have a valid license.

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

---

How It Works

1. Members Earn Coins

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

2. Coins Are Stored Safely

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

3. Members Spend in the Shop

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.)

4. Engage with Activities

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

---

Commands

User Commands

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

---

Admin Commands

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

---

Getting Started

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

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