Permissions
Control which Discord roles can use admin commands
How It Works
- Discord Administrators always have access to all commands — no setup needed
- For everyone else, you assign permissions to Discord roles
- A member with any role that has a permission can use the corresponding commands
Permission Levels
There are three permission levels, each covering a group of commands.
Report Results
Allows reporting and managing match outcomes.
| Command | Description |
|---|---|
| /win | Report match winner |
| /cancel-match | Cancel an active match |
| /void-match | Void a completed match and reverse ELO |
| /overturn-match | Flip the winner of a completed match |
| /unvoid-match | Restore a voided match and reapply ELO |
| /mvp | Award MVP bonus to a player |
| /revoke-mvp | Revoke an MVP award and reverse bonus ELO |
Good for trusted moderators who watch matches and report results.
Manage Players
Allows managing player registrations, ELO, and bans.
| Command | Description |
|---|---|
| /set-elo | Manually set a player's ELO |
| /rename-player | Set a custom display name for a player |
| /remove-player | Unregister a player |
| /ban-player | Ban a player from queues |
| /unban-player | Remove a player's ban |
| /ban-status | Check a player's ban status |
Good for moderators who handle player issues and disputes.
Manage Queues
Allows creating and configuring queues, maps, seasons, and LFG.
| Command | Description |
|---|---|
| /setup | Create a queue in a channel |
| /clear-queue | Remove all players from a queue |
| /set-maps | Configure the map pool |
| /set-map-mode | Set map selection mode |
| /set-mvp-bonus | Set MVP bonus amount |
| /season-reset | Reset the current season |
| /lfg-setup | Configure LFG settings |
Good for server owners and senior mods who manage the competitive setup.
Setting Up Permissions
Via the Dashboard (Recommended)
- Go to gotnext.bot and log in
- Select your server
- Open the Solo Queue module
- Click the Permissions tab
- Click Sync Roles to pull your Discord roles
- Toggle the permissions you want for each role
- Click Save
The permissions tab shows a grid of your Discord roles vs. the three permission types. Toggle the checkboxes to grant or revoke access.
Example Setup
| Role | Report Results | Manage Players | Manage Queues |
|---|---|---|---|
| @Admin | Always has full access (automatic) | ||
| @Moderator | Yes | Yes | No |
| @Match Reporter | Yes | No | No |
| @Everyone | No | No | No |
In this example:
- Admins can do everything (automatic)
- Moderators can report results and manage players
- Match Reporters can only report match results
- Regular members can only use player commands (/register, /join, etc.)
Tips
- Start simple — Give your mod team Report Results permission and keep Manage Queues for admins only
- Match Reporters — If you have a lot of matches, create a "Reporter" role with just Report Results so trusted members can help report
- Separate concerns — You don't have to give all three permissions to the same role. A mod who reports results doesn't necessarily need to manage the queue setup.
- Discord Admin = full access — Anyone with the Discord Administrator permission bypasses all permission checks. You don't need to configure anything for them.
Bot Role Hierarchy
The bot needs its role to be above player and moderator roles in your server's role list. This is required for two features:
- Nickname updates — The bot updates player nicknames to show their ELO (e.g.,
[1350] PlayerName). It can only change nicknames of users whose highest role is below the bot's role. - Rank tier roles — The bot assigns and removes rank tier roles automatically. It can only manage roles that are below the bot's role.
How to Fix
- Go to Server Settings > Roles
- Find the GotNext Bot role
- Drag it above all player and moderator roles
Note: The server owner's nickname can never be changed by any bot — this is a Discord limitation regardless of role position.
Two-Factor Authentication (2FA)
If your server has "Require 2FA for moderator actions" enabled (Server Settings > Safety Setup), the bot owner's Discord account must also have 2FA enabled. Without it, the bot cannot manage roles or nicknames and operations will silently fail.
To enable 2FA: User Settings > My Account > Enable Two-Factor Auth.
Re-inviting the Bot
If the bot is missing permissions, you can re-invite it from the dashboard. Go to Manage Servers and click the Re-invite button on your server card. This opens the invite link with the correct permissions pre-selected. Re-inviting updates the bot's permissions without removing it from the server.