Fun Economy Cog

The Fun Economy cog implements a coin-based economy system with gambling games, leaderboards, and various ways to earn and spend coins. It’s designed to add fun and engagement to your server.

Features

Currency System

  • Coin-based economy with per-server balances
  • Individual balance tracking and persistence
  • Transfer coins between users
  • XP-based reward claiming

Gambling Games

  • Blackjack (classic card game with betting)
  • Dragon Tower (climbing game)
  • Dice rolling (d6 and d20 options)
  • Gambling lockout feature (24-hour self-imposed bans)

Leaderboards & Stats

  • Top richest members in server
  • Personal balance and statistics
  • Competitive leaderboards
  • Audit logs for all transactions

Perk System

  • Purchase temporary or permanent perks
  • Perk activation and management
  • Manager oversight of active perks

Admin Controls

  • Add or remove coins from users
  • Gambling lock management
  • Audit logging of all transactions
  • Statistics and reporting

Commands

Economy Commands

| Command | Description | |———|————-| | /eco balance | Check your coin balance | | /eco leaderboard | View richest members in server | | /eco richlist or /eco top | Show top 10 richest members | | /eco claim_rewards | Claim accumulated rewards | | /eco give <member> <amount> | Send coins to another user | | /eco perkshop | Browse and purchase perks | | /eco config | View economy configuration | | /eco help | Display economy system help |

Gambling Commands

| Command | Description | |———|————-| | !blackjack <bet> | Play blackjack card game | | !tower | Climb Dragon Tower climbing game | | !roll [d6 or d20] | Roll dice | | !stopgambling | Lock yourself out of gambling for 24 hours |

Prefix Commands

| Command | Description | |———|————-| | !balance or !bal | Check your coin balance | | !claim | Claim accumulated rewards | | !richlist or !rich or !top | View top richest members | | !give <member> <amount> | Send coins to another user | | !perkshop or !perks or !shop | Browse perks | | !ecoaudit | View economy audit logs | | !startgambling | Enable gambling (manager only) |

Manager Commands

| Command | Description | |———|————-| | /eco_manage list_perks | List available perks | | /eco_manage active_perks | View active perk purchases | | /eco_manage help | Manager commands help |

Configuration

Customize your economy system with these settings:

  • Enabled - Toggle the economy system
  • Log Channel - Where economy activities are logged
  • No XP Roles - Roles excluded from XP gain
  • No XP Channels - Channels excluded from XP reward
  • Min XP Per Message - Minimum XP awarded per message
  • Max XP Per Message - Maximum XP awarded per message
  • Blacklisted Users - Users blocked from economy system

Game Rules

Blackjack

  • Standard blackjack rules with dealer standing on 17
  • Blackjack (21 with two cards) pays 3:2
  • Push results return original bet
  • Insurance and splitting not available

Dragon Tower

  • Climbing game with escalating difficulty
  • Risk vs. reward mechanics
  • Winnings based on tower height reached

Dice Rolling

  • d6: Standard six-sided die
  • d20: Twenty-sided die for higher variance

Anti-Abuse Features

  • Gambling lockout system prevents excessive wagering
  • Users can self-impose 24-hour gambling bans
  • Managers can manually unlock gambling access
  • Audit logging tracks all transactions

  • Configurable bet and balance limits

  • Cooldowns: Prevent spamming of reward commands
  • Rate Limiting: Gambling attempt limits
  • Audit Trails: All transactions logged
  • Balance Validation: Prevent negative balances

Integration

Works with other cogs:

  • Tiers: XP bonuses for economic activity
  • Reputation: Economic rewards for helpful behavior
  • Moderation: Economy-related punishments

Best Practices

  1. Fair Play: Ensure games are balanced and fun
  2. Reward Activity: Use economy to encourage positive behavior
  3. Monitor Abuse: Watch for exploitation attempts
  4. Regular Events: Host economy-based events
  5. Clear Rules: Communicate game rules clearly