# MMR commands
#### :crown: **Admin only commands**
#### :bulb: **General command for everyone**
**Required** parameters will be in \[Square brackets]
**Optional** parameters will be in (Curly brackets)
***
### :crown: Enable or Disable MMR
```
/mmr toggle [mmr_type]
```
Choose from three modes:
| Option | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disabled** | Turns MMR off entirely. No skill-based matchmaking. |
| **Dynamic (Standard)** | The default skill-based matchmaking system. MMR adjusts based on the skill gap between teams — bigger upsets yield bigger swings. |
| **Flat** | A simple fixed-point system. Winners always gain a set number of points; losers always lose a set number of points, regardless of team balance. |
You can tell which mode is active by the label shown in the queue embed: **Dynamic MMR: ON** or **Flat MMR: ON**.
#### Flat MMR configuration
When you select **Flat**, a configuration modal opens where you set three values:
| Field | Description | Default |
| ---------------- | -------------------------------------------------------- | ------- |
| **Win Points** | MMR awarded to every player on the winning team | 30 |
| **Loss Points** | MMR deducted from every player on the losing team | 30 |
| **Starting MMR** | MMR new players begin with (and return to after a reset) | 150 |
{% hint style="info" %}
You can re-run `/mmr toggle Flat` at any time to update these values. The modal will pre-populate with your current settings.
{% endhint %}
Please join our [Support server](https://discord.gg/rT9cZD3tkA) if you need help deciding which MMR mode is right for your server.
***
## :crown: **Add or remove MMR for players**
```
/mmr add [member] [amount] [game] (queue_channel)
/mmr remove [member] [amount] [game] (queue_channel)
```
Manually increase or decrease the Matchmaking Rating (MMR) for specific players by a fixed amount.
{% hint style="info" %}
**Dynamic MMR note:** Manually adjusting a player’s MMR without changing their accuracy (sigma) can cause large MMR swings in subsequent games. Adjust gradually to avoid unbalanced matchmaking.
**Flat MMR note:** There is no accuracy factor in flat mode — adjustments are straightforward and take effect immediately with no side effects.
{% endhint %}
If you have set up a [unique leaderboard](https://docs.inhousequeue.xyz/docs/quick-start/leaderboards-explained#creating-a-unique-leaderboard), you can add or remove MMR for a player in a specific (`queue_channel`) by selecting it.
***
## :crown: Set a player’s MMR
```
/mmr set [member] [new_mmr] [game] (queue_channel)
```
Manually set a player to an exact MMR value using this command.
{% hint style="info" %}
Players’ MMR cannot be set to above 9999, or below 0.
**Dynamic MMR note:** Setting a player’s MMR without adjusting their accuracy (sigma) can result in unexpected MMR gains or losses. Use this command carefully.
**Flat MMR note:** There is no accuracy factor — setting MMR is straightforward.
{% endhint %}
***
## :crown: Show player MMRs
```
/mmr show [preference]
```
Enable this command to display players' current MMR next to their names in the queue.
{% hint style="info" %}
If you play more than one game on your server (**LoL, Overwatch, Valorant, or Custom**), the MMR shown will be from your most **recent game** played.
{% endhint %}
***
## :crown: Adjust starting MMR
```
/mmr set_starting
```
By default, all players start at **833 MMR**. As players complete games, they build data for more consistent and balanced matchmaking. However, if skill levels vary significantly, adjusting the starting MMR can help provide more realistic matchmaking.
This doesn't change the players **current** MMR. This command determines what MMR players start with when MMR is [reset,](https://docs.inhousequeue.xyz/docs/reset-commands#crown-reset-mmr) or they've never played a Match.
### How it works:
### Important note
A player’s **personal starting MMR** always beats any starting MMR that comes from their Discord roles.
**Example 1**
1. Player 1 has a personal starting MMR of **1200** and also holds a role with a starting MMR of **900**. When the system resets, Player 1 will start at **1200**.
Henry has personal starting MMR of 1200, and also has the @Silver role. Henry's MMR will always go back to his personal starting MMR.
***
2. If a player has multiple roles, each with its own starting MMR, the system uses the role that sits higher in the Discord role hierarchy.
**Example 2**
Player 1 has @Silver (1000 MMR) above @Bronze (800 MMR) in the server’s role list. On reset, Player 1 will start at 1000 MMR (@Silver).
Silver is above Bronze in this Discord. If Player has both roles, they are reset to the Silver starting MMR
***
**Instructions**
1. After running the command select the Game you'd like to apply the MMR changes for.
2. Select the Queue channel this should apply for. 3. If you pick a [Unique queue](https://docs.inhousequeue.xyz/docs/quick-start/leaderboards-explained#creating-a-unique-leaderboard), the MMR applies only to that queue. 4. If you pick a [🌐 Global queue](https://docs.inhousequeue.xyz/docs/quick-start/leaderboards-explained#-leaderboards-explained), the MMR applies to every queue that is marked 🌐 Global in your server.
3. Select whether you want the Starting MMR to apply to Individuals, or everyone who has a specific Discord role.
4. In this example, we're going with a Discord role.
5. Enter the MMR amount you want. 6. You cannot set a players starting MMR Lower than 100, and Higher than 9000.
6. When you're done, you will get a confirmation, and another Embed will be sent incase you'd like to continue adding more roles.
