📈Role Promotions
Role Promotions automatically grants players a Discord role based on their current MMR, and swaps it out for a different role as their MMR crosses the thresholds you set - like a competitive rank ladder, but using your server's own roles.
Key Features
Ladder model: a player holds exactly one promotion role at a time. Crossing into a new bracket removes the old role and grants the new one - roles never stack up.
Per-queue or Global brackets: set thresholds for one specific queue channel, or apply them across every queue for a game at once.
Announcement channel: optionally post every promotion/demotion to a channel of your choice.
Player DMs: optionally DM players directly when they're promoted or demoted.
Always up to date: brackets are re-checked automatically after every game, admin MMR adjustment, MMR reset, and even when a server switches between Flat and Dynamic MMR modes - so a role never goes stale.
How it Works
Open the promotions manager with
/mmr promotions manage. This shows every bracket currently configured for your server.
Select Add Promotion, then choose the game the bracket applies to.
Choose a specific queue channel, or Global to apply the bracket across every queue for that game.
Pick the Discord role to grant, then set the minimum (and optionally maximum) MMR for that bracket. Leave the maximum blank for an open-ended top bracket.
Repeat for as many brackets as you'd like (up to 10 per queue) to build out a full ladder - e.g. Bronze, Silver, Gold.
Set an announcement channel with
/mmr promotions channel, and turn player DMs on or off with/mmr promotions dm_players.
Once configured, promotions happen automatically - no further action needed. The next time a player's MMR crosses a bracket boundary, their role updates on its own.
Make sure the bot's role is positioned above any promotion roles in your server's role list, or it won't have permission to grant/remove them.
See the full command reference in MMR commands.
Last updated