Server Leaderboards & Rankings

Overview

M4T3's leaderboard system tracks user wealth and activities across your server, creating competitive rankings based on total coins (wallet + bank balance), game performance, and various achievements.

Main Leaderboard Command

/community leaderboard

What it shows:

• Total wealth ranking (wallet + bank combined)
• Your current position in the server
• Top 3 users with special medal display (🥇🥈🥉)
• Interactive pagination for large servers
• Real-time position tracking

Example Display:

🏆 Top Winners
🥇 **JohnDoe** - 125,450 coins
🥈 **GameMaster** - 98,200 coins  
🥉 **CoinCollector** - 87,350 coins

📊 Rankings
4. PlayerFour - **65,800** coins
5. RichUser - **52,100** coins
6. YourUsername - **45,200** coins
...

Page 1 of 5 | Your Rank: #6 of 67 users

Navigation Features:

• ⏮️ First page
• ◀️ Previous page
• ▶️ Next page
• ⏭️ Last page
• 15 users per page
• 5-minute interaction timeout

Leaderboard Requirements

Getting Started

1. Join the Economy: Use /community daily to create your account
2. Active Participation: Must have coins in wallet or bank
3. Server Membership: Only counts coins earned on that specific server

How Rankings Work

• Total Wealth = Wallet Balance + Bank Balance
• Tie-breaking: Alphabetical by user ID for consistency
• Real-time Updates: Rankings refresh as users earn/spend coins
• Active Users Only: Only shows users with economy accounts

Game-Specific Leaderboards

Death Roll Statistics (/games deathroll-stats leaderboard:true)

Tracks:

• Games won vs games lost
• Win rate percentage
• Total profit/loss in coins
• Current win/loss streak
• Games played overall

Example Display:

🥇 ProGamer
🏆 Wins: 45 | 💀 Losses: 12
📊 Win Rate: 78.9% | 🎮 Total Games: 57
💰 Profit: +125,400 coins
🔥 Current Streak: +8

🥈 SkillPlayer
🏆 Wins: 38 | 💀 Losses: 15
📊 Win Rate: 71.7% | 🎮 Total Games: 53
💰 Profit: +98,200 coins
🔥 Current Streak: +3

Leaderboard Seasons

Active Leaderboards

• Each server can have "seasons" with fresh starts
• Starting Balance: Configurable (default: 1,000 coins)
• Season Reset: Clears all balances and inventories
• Fair Competition: Everyone starts equal

Joining New Seasons

When a new leaderboard season starts:

1. Use /community start to join
2. Your balance resets to starting amount
3. Fish and shop inventories are cleared
4. Previous season data is preserved

Dashboard Management

Web Interface Features

Access: Visit dashboard.m4t3.xyz → Select Server → Leaderboards

Configuration Options:

• Season Management: Start/end leaderboard periods
• Starting Balance: Set initial coins for new players
• Game Settings: Enable/disable specific games
• Multipliers: Bonus rates for daily rewards
• Statistics: View detailed server economy data

Admin Tools

Required Permission: Manage Guild

Commands:

• Balance Management: Award or remove coins
• Season Control: Start new competitive periods
• Statistics Export: Download leaderboard data

Competitive Features

Achievement Integration

• First Leaderboard: Join your first season
• Top Performer: Reach top 10 in wealth ranking
• Game Master: Excel in multiple game types
• Streak Specialist: Maintain winning streaks

Social Elements

• Public Rankings: All members can view positions
• Friendly Competition: Compare with friends
• Progress Tracking: Watch your rank improve
• Community Events: Server-wide challenges

Tips for Climbing Rankings

Earning Strategies

1. Daily Claims: Never miss /community daily (up to 7-day streaks)
2. Smart Banking: Use /community bank deposit to secure earnings
3. Game Selection: Focus on games you're skilled at
4. Risk Management: Don't bet your entire balance
5. Achievement Hunting: Complete tasks for bonus rewards

Common Mistakes

• All-in Betting: Risking everything in one game
• Ignoring Bank: Keeping all coins in wallet (robbery risk)
• Missing Dailies: Breaking streak multipliers
• Wrong Game Choice: Playing games you consistently lose

Troubleshooting

"No Account Found"

Solution: Use /community daily to create your economy account

"Not on Leaderboard"

Causes:

• Zero balance (wallet + bank = 0)
• Not joined current season
• Server has no active leaderboard

Fix:

• Earn some coins through games or daily claims
• Use /community start if season is active

Leaderboard Not Loading

Check:

• Bot permissions (Embed Links, Send Messages)
• Server has economy enabled
• Your account exists (/community balance)

Ranking Seems Wrong

Note: Rankings update in real-time but may have brief delays during high server load. Total coins = wallet + bank balance.

Advanced Features

Pagination System

• Efficient Loading: Only loads needed pages
• Member Lookup: Shows current Discord usernames
• Batch Processing: Handles large servers smoothly
• Cache Optimization: Fast response times

Data Accuracy

• Real-time Calculations: Fresh data on every view
• Tie-breaking Logic: Consistent ordering
• Cross-validation: Multiple ranking methods
• Audit Trails: Complete transaction history

The leaderboard system encourages healthy competition while providing comprehensive tracking of your server's economy and gaming activities. Use it to motivate members, track progress, and build an engaging community experience!