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. The first match wins:

  1. Server-wide stats - If /leaderboardconfig sharedstats serverwide is enabled, all queues share the same stats, and the per-queue settings below are ignored entirely
  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
Server-wide stats override everything

While server-wide stats are enabled, /leaderboardconfig sharedstats set is blocked and will refuse to run — you have to disable server-wide stats first. Disabling them re-points every queue at rule 2 or 3, which can make an established leaderboard read as empty until you link it back. See Stats Linking and Migration for the safe step-by-step sequence.

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 a queue is relying on rule 3 and you rename it from QueueOne to QueueTwo, the stats won't automatically transfer since they're stored under QueueOne. See the migration section below. (If the queue has a custom stats name set, or server-wide stats are on, renaming doesn't affect its stats at all.)

Migrating Stats​

Renaming a Queue (Preserving Stats)​

To rename a queue without losing stats:

  1. Change the name: /queuename name:New Name
  2. Link to old stats: /leaderboardconfig sharedstats set name:Old Name

Moving or Copying Stats​

Transfer stats between stats names (not between queues — these commands act on the stored name):

  • /managestats move old_name:A new_name:B - Move stats from one name to another (original is cleared)
  • /managestats copy old_name:A new_name:B - Copy stats to another name (original is preserved)
Destinations are overwritten

Both commands overwrite anything already stored under new_name, and neither can be undone. Test with copy before using move.

Changing how queues are linked

For splitting a shared leaderboard into separate ones, merging queues, or safely turning server-wide stats on and off, see Stats Linking and Migration.

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!