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

  • Coins: Server-specific currency earned through activities
  • Balance Tracking: Individual user balances with database persistence
  • Transfer System: Send coins to other users
  • Daily Rewards: Claim daily coins with streak bonuses

Gambling Games

  • Blackjack: Classic card game with betting
  • Slots: Slot machine with multiple bet options
  • Coin Flip: Simple heads/tails betting
  • Dice Rolling: Various dice games with odds

Economy Management

  • Shop System: Purchase roles, perks, and items
  • Perk Purchases: Buy temporary or permanent benefits
  • Role Rewards: Earn roles through coin spending
  • Taxation: Optional tax on transactions

Leaderboards & Stats

  • Top Balances: Richest users in the server
  • Gambling Stats: Track wins, losses, and streaks
  • Server Rankings: Competitive leaderboards
  • Personal Stats: Individual performance metrics

Admin Controls

  • Balance Management: Add/remove coins from users
  • Economy Reset: Reset all balances if needed
  • Shop Configuration: Manage available items and prices
  • Audit Logging: Track all economic transactions

Commands

Command Description Permissions
/economy balance Check your coin balance None
/economy daily Claim daily reward None
/economy transfer <user> <amount> Send coins to another user None
/economy blackjack <bet> Play blackjack None
/economy slots <bet> Play slots None
/economy shop View available items None
/economy buy <item> Purchase an item None
/economy leaderboard View top balances None

Configuration

  • Enabled: Toggle the economy system
  • Daily Amount: Base daily reward amount
  • Streak Bonus: Extra coins for consecutive daily claims
  • Shop Items: Configurable items with prices and effects
  • Tax Rate: Optional transaction tax
  • Min/Max Bets: Gambling limits

Game Rules

Blackjack

  • Standard rules with dealer standing on 17
  • Blackjack pays 3:2
  • Push returns original bet
  • Insurance and splitting not implemented

Slots

  • Multiple paylines with different multipliers
  • Jackpot system for rare combinations
  • Variable bet amounts

Anti-Abuse Measures

  • 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