Command Reference

All GotNext slash commands are organized by category. Player commands are open to everyone. Admin commands map to the same permission model used by the web dashboard, so server staff can hand off queue, result, player, and season operations cleanly. The /gotnext group connects competitors to the organization's tournaments, ladders, XP, and achievements.

Common starting points:

/setup team-size:4 mode:AUTO_MATCH /join /win match:42 team:1

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). Optionally provide a custom display name for leaderboards and stats.

/set-name

Change your display name in the ELO system. Updates your leaderboard name, stats, and Discord server nickname. Once set, your name won't be overwritten by Discord name changes.

/join

Join the queue in the current channel. You must /register first. When enough players are in, a match is automatically created with balanced teams. If the queue has show-queue disabled, the channel only shows "A player joined" without revealing who.

All teammates must be registered and not banned. Your team must be full (e.g. 2 players in a 2v2 queue) and will only match against another team.

/leave

Leave the queue in the current channel. If you're in a team, the entire team is removed. If show-queue is disabled, the channel only shows "A player left" without revealing who.

/queue

See the current queue count for the channel. If queue visibility is enabled, the response includes names. If visibility is disabled, only Discord admins or roles with VIEW_HIDDEN_QUEUE can see who is waiting.

/stats

View ELO stats for yourself or another player. Renders a stats card showing rating, rank tier, record, win/loss streaks, peak rating, and more.

/h2h

View your head-to-head record against another player. Renders a card showing:

• Versus record: wins and losses when you played against each other, with win rate
• Teammates record: wins and losses when you were on the same team
• Recent matches: last 5 matches between you, showing which team each player was on and the result
• Both players' current ELO and rank tier

/teammates

View your best (and worst) teammates by win rate. Aggregates every completed match where you shared a team with another player and shows a ranked breakdown:

• Top pairings: up to 8 rows with wins, losses, win rate, games played, and average ELO delta when paired
• Cursed combos: any teammate you win under 40% with, surfaced separately so the one 0-4 pairing buried in the list still gets the spotlight

/rivals

See a player's most frequent teammates and opponents across completed matches.

/predict

Get a win probability prediction for an active match. Uses the match roster's average ELO to compute base odds, then layers in cross-team head-to-head history to adjust confidence. Each team's chance is shown as a Unicode progress bar.

• Win probability: ELO-derived odds split between the two teams
• Head-to-head matchups: per-pair history across every cross-team matchup in completed games
• Caveat note: surfaced if the H2H record strongly disagrees with the ELO read (e.g. "Team 1 is favored on paper but has a losing H2H record against this roster")

/leaderboard

View the server's ELO leaderboard. Shows the top players ranked by rating. Includes a link to the full web leaderboard that you can share with your community.

/top

View top players by category. Choose between Most MVPs or Longest Win Streaks to see the top 10 players in each category. Includes a link to the full web leaderboard.

/tiers

View the ELO tier thresholds configured for this server. Shows each tier name and the ELO range needed to reach it, plus the server's starting ELO.

/help

Show all available GotNext Bot commands with descriptions.

/how-it-works

See how this channel's queue or challenge system works. Explains the current queue mode, team size, ELO rules, and any active settings configured for this channel.

/scoring-document

Generate the full ELO scoring rules document for this server. Shows how ELO is calculated, tier thresholds, wager rules, streak bonuses, and any other scoring configuration in effect.

/match

View details of a specific match by ID.

/matches

See active matches in the current queue. Outside a queue channel, it shows active matches across the server.

/server-matches

See every active match across all queues in the server.

/queue-status

See the waiting-player count and active-match count for every queue in the server.

/server-info

View the server's queue, tier, season, and ELO configuration in one message.

/admin-guide

Show the player and staff commands the current Discord member can use based on their assigned bot permissions.

/faq

Open common bot answers or select a specific question.

/screenshot

Attach scoreboard evidence to one of your matches. The queue must have result screenshots enabled, the uploader must be a participant, and the image must be no larger than 25 MB.

/vote

Open the GotNext top.gg vote page and check your current voter-badge status. A successful vote grants the voter badge for 24 hours.

/gotnext

Use the linked GotNext organization without leaving Discord. These responses are private to the player. Organization owners still configure tournaments, ladders, queues, XP, and achievements on the web.

Team tournament registration and team ladder entry continue on the web because they require roster management.

/challenge

Challenge another captain to an ELO match. Both sides must provide a complete roster for the queue's team size. The challenged captain receives an accept or decline action. A wager is optional and cannot exceed the queue's configured maximum.

Challenge mode must be enabled on this queue via /set-challenges.

---

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.

Schoolyard Pick mode: When enough players join, two captains are selected based on the captain-mode setting (random by default, or highest/lowest ELO). Captains take turns picking players via buttons. Each captain has 45 seconds to pick. If they don't pick in time, the bot auto-picks the highest-rated available player. Once all players are picked, the match starts.

New team queues use dedicated match channels by default. A server can disable them from the queue's dashboard settings. A 1v1 queue stays in the shared queue channel and does not require a match-channel category.

/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.

Clearing 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.

Requires a map pool to be set first via /set-maps.

/set-captain-mode

Set how captains are chosen in Schoolyard Pick mode.

Only applies to queues using Schoolyard Pick mode.

/set-mvp-bonus

Set the bonus ELO awarded when a player receives an MVP.

/cancel-draft

Cancel an active captain draft in the current queue channel. Use this if a draft is stuck or needs to be restarted. All players are returned to the queue.

/remove-from-queue

Remove a specific player from the queue in the current channel. If the player is part of a team (party), only that player is removed, not the whole team.

/freeze-queue

Toggle a freeze on the current channel's queue. When frozen, new players cannot join via /join until the queue is unfrozen. Players already in the queue are unaffected. Run the command again to unfreeze.

/queue-board

Post or remove a persistent queue board in the current queue channel. The board stays in place and updates its existing message as players join or leave.

/set-autoping

Ping a Discord role when the queue is close to full. Omit the role to disable auto-ping.

/set-challenges

Configure challenge mode for this queue. When enabled, players can use /challenge to directly challenge another team captain to an ELO match instead of waiting in the queue. Optionally set a max wager to cap how much ELO can be wagered on challenges.

---

Reporting Results

Reporting and result-correction commands require REPORT_RESULTS unless an entry says otherwise. Roster changes, cancellations, and reopening a result require MANAGE_QUEUES. Discord Administrators can use both groups.

Report Result button

Moderators, admins, and configured roles with Report Results can use Report Result to create a guided report. The reporter does not need to be one of the players. When map evidence or captain confirmation is enabled, GotNext saves a report draft that organizes the winner, each played map, its optional MVP, its optional flawless result, and its screenshot evidence.

Each map MVP applies the queue's configured MVP bonus once. For example, selecting the same player on two map rows gives that player two MVP awards and twice the configured bonus.

With Captain result confirmation enabled, ratings remain unchanged until a captain from the other team confirms the report. A dispute pauses the report for staff review.

When a different moderator has a saved draft, GotNext shows the saved progress and asks before transferring ownership. Existing map results and evidence are preserved. Reports waiting for captain confirmation stay locked against takeover.

/win

Report the winning team for a match. This is the authorized staff override for exceptional cases and corrections. You can optionally award MVPs at the same time instead of using a separate /mvp command.

Use the same player in more than one MVP slot when they earned MVP on multiple maps.

/sub

Swap a player in an active match for another registered player. The match must not have been reported yet. Requires MANAGE_QUEUES.

/trade

Swap two players between Team 1 and Team 2 on an active match. The players must already be on opposite teams. Requires REPORT_RESULTS or MANAGE_QUEUES.

/cancel-match

Cancel an active match. No ELO changes are applied. Requires MANAGE_QUEUES.

/uncancel-match

Restore a cancelled match to in progress without applying ELO changes. Requires MANAGE_QUEUES.

/undo-match

Reopen a completed match, reverse its scoring, and return it to in progress so staff can report it again. Requires MANAGE_QUEUES.

/cancel-unscored-matches

Bulk-cancel active matches older than a chosen cutoff. The cutoff can be from 1 to 720 hours. This also cleans up their dedicated channels and queue-board state. Requires MANAGE_QUEUES and explicit confirmation.

/close-match

Immediately close a reported match's dedicated channel instead of waiting for automatic cleanup. Run it inside that dedicated channel. Requires REPORT_RESULTS.

/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. Can be reversed with /unvoid-match.

/overturn-match

Flip the winner of a completed match. The original winner's ELO gains are reversed and applied to the other team.

/unvoid-match

Restore a voided match and reapply ELO changes. Use this if a match was voided by mistake. ELO will be recalculated based on current ratings.

/mvp

Award MVP to one or more players in a completed match. Grants bonus ELO if configured via /set-mvp-bonus. You can also award MVPs directly in the /win command.

Use the same player in multiple player slots to give them more than one MVP award.

/revoke-mvp

Revoke an MVP award from a player. Removes the MVP and reverses any bonus ELO that was awarded. Use this if an MVP was given by mistake.

/flawless

Award the queue's Premium flawless-victory bonus to specific players from a completed match. Repeat player options are not needed because each recipient receives the configured bonus once.

Requires REPORT_RESULTS or MANAGE_QUEUES and Ranked Queues Premium.

/revoke-flawless

Remove flawless-victory bonuses from a match. Omit all player options to revoke every flawless award on that match, or select up to ten individual players.

Requires REPORT_RESULTS or MANAGE_QUEUES.

/set-flawless-bonus

Set the flawless-victory bonus for the current queue.

Requires MANAGE_QUEUES and Ranked Queues Premium.

---

Player Management

Requires MANAGE_PLAYERS permission or Discord Administrator.

/set-elo

Manually set a player's ELO rating.

/rename-player

Rename another player in the ELO system and update their Discord server nickname. Players can rename themselves with /set-name. This command is for admins to rename other players.

/remove-player

Unregister a player from the ELO system. Removes their ELO prefix from their nickname.

/ban-player

Ban a player from all queues on the server.

/unban-player

Remove a player's ban.

/ban-status

Check if a player is currently banned and view ban details.

/force-join

Add a registered player to the current queue on their behalf. The normal ban, active-draft, active-match, queue-capacity, and tier rules still apply.

GotNext mentions the added player in the queue channel so they know they were enrolled. The staff member who ran the command also receives a private confirmation.

Requires MANAGE_PLAYERS.

---

Server Settings

These server-wide slash commands are limited to Discord Administrators. Authorized organization operators can change the corresponding settings from the web dashboard.

/set-starting-elo

Set the starting ELO for new players who register on this server. This is a server-wide default. Individual queues inherit it unless overridden. Also configurable from the web dashboard Settings tab.

/set-provisional-threshold

Set the number of games a player must complete before they are considered "established" (no longer provisional). Provisional players may have different K-factors or flat ELO amounts depending on queue configuration.

/set-scores-channel

Designate a channel where match scores are automatically posted after each game. Leave the channel option empty to clear the setting and stop posting scores.

/set-tier-announcements

Toggle tier promotion announcements. When enabled, the bot posts a message whenever a player ranks up to a new ELO tier.

/season-config

Configure season settings including reset type, duration, ELO decay, and the summary channel. All options are optional — only the ones you provide will be updated. This is the slash command equivalent of the Season section in the web dashboard Settings tab.

ELO Decay requires a Ranked Queues Premium subscription.

---

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.

/season-reset

Immediately end the current season, archive all player stats, and reset ELOs. Requires MANAGE_QUEUES permission.

/streak-bonus

Configure bonus ELO awarded when a player reaches a specific win streak milestone. The bonus fires once at the exact streak count. Requires MANAGE_QUEUES permission.

/matchmaking

Set how players are selected when the queue fills. Requires MANAGE_QUEUES permission. Must be run in a queue channel.

/elo-gate

Set ELO requirements to join this queue. Only players within the specified rating range can use /join. Requires MANAGE_QUEUES permission. Must be run in a queue channel.

---

Summary

The sections above cover every slash command currently registered with Discord. Use /help for the in-Discord list, /admin-guide for the commands your current roles can use, and the Permissions guide for staff access.

Discord's command picker is the final source for required parameters and available choices. It updates automatically when GotNext adds or changes a command.