Skip to main content

Leaderboard and Stats

This comprehensive guide covers everything you need to know about player statistics, leaderboards, and stats management in NeatQueue.

Understanding Stats Linking​

In NeatQueue, player stats are stored via a unique name. This system allows you to either link queues together for sharing stats or keep them separate across different game types.

Default Behavior

By default, all stats are tied to the queue name. If you create multiple queues with the same name, they will automatically share stats. If queues have different names, they'll have separate stats.

Stats Priority System​

The system determines which stats to use based on this priority order:

  1. Server-wide stats - If /leaderboardconfig sharedstats serverwide is enabled, all queues share the same stats
  2. Custom stats name - If /leaderboardconfig sharedstats set is configured, that unique name is used for the queue
  3. Queue name (default) - The queue's name is used as the unique identifier

Example Scenarios​

Separate game stats:

  • Rocket League Queue (name: "Rocket League")
  • Overwatch Queue (name: "Overwatch")
  • Each maintains independent player stats

Shared stats across queues:

  • Ranked 5v5 Queue → Set shared stats: "Competitive"
  • Casual 5v5 Queue → Set shared stats: "Competitive"
  • Both queues share the same player stats
Changing Queue Names

If you rename a queue from QueueOne to QueueTwo, the stats won't automatically transfer since they're stored under QueueOne. See the migration section below.

Migrating Stats​

Renaming a Queue (Preserving Stats)​

To rename a queue without losing stats:

  1. Change the name: /queuename new_name
  2. Link to old stats: /leaderboardconfig sharedstats set: "old queue name"

Moving or Copying Stats​

Transfer stats between queues:

  • /managestats move - Move stats from one queue to another (original is cleared)
  • /managestats copy - Copy stats to another queue (original is preserved)

Resetting Stats​

Reset player statistics with these commands:

  • /managestats reset all - Reset all player stats for the queue
  • /managestats reset player - Reset a specific player's stats
  • /managestats reset mmr - Reset all MMR values only (preserves W/L records)
Irreversible Action

Stats resets are permanent and cannot be undone. Make sure you want to reset before running these commands!

Displaying the Leaderboard​

Basic Leaderboard​

Show the leaderboard by running /leaderboard in any channel with a queue.

Voting Requirement

To access the leaderboard feature, you need to vote on top.gg. After voting, type @NeatQueue i voted in your Discord server.

Linking Queues to Other Channels​

If you want the leaderboard in a channel without a queue:

  1. Go to the desired channel
  2. Run /link
  3. Select the channel where your queue is located
  4. Now you can run /leaderboard in this channel

Leaderboard Requirements​

By default, players need at least 1 game played to appear on the leaderboard.

Change this requirement with:

/leaderboardconfig requiredgames [number]

Example use cases:

  • Set to 5 to only show active players
  • Set to 0 to show everyone (including 0 games)
  • Set to 10 to create a "competitive" leaderboard

Player Stats​

Viewing Individual Stats​

Players can check their own stats with /stats.

Cooldown

The /stats command has a cooldown to prevent server overload, since generating stat images is resource-intensive. The cooldown cannot be modified.

Stats Information Displayed​

Individual stats typically show:

  • Win/Loss record
  • Current MMR
  • MMR history/progression
  • Rank (if configured)
  • Games played
  • Win rate percentage
  • Recent match history

Multiple Queues​

Separate Leaderboards​

If you have multiple queues with independent stats, create a separate channel and link each one:

  1. Create Channel #1 (e.g., #rocket-league-leaderboard)

    • Run /link → Select Rocket League queue channel
    • Run /leaderboard

  2. Create Channel #2 (e.g., #overwatch-leaderboard)

    • Run /link → Select Overwatch queue channel
    • Run /leaderboard
warning

You cannot display multiple leaderboards in a single channel. Each leaderboard needs its own channel or must share stats.

Leaderboard Customization​

Display Options​

Customize your leaderboard with:

  • /leaderboardconfig - Various display and formatting options
  • Rank display settings
  • Stats shown on leaderboard
  • Leaderboard size (top 10, 25, 50, etc.)

Auto-Update​

Consider using a dedicated leaderboard channel that updates regularly:

  • Post the leaderboard with /leaderboard
  • Pin the message
  • Update periodically (manual or via scheduled command)

Best Practices​

Stats Management​

  1. Decide early - Choose your stats linking strategy before launching
  2. Communicate resets - Always announce stat resets to your community
  3. Backup important data - Take screenshots of leaderboards before major resets
  4. Test migrations - Use /managestats copy to test before using move

Leaderboard Placement​

  1. Dedicated channels - Create separate channels for leaderboards
  2. Clear labeling - Name channels clearly (e.g., #ranked-leaderboard)
  3. Pin instructions - Pin a message explaining how to check stats
  4. Regular updates - Keep leaderboards current (daily or weekly updates)

Community Engagement​

  • Announce top performers weekly
  • Create seasonal leaderboards with periodic resets
  • Reward top players with special roles (see MMR and Ranks)
  • Share milestone achievements (first to 2000 MMR, etc.)
Pro Tip

Use /config save after setting up your stats configuration so you can easily restore it if needed!