Command Reference
All GotNext Bot slash commands organized by category
Jump to section:
Player Commands
Everyone in the server can use these commands.
/register
Register for the server's ELO system. One-time setup — you'll start at the server's starting ELO (default 1200). The bot updates your nickname to show your rating (e.g., [1200] YourName).
/join
Join the queue in the current channel. When enough players are in, a match is automatically created with balanced teams.
| Parameter | Required | Description |
|---|---|---|
| player2 | No | Party member to queue with |
| player3 | No | Party member to queue with |
| player4 | No | Party member to queue with |
| player5 | No | Party member to queue with |
/join player2:@friend1 player3:@friend2Party members must be registered and not banned. Parties are kept on the same team.
/leave
Leave the queue in the current channel. If you're in a party, the entire party is removed.
/queue
See who is currently in the queue for the current channel.
/stats
View ELO stats for yourself or another player. Renders a stats card showing rating, rank tier, record, and more.
| Parameter | Required | Description |
|---|---|---|
| player | No | Player to look up (defaults to yourself) |
/stats player:@someone/leaderboard
View the server's ELO leaderboard. Shows the top players ranked by rating.
/help
Show all available GotNext Bot commands with descriptions.
Queue Management
Requires MANAGE_QUEUES permission or Discord Administrator.
/setup
Set up a solo queue in the current channel. Each channel can have one queue.
| Parameter | Required | Description |
|---|---|---|
| team-size | Yes | Players per team, 1-10 (e.g., 4 for 4v4) |
| mode | Yes | AUTO_MATCH (balanced teams) or SCHOOLYARD_PICK (captains draft) |
| elo-mode | No | ELO (dynamic K-factor) or FLAT (fixed gain/loss). Default: ELO |
| flat-amount | No | ELO per win/loss if using flat mode. Default: 25 |
| show-queue | No | Show who is in the queue. Default: true |
| parties-enabled | No | Allow party queue. Default: true |
| cooldown | No | Minutes before re-queue after a match. Default: 0 (off) |
/setup team-size:4 mode:AUTO_MATCH/setup team-size:2 mode:AUTO_MATCH elo-mode:FLAT flat-amount:15/clear-queue
Remove all players from the queue in the current channel.
/set-maps
Set the map pool for random map selection in the current channel's queue.
| Parameter | Required | Description |
|---|---|---|
| maps | No | Comma-separated map names. Leave empty to clear the pool. Max 50 maps. |
/set-maps maps:Dust 2, Mirage, Inferno, Nuke, OverpassClearing the map pool disables map selection. Setting maps when none exist defaults to RANDOM mode.
/set-map-mode
Set how maps are chosen for matches.
| Parameter | Required | Description |
|---|---|---|
| mode | Yes | RANDOM (auto-select from pool) or VOTE (players vote, 30-second timer) |
Requires a map pool to be set first via /set-maps.
/set-mvp-bonus
Set the bonus ELO awarded when a player receives an MVP.
| Parameter | Required | Description |
|---|---|---|
| amount | Yes | Bonus ELO per MVP. 0 to disable, max 100. |
/set-mvp-bonus amount:10Reporting Results
Requires REPORT_RESULTS permission or Discord Administrator.
/win
Report the winning team for a match.
| Parameter | Required | Description |
|---|---|---|
| match | Yes | Match ID (shown in the match embed) |
| team | Yes | Winning team number (1 or 2) |
/win match:42 team:1/cancel-match
Cancel an active match. No ELO changes are applied.
| Parameter | Required | Description |
|---|---|---|
| match | Yes | Match ID |
/void-match
Void a completed match and reverse all ELO changes. Use this if a result was reported incorrectly and you want to undo it entirely.
| Parameter | Required | Description |
|---|---|---|
| match | Yes | Match ID |
/overturn-match
Flip the winner of a completed match. The original winner's ELO gains are reversed and applied to the other team.
| Parameter | Required | Description |
|---|---|---|
| match | Yes | Match ID |
/mvp
Award MVP to a player in a completed match. Grants bonus ELO if configured via /set-mvp-bonus. Multiple MVPs can be awarded per match.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | The MVP player |
| match | Yes | Match ID |
/mvp player:@clutchPlayer match:42Player Management
Requires MANAGE_PLAYERS permission or Discord Administrator.
/set-elo
Manually set a player's ELO rating.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | Player to update |
| elo | Yes | New ELO rating (0-5000) |
/set-elo player:@someone elo:1500/remove-player
Unregister a player from the ELO system. Removes their ELO prefix from their nickname.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | Player to remove |
/ban-player
Ban a player from all queues on the server.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | Player to ban |
| duration | No | Ban duration in hours. Omit for permanent. Max: 8760 (1 year). |
| reason | No | Reason for the ban (max 500 characters) |
/ban-player player:@troll duration:24 reason:Leaving matches early/unban-player
Remove a player's ban.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | Player to unban |
/ban-status
Check if a player is currently banned and view ban details.
| Parameter | Required | Description |
|---|---|---|
| player | Yes | Player to check |
Season Commands
/season-info
View the current season number, time remaining, and reset type. Available to everyone.
/season-leaderboard
View the final standings from a past season. Available to everyone.
| Parameter | Required | Description |
|---|---|---|
| season | Yes | Season number to view |
/season-leaderboard season:3/season-reset
Immediately end the current season, archive all player stats, and reset ELOs. Requires MANAGE_QUEUES permission.
| Parameter | Required | Description |
|---|---|---|
| confirm | Yes | Must be true to confirm the reset |
/season-reset confirm:trueLFG Commands
/lfg
Create a Looking for Group post. Other players can click "Join" to fill the group. When the group is full, everyone gets pinged. Available to everyone.
| Parameter | Required | Description |
|---|---|---|
| game | Yes | Game name (autocomplete from the server's allowed games list) |
| description | No | What you're looking for (max 500 characters) |
| players | No | Total players needed including you (default: 5, min: 2) |
/lfg game:Gears 5 description:Ranked KOTH, need 4 more players:5/lfg-setup
Configure LFG settings for the server. Requires MANAGE_QUEUES permission.
| Parameter | Required | Description |
|---|---|---|
| enabled | No | Enable or disable LFG |
| expiry | No | Default post expiry in minutes (1-1440). Default: 120 |
| max-size | No | Maximum group size (2-50). Default: 20 |
/lfg-setup enabled:true expiry:60 max-size:10Summary
| Command | Category | Permission |
|---|---|---|
| /register | Player | Everyone |
| /join | Player | Everyone |
| /leave | Player | Everyone |
| /queue | Player | Everyone |
| /stats | Player | Everyone |
| /leaderboard | Player | Everyone |
| /season-info | Season | Everyone |
| /season-leaderboard | Season | Everyone |
| /lfg | LFG | Everyone |
| /help | Utility | Everyone |
| /setup | Admin | MANAGE_QUEUES |
| /clear-queue | Admin | MANAGE_QUEUES |
| /set-maps | Admin | MANAGE_QUEUES |
| /set-map-mode | Admin | MANAGE_QUEUES |
| /set-mvp-bonus | Admin | MANAGE_QUEUES |
| /season-reset | Admin | MANAGE_QUEUES |
| /lfg-setup | Admin | MANAGE_QUEUES |
| /win | Admin | REPORT_RESULTS |
| /cancel-match | Admin | REPORT_RESULTS |
| /void-match | Admin | REPORT_RESULTS |
| /overturn-match | Admin | REPORT_RESULTS |
| /mvp | Admin | REPORT_RESULTS |
| /set-elo | Admin | MANAGE_PLAYERS |
| /remove-player | Admin | MANAGE_PLAYERS |
| /ban-player | Admin | MANAGE_PLAYERS |
| /unban-player | Admin | MANAGE_PLAYERS |
| /ban-status | Admin | MANAGE_PLAYERS |