Skip to content

Matchmaking & Lobbies

/queue_versus

admins only 2 subcommands 45 options

Create a versus queue or lobby launcher

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_versus. Command permission overrides are desktop-only — they cannot be configured from the Discord mobile app.

Command permissions guide →

Subcommands

/queue_versus headless

Automatic matchmaking queue

OptionTypeWhat 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
1–25
Number of players per team (always 2 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 Elo ratings (defaults to 'default')
max_elo_difference integer
min 0
Maximum Elo difference between players (default: unlimited)
team_formation text How teams are formed
Choices: random_teams, balanced_teams, players_choose, captains_highest_elo, captains_lowest_elo, captains_random, captains_volunteer
idle_timeout_minutes integer
min 1
Minutes before a player 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 players join the queue
dispute_notification_channel channel Channel for dispute notifications
dispute_notification_role role Role to mention when disputes are raised
audit_channel channel Channel for logging match events (scores, disputes, results)
screenshot_channel channel Channel where players can upload match screenshots
post_match_instructions text Instructions shown when voting on match results
queue_password text Password required to join this queue (leave empty for no password)

* required

/queue_versus hosted

User-hosted lobby launcher

OptionTypeWhat 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
Number of players per team (e.g., 1 for 1v1, 2 for 2v2)
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 Elo ratings (defaults to 'default')
max_elo_difference integer
min 0
Maximum Elo difference between players (default: unlimited)
idle_timeout_minutes integer
min 1
Minutes of inactivity before a lobby auto-closes when not full (default: 60)
team_formation text How teams are formed
Choices: random_teams, balanced_teams, players_choose, captains_host_picks, captains_highest_elo, captains_lowest_elo, captains_random, captains_volunteer
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
audit_channel channel Channel for logging match events (scores, disputes, results)
screenshot_channel channel Channel where players can upload match screenshots
post_match_instructions text Instructions shown when voting on match results

* required