Skip to content

Matchmaking & Lobbies

/queue_ffa

admins only 2 subcommands 41 options

Create a Free-For-All 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_ffa. Command permission overrides are desktop-only — they cannot be configured from the Discord mobile app.

Command permissions guide →

Subcommands

/queue_ffa 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
match_start_channel *channel Channel where match creation notifications are sent
match_end_channel *channel Channel for listing finished matches
min_players *integer
min 2
Minimum players required to start a match (default: 2)
max_players integer
min 2
Maximum players in a match (default: min_players)
join_grace_period integer
min 0
Minutes to wait for more players after minimum is reached (default: 2)
leaderboard text Leaderboard to use for Elo ratings (defaults to 'default')
match_result text How match results are handled (default: Ranked)
Choices: disabled, ranked, ranked_admin, unranked, unranked_admin, ranked_admin_decide, unranked_admin_decide
max_elo_difference integer
min 0
Maximum Elo difference between players (default: unlimited)
idle_timeout_minutes integer
min 1
Minutes before a player times out from the queue (default: 10)
join_notification_channel channel Channel for queue join/leave notifications
join_notification_role role Role to mention when players join/leave the queue
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
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

/queue_ffa 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
match_start_channel *channel Channel where active lobbies are listed
match_end_channel *channel Channel for listing finished matches
min_players *integer
min 2
Minimum players required to start a match (default: 2)
max_players integer
min 2
Maximum players in a match (default: min_players)
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)
join_notification_channel channel Channel for lobby join/leave notifications
join_notification_role role Role to mention when players join/leave the lobby
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
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