Matchmaking & Lobbies
/queue_team
Create a team-based queue or lobby launcher for predefined teams
Who can run it
Server administrators only, until you say otherwise.
Discord hides this command from everyone else, so members will not see it in the command
picker at all. To open it up, go to Server Settings →
Integrations → Team Up and add a role or member override for /queue_team.
Command permission overrides are desktop-only — they cannot be configured from the
Discord mobile app.
Subcommands
/queue_team headless Automatic matchmaking queue
| Option | Type | What it does |
|---|---|---|
| queue_name * | text | Unique name for this queue (max 32 chars) |
| title * | text | Display title for the queue |
| description * | text | Description of the queue |
| team_size * | integer min 1 | Size of teams that can join this queue (e.g., 5 for 5-player teams) |
| match_start_channel * | channel | Channel where match creation notifications are sent |
| match_end_channel * | channel | Channel for listing finished matches |
| leaderboard | text | Leaderboard to use for team ratings (defaults to 'default') |
| max_elo_difference | integer min 0 | Maximum Elo difference between teams (default: unlimited) |
| idle_timeout_minutes | integer min 1 | Minutes before a team times out from the queue (default: 10) |
| match_result | text | How match results are handled Choices: disabled, ranked, ranked_admin, unranked, unranked_admin, ranked_admin_decide, unranked_admin_decide |
| competitive_format | text | Format for match recording Choices: single_match, endless_matches, best_of, cumulative |
| matches | integer 1–99 | Number of matches/rounds (required for Best Of or Cumulative formats) |
| map_pool | text | Name of the map pool to use (created via /map_pool add) |
| map_voting_strategy | text | How maps are selected for matches Choices: simple, captains_ban_with_reroll, captains_ban_no_reroll, stage_striking, stage_striking_counterpick |
| category_for_temp_channel | channel | Category for temporary channels created during matches |
| join_notification_channel | channel | Channel for queue join notifications |
| join_notification_role | role | Role to mention when teams join the queue |
| dispute_notification_channel | channel | Channel for dispute notifications |
| dispute_notification_role | role | Role to mention when disputes are raised |
| post_match_instructions | text | Instructions shown when voting on match results |
* required
/queue_team hosted User-hosted lobby launcher
| Option | Type | What it does |
|---|---|---|
| queue_name * | text | Unique name for this launcher (max 32 chars) |
| title * | text | Display title for the launcher |
| description * | text | Description of the launcher |
| team_size * | integer min 1 | Size of predefined teams that can join |
| match_start_channel * | channel | Channel where active lobbies are listed |
| match_end_channel * | channel | Channel for listing finished matches |
| leaderboard | text | Leaderboard to use for team ratings (defaults to 'default') |
| max_elo_difference | integer min 0 | Maximum Elo difference between teams (default: unlimited) |
| idle_timeout_minutes | integer min 1 | Minutes of inactivity before a lobby auto-closes when not full (default: 60) |
| match_result | text | How match results are handled Choices: disabled, ranked, ranked_admin, unranked, unranked_admin, ranked_admin_decide, unranked_admin_decide |
| competitive_format | text | Format for match recording Choices: single_match, endless_matches, best_of, cumulative |
| matches | integer 1–99 | Number of matches/rounds (required for Best Of or Cumulative formats) |
| map_pool | text | Name of the map pool to use (created via /map_pool add) |
| map_voting_strategy | text | How maps are selected for matches Choices: simple, captains_ban_with_reroll, captains_ban_no_reroll, stage_striking, stage_striking_counterpick |
| category_for_temp_channel | channel | Category for temporary channels created during matches |
| dispute_notification_channel | channel | Channel for dispute notifications |
| dispute_notification_role | role | Role to mention when disputes are raised |
| post_match_instructions | text | Instructions shown when voting on match results |
* required
Other Matchmaking & Lobbies commands
Queues that form matches automatically, hosted lobbies players join by button, map pools, and position selection.
/host Create a matchmaking lobby for other players to join.
/queue_ffa Create a Free-For-All queue or lobby launcher
/queue_coop Create a co-operative queue or lobby launcher
/queue_versus Create a versus queue or lobby launcher
/queue_anonymous Create an anonymous queue or lobby launcher (random hidden teams)
/queue_manage Manage existing matchmaking queues
/positions Manage positions for lobbies with position selection
/map_pool Manage map pools for voting
/map_vote Start a map vote for players