Skip to main content

MMR System and Ranks

In NeatQueue, MMR (Match Making Rating) is the player's skill rating. There are extensive commands to customize how MMR works in your queue.

Configuring MMR Changes​

Win/Loss MMR​

Use /mmr change set to customize how much MMR players gain or lose. The amount you set is the average change for wins and losses.

MMR Variance

If you notice some players gaining/losing more MMR than others, this is due to MMR variance.

MMR variance refers to the variability in rating changes based on team MMR differences. A lower variance value results in higher ranges of MMR changes, making the system more sensitive to differences in players' MMRs.

Example: With default variance of 1600, a winner with 1100 MMR beating a player with 1000 MMR would see an adjustment of 46.4 MMR.

Adjust variance using: /mmr change variance

MMR Calculator​

To calculate expected MMR changes, use the MMR calculator.

Static MMR Mode​

If you prefer consistent MMR changes regardless of team balance, enable static mode in the /mmr change set command. This makes the MMR change ALWAYS the same amount, ignoring variance.

MMR Management Commands​

Modifying Player MMR​

  • /add mmr - Add or subtract MMR (use negative numbers to subtract)
  • /set mmr - Set someone's or everyone's MMR to a specific value

Starting MMR​

  • /startingmmr set - Change the starting MMR for new players (default: 1000)
note

Starting MMR changes only apply to new players. Existing players keep their current MMR unless you reset stats.

MMR Floor​

By default, players can have negative MMR. Set a minimum with:

  • /mmr minimum - Prevent MMR from dropping below a value (e.g., set to 0)

MMR Decay​

Inactive players can lose MMR over time. Configure this with:

  • /mmr decay - Set up automatic MMR reduction for inactive players

Displaying MMR in Names​

Enable MMR Display​

Show player MMR next to their Discord nickname using:

  • /ratinginname toggle - Enable/disable MMR in names

Format MMR Display​

Use /ratinginname format to customize how MMR appears:

Examples:

  • DonSoap - [1200]

    • Format: - [$]
    • Location: suffix

  • (1200) DonSoap

    • Format: ($)
    • Location: prefix

Rank System​

Create a rank system similar to competitive games like CS:GO, Rainbow Six, or Valorant using automatic role assignment based on MMR.

Setting Up Ranks​

Use /autoroles mmr set to create MMR-based ranks:

  1. Create a Discord role (e.g., "Silver", "Gold", "Platinum")
  2. Run /autoroles mmr set
  3. Select the role and define the MMR range (e.g., 1100-1200 for Silver)
  4. Repeat for each rank tier

Example rank structure:

Example rank system showing role hierarchy with MMR ranges

Sample Ranks:

  • Bronze: 0-1000 MMR
  • Silver: 1000-1200 MMR
  • Gold: 1200-1400 MMR
  • Platinum: 1400-1600 MMR
  • Diamond: 1600-1800 MMR
  • Master: 1800+ MMR

Role-Based Queue Requirements​

Create exclusive queues for specific ranks:

  1. Remove the default @everyone role requirement: /rolerequirement remove
  2. Add your rank role requirement: /rolerequirement add

Now only players with that role (MMR range) can join the queue.

Advanced Role Configuration​

Explore the /autoroles command group for additional features:

  • Multiple role requirements
  • Leaderboard position-based roles
  • Custom role triggers
  • Role management automation
View Configuration

Use /info to view your complete queue configuration, including all role and MMR settings.

Best Practices​

Balanced MMR Settings​

For most competitive communities:

  • Starting MMR: 1000
  • Win/Loss: ±25-30 with variance enabled
  • Minimum MMR: 0 (or 100 to prevent negative values)
  • MMR Decay: 7-14 days of inactivity

Rank Ranges​

Create overlapping or distinct ranges based on your community:

  • Tight ranges (200 MMR) for more ranks and frequent progression
  • Wide ranges (400+ MMR) for fewer ranks and meaningful divisions

Testing Your System​

  1. Use /test mode to simulate matches
  2. Manually adjust MMR with /add mmr to test rank transitions
  3. Monitor the /leaderboard to ensure proper distribution
  4. Adjust variance if MMR changes feel too extreme or too subtle