All NeatQueue commands are slash commands, which means they are invoked using a /
Any Admin command requires the user to have Manage Channels permissions, or have one of the configured NeatQueue staff roles.
In this documentation, anytime an argument is surrounded by [square brackets], it is a required argument. If it is surrounded by (parenthesis), it is optional.
The term MMR stands for Match Making Rating, which corresponds to the hidden rating system used by most competitive games.
All commands are queue specific unless otherwise stated.
All stats are tied to the queue name. This means if you create multiple queues with the same queue name, they will share stats.
Want to Donate? Simply use /donate or visit https://donatebot.io/checkout/505102060119916545
Starting a queue is super simple with NeatQueue, just run one of the following commands:
Toggle on/off using the custom overrides.
original_phrase
: (Required) Existing phrase to override.
overriden_phrase
: (Optional) Replacement phrase, omit to go back to default.
Toggle on/off using the custom overrides.
toggle
: (Required) Toggle custom overrides.
Options: Enabled, Disabled
Upload a custom overrides file.
custom_overrides
: (Required) Custom translation overrides, omit to remove.
The overrides file is JSON format, and can be found here: https://www.neatqueue.com/default_overrides.json The keys (left side) signify the already existing English phrase the bot uses. The value (right side) is the value that replaces the key.
Sometimes an entry will include special charcters similar to {}. The total number of these signifiers in each entry must remain constant. If an override does not match the count of signifiers, it will not be used.
Leaderboard titles are hyperlinks to the website version of the leaderboard.
Create a custom website url for leaderboards.
url
: (Required) Custom url for this channel's leaderboard.
Sets the color for all embeds in messages.
color
: (Required) Either a color by name, or by HEX value (Ex: 00FF55).
(Default: None) Set a footer for the queue message.
text
: (Optional) Footer contents, or omit to remove.
icon_url
: (Optional) -.
(Default: None) Set an image for the queue message.
image_url
: (Optional) Direct URL of image, or omit to remove.
(Default: None) Set a thumbnail for the queue message.
image_url
: (Optional) Direct URL of image, or omit to remove.
Start a vote to cancel the current match.
Compare your stats to the given player.
Usage: /compare [player2] (player1) (hidden)
player2
: (Required) Enter the second user you want to compare to.
player1
: (Optional) Enter the first user you want to compare to, or omit for yourself.
hidden
: (Optional) If you want the stats to be hidden.
Donate to help NeatQueue development.
Start a vote to forcestart the game, skips vote if used by staff.
View locations where to find help for setup.
Shows the leaderboard for the current queue's game.
page
: (Optional) The desired page number.
type
: (Optional) The type of leaderboard to display.
Options: MMR, Peak MMR, Points, MVPs, Games, Wins, Losses, Winrate, Streak, Peak Streak
queue_name
: (Optional) The queue name to view.
Shows how many players are needed for the queue.
channel
: (Optional) Channel of queue to show need for.
CAPTAIN ONLY: Cancel all pending invites.
party_name
: (Required) The party name.
CAPTAIN ONLY: Designate a new captain if you are the current one.
player
: (Required) The new captain.
party_name
: (Required) The team name.
Create a new party.
party_name
: (Required) The party name.
CAPTAIN ONLY: Disband a party.
party_name
: (Required) The party name.
CAPTAIN ONLY: Invite a new player to the party.
player
: (Required) Player to invite.
party_name
: (Required) The party name.
Join a party.
party_name
: (Required) The party name.
CAPTAIN ONLY: Kick a player from the party.
player
: (Required) The player to kick.
party_name
: (Required) The team name.
Leave a party.
party_name
: (Required) The party name.
List your parties.
Specify your role in the party.
party_name
: (Required) The party name.
role
: (Required) Your role.
View the specified party.
party_name
: (Required) The party name.
Pings all members in the queue.
Place a bet on the given team for the specified match number.
gamenumber
: (Required) Game number of bet on.
team
: (Required) Team to place the bet on.
amount
: (Required) Amount of points you want to bet.
Initialize your MMR using your account.
account
: (Required) Account details.
Sets your IGN for this queue to help with easy lobby setup.
ign
: (Required) Your IGN for this queue's platform.
Set your role.
role
: (Optional) Preferred role to use, or omit to remove.
Shows your stats.
Usage: /stats (hidden) (user) (all_time)
hidden
: (Optional) If you want the stats to be hidden.
user
: (Optional) The user you want to check stats of.
all_time
: (Optional) If you want to view all time stats, only applies to monthly queues.
Substitute yourself for the given player.
player
: (Required) Enter the player to replace you.
Sets whether to hide the names of players in queue.
mode
: (Required) Hide players names in queue.
Options: Enabled, Disabled
Sets the anticheat channel to show flagged users.
channel
: (Required) The desired anticheat channel.
Enable/disable the anticheat system.
toggle
: (Required) Toggle for anticheat.
Options: Enabled, Disabled
Set an anticheat trigger for players who vote for the wrong team.
toggle
: (Required) Flag users who vote wrong.
Options: Enabled, Disabled
Set an anticheat trigger for new accounts.
age
: (Required) Account age in days.
Set an anticheat trigger for if a player rejoins a server.
toggle
: (Required) Flag users who rejoin the server if they already have stats.
Options: Enabled, Disabled
Set an anticheat trigger for a players streak.
streak
: (Required) Streak to trigger a flag.
Set a role to assign to flagged players.
role
: (Required) Role to assign.
Remove the set auto ping rule.
Automatically ping the given role when the queue hits the given size.
role
: (Required) Role to ping.
size
: (Required) Ping when the queue hits this size.
Order of role to skill from lowest to highest rated, used if balance by ROLES, not MMR.
Usage: /balanceby roles (role1) (role2) (role3) (role4) (role5) (role6) (role7) (role8) (role9) (role10)
role1
: (Optional) The role to use in balancing.
role2
: (Optional) The role to use in balancing.
role3
: (Optional) The role to use in balancing.
role4
: (Optional) The role to use in balancing.
role5
: (Optional) The role to use in balancing.
role6
: (Optional) The role to use in balancing.
role7
: (Optional) The role to use in balancing.
role8
: (Optional) The role to use in balancing.
role9
: (Optional) The role to use in balancing.
role10
: (Optional) The role to use in balancing.
(Default: mmr) Sets how teams are balanced.
mode
: (Required) How teams are balanced.
Options: Roles, MMR
Sets whether the queue is a best of 3, 5, 7, etc.
number
: (Required) Best of number.
vote
: (Optional) Whether players can vote on the number of matches to play.
voteselection
: (Optional) Whether to pick the majority vote, or the lowest voted number.
Options: Majority, Lowest
eligible_voters
: (Optional) Who on the team can vote. Defaults to All if no captain selected.
Options: All, Captains
Automatically mute all non-captains during selection to remove bias.
toggle
: (Required) If players are muted.
Options: Enabled, Disabled
Sets the type of draft to either Snake or Straight.
type
: (Required) The type of draft to use.
Options: Snake (1-2-2-2), Straight (1-1-1-1), Hybrid (1-1/2-1-1), Hybrid 2 (1-2-1-1), Vote
Specify who gets the first pick in captain selection.
mode
: (Required) Who gets the first pick.
Options: Highest Rated, Lowest Rated, Random
Sets whether players can reshuffle captains in random captain selection.
toggle
: (Required) Whether reshuffling is enabled or disabled.
Options: Enabled, Disabled
Sets a role which gets priority for being captain.
role
: (Optional) The captain role.
Choose how captains will be picked.
Due to Discord API limitations, NeatQueue can only update the channel name twice per a 10 minute period.
(Default: Parent) Sets whether created channels go in a separate or the parent category.
category_mode
: (Required) The category setting. If mode is Specified, you must provide the category.
Options: Parent, New, Specified
category
: (Optional) The specific category if category_mode is Specified.
Set the channel name when a queue is empty. Can only be updated twice per 10 minutes!.
channel_name
: (Required) The channel name.
Set the channel name when a queue is locked. Can only be updated twice per 10 minutes!.
channel_name
: (Required) The channel name.
Set the channel name when a queue isn't empty. Can only be updated twice per 10 minutes!.
channel_name
: (Required) The channel name.
(Default: enabled) Sets whether created channels have restrictions.
mode
: (Required) If channels are restricted.
Options: Enabled, Disabled
Clears the running queue.
(BETA) Sends a button which triggers a command when clicked.
command
: (Required) Command to invoke.
color
: (Optional) Color for the button.
Options: blurple, gray, green, red
emoji
: (Optional) Emoji to include in the button.
label
: (Optional) Label for the button, defaults to the command name.
Send a button that allows players to show their stats.
List the 15 most recently created configs.
Loads the queue configuration based on the given name.
config
: (Required) Config name.
Save the current queue configuration to a name.
name
: (Optional) Name of new config code, or omit for a random code.
Join/create a crosschat room, to share a text channel between servers.
room_name
: (Optional) Name of the room.
censored
: (Optional) If crosschat text should be censored.
Leave the crosschat.
Auto ban players who cause a match to cancel by not joining the voice channel.
duration
: (Optional) Duration of time in seconds for the ban to last, or 0 to reset.
Deduct MMR from players who dodge the match.
amount
: (Required) Amount of MMR to deduct.
Deduct points from players who dodge the match.
amount
: (Required) Amount of points to deduct.
Ends the running queue.
Sets the requirements for forcestarting.
min_size
: (Required) Enter the minimum number of players required. Set to -1 to disable.
max_size
: (Optional) Enter the maximum number of players required. Set to -1 to ignore.
only_fair
: (Optional) Should the forcestart happen if teams are not the same size?.
auto_start
: (Optional) Should the forcestart vote automatically happen when possible?.
(Default: 300) Sets the forcestart cooldown.
seconds
: (Required) Cooldown duration in seconds.
Specify whether players must register their account before playing.
mode
: (Required) Game to register with, or None to disable.
Options: None, Valorant, Rainbow 6, Overwatch, RocketLeague, Custom API, Manually
With register mode being Custom API, please check out
https://docs.neatqueue.com/#/?id=webhooks
With register mode Manually, players must have their MMR manually set, either through an admin command or via an API requesthttps://docs.neatqueue.com/#/?id=endpoints
.
Sets whether players can reshuffle gamemodes in random gamemode selection.
toggle
: (Required) Whether reshuffling is enabled or disabled.
Options: Enabled, Disabled
Choose how gamemodes are selected.
gamemode_choice
: (Required) Voting, always random, ordered, or least common.
Options: Vote, Random, Least Frequent, Ordered
Adds the given hero.
hero_name
: (Required) New hero name.
Specify the number of hero bans or 0 to disable.
bans
: (Required) Number of bans (per team if applicable).
per_team
: (Optional) If the hero bans are team by team.
Removes the given hero.
hero_name
: (Required) The hero to remove, or ALL to remove all.
Specify who can vote for hero bans. Defaults to All if no captains.
per_team
: (Required) If the map vote goes team by team. Team 1 picks first ban, Team 2 picks next, ...
mode
: (Required) Who can vote.
Options: All, Captains
View information about the queue configuration.
Set the language for the server.
language
: (Required) Server language.
Options: English, Spanish, French, Portuguese, Japanese, Russian, German, Italian, Ukrainian, Polish, Hebrew, Arabic, Bengali, Hindi, Turkish, Vietnamese, Uwu, Owo
If there is an issue with a normal language translation, please fix here: https://crowdin.com/project/neatqueue
Leaderboard titles are hyperlinks to the website version of the leaderboard.
Specify who can edit a leaderboard.
edits
: (Required) Who can edit the leaderboard buttons.
Options: Staff, Anyone, Creator
Will not show players on leaderboard with this role.
role
: (Required) Required role to show on leaderboard.
Remove an ignored leaderboard role.
role
: (Required) Role to no longer ignore.
Toggle monthly leaderboards, either resets monthly or rolls over.
toggle
: (Required) If monthly leaderboards are enabled.
Options: Enabled, Disabled
mode
: (Optional) If stats reset for the month, or keep rolling.
Options: Reset, Rolling
(Default: 1) The required number of games played to be displayed on the leaderboard.
games
: (Required) Required number of games.
Toggle having player stats be shared among all queues.
toggle
: (Required) If player stats are server wide.
Options: Enabled, Disabled
name
: (Optional) Shared stats name, or omit to automatically determine.
Sets the name to use for stats storaged. Queues with the same name share stats.
name
: (Required) Shared stats configuration name.
Toggle using the image or text leaderboard.
type
: (Required) Leaderboard format.
Options: Images, Text
Links the current channel to another channel's queue.
channel
: (Required) Enter the channel to link to.
Unlinks the current channel.
If the lobby channel should mute all players.
toggle
: (Required) If players are muted in the lobby channel.
Options: Enabled, Disabled
Pause the current lobby channel countdown timer.
Specify pulling players from all channels when their match starts.
toggle
: (Required) Pull players from all channels.
Options: Enabled, Disabled
Specify returning players to their original voice channel from before the match.
toggle
: (Required) Return players to their original voice channel.
Options: Enabled, Disabled
Specify the channel to move players to/from before/after a game.
channel
: (Required) Channel to drag/drop players from/to.
Specify how long players have to join the voice channel before the match is cancelled.
timer
: (Required) (Default: 300) Timeout length in seconds.
Toggle creating a voice channel when a match is created for lobby setup.
toggle
: (Required) If a new voice channel is made for each lobby setup.
Options: Enabled, Disabled
Unpause the current lobby channel countdown timer.
Sets the lobby details message.
location
: (Required) Where to show lobby details.
Options: DMs, Teams Message
Removed the lobby details message.
Sets the lobby details message.
message
: (Required) Enter the message to send.
Currently supports five substitutions:
HOST
: Randomly select a player name
QUEUENUM
: Substitute the queue number
RANDOMTEAM
: Substitute a random team name
RANDOM[Option1,Option2,...]
: Randomly select one of the given options and substitute. Ex:RANDOM[Heads,Tails]
PASSWORD#T
: Generate a random string of characters, where # is the length of the password, and T is the type of characters to be in the password. There are currently 5 supported password types:
- L: Lowercase Letters only
- U: Uppercase Letters only
- N: Numbers only
- C: Lowercase and Uppercase Letters
- A: Lowercase Letters, Uppercase Letters, and Numbers
Example:
/lobbydetails set "Host: HOST, Lobby Name: QUEUENUM, Lobby Password: PASSWORD8A
could substitute to"Host: @NeatZ, Lobby Name: 12345, Lobby Password: D83mA76x"
You can further enhance the visuals using Markdown formatting.
Lock the queue channel to prevent players from joining.
all
: (Optional) Lock all queues?.
Unlock the queue channel to allow players to join.
all
: (Optional) Unlock all queues?.
View a log of used NeatQueue commands.
filter
: (Optional) Filter for logs containing this word.
Sets if the vote to disable MMR appears.
allow_disable
: (Required) If MMR changes should be toggleable.
/mmr change hidden
Sets if MMR changes are hidden from players.
Usage: /mmr change hidden [hidden]
hidden
: (Required) If MMR changes are hidden.
(Default: Per Player) Sets if MMR changes are calculated per player, or per team.
mode
: (Required) How MMR changes are calculated.
Options: Per Player, Per Team
MMR multipliers will still be applied on a per-player basis. Disable multipliers to make everyone on the team get the same MMR change.
(Default: 50) Sets the MMR change per game.
amount
: (Required) The average MMR change for wins and losses.
loser_mmr
: (Optional) Override the MMR change for losses.
static
: (Optional) If the MMR change should ALWAYS be this value.
Sets the variance value. Lower value = higher ranges of MMR changes.
amount
: (Required) (Default: 1600) Variance value. See docs for a calculator.
Calculator: https://www.desmos.com/calculator/3qtwvlrw8q Using the calculator, you can see that as the variance value goes up, the actually outputted MMR change has lower variance.
Enable/disable MMR decay and configure the values.
toggle
: (Required) Enable/disable MMR decay.
Options: Enabled, Disabled
amount
: (Optional) Amount of MMR to decay.
duration
: (Optional) After how long should a player decay in seconds.
Sets the highest mmr a player can reach in this queue.
mmr
: (Optional) Enter the peak rating, or omit to reset.
Sets the lowest mmr a player can reach in this queue.
mmr
: (Optional) Enter the lowest rating, or omit to reset.
Toggle the placement matches multiplier.
toggle
: (Required) If there exists a multiplier for the first 10 matches.
Options: Enabled, Disabled
Remove the MMR multiplier for the given role.
role
: (Required) Role to remove multiplier for.
Sets the MMR multiplier for the given role for wins.
role
: (Required) -.
multiplier
: (Required) Multiplier value. (Ex: 1.2 for a 20% boost).
Toggle the streak multiplier.
toggle
: (Required) If there exists a multiplier for win/loss streaks.
Options: Enabled, Disabled
Sets the required mmr to enter this queue.
minimum_mmr
: (Optional) Enter the lowest MMR a player must be to join the queue, or omit to disable.
maximum_mmr
: (Optional) Enter the highest MMR a player can be to join the queue, or omit to disable.
(Default: 5) MMR reward for MVPs.
amount
: (Required) Amount of MMR to give as a reward.
Enable/disable MVP votes for matches.
toggle
: (Required) Enable/disable MVPs.
Options: Enabled, Disabled
(Default: Disabled) Require players to vote for MVP before voting for winner.
toggle
: (Required) If voting for MVP is required.
Options: Enabled, Disabled
Adds the given player to the queue.
user
: (Required) -.
role
: (Optional) Enter the role for the player.
team
: (Optional) Enter the team for the player if desired.
Bans a player from queuing for the given duration of time.
player
: (Required) The player to ban.
days
: (Optional) Days to ban for.
hours
: (Optional) Hours to ban for.
minutes
: (Optional) Minutes to ban for.
seconds
: (Optional) Seconds to ban for.
reason
: (Optional) -.
View the player ban list.
Removes the given player from the queue.
user
: (Required) The player.
Substitute the first player for the second player.
player1
: (Required) Enter the player to replace.
player2
: (Required) Enter the player that will be inserted.
gamenum
: (Optional) Game to modify. Can be omitted to use this channels game.
Unban the given player from queuing.
player
: (Required) The player to unban.
Copies the player stats from the old queue name to the new one.
old_name
: (Required) Old queue name with stats.
new_name
: (Required) New name to copy the stats to. Will overwrite any stats stored there.
Merges stats from the first queue name into the second queue name.
from_queue_name
: (Required) Queue to merge stats from.
to_queue_name
: (Required) Queue to merge stats into.
mmr_merge_strategy
: (Optional) How individual MMRs should be merged together.
Options: Maximum, Add Together, Average, Ignore
Moves the player stats from the old queue name to the new one.
old_name
: (Required) Old queue name with stats.
new_name
: (Required) New name to move the stats to. Will overwrite any stats stored there.
Resets all stats for all queues, or for the inputted queue name.
queue_name
: (Optional) The queue name to reset stats for.
Resets all MMR for all queues, or for the inputted queue name.
queue_name
: (Required) The queue name to reset stats for.
Reset the user's data for all queues or a certain queue.
user
: (Required) Enter the desired user.
queue_name
: (Optional) Enter the queue data to remove from. Ignore to delete all data from all queues.
Adds the given map.
map_name
: (Required) New map name.
game_modes
: (Optional) Comma separated list of game modes for map, if applicable.
image_url
: (Optional) Image to show when map selected.
Specify the number of map bans per team, or 0 to disable.
bans
: (Required) Number of bans per team.
per_team
: (Optional) If the map bans are team by team.
Removes the given map.
map_name
: (Required) The map to remove, or ALL to remove all.
Sets whether players can reshuffle maps in random map selection.
toggle
: (Required) Whether reshuffling is enabled or disabled.
Options: Enabled, Disabled
Choose how maps are selected.
map_choice
: (Required) Voting, always random, or least common.
Options: Vote, Random, Least Frequent
Specify who can vote for map picks and map bans. Defaults to All if no captains.
per_team
: (Required) If the map vote goes team by team. Team 1 picks first map, Team 2 picks next, ...
mode
: (Required) Who can vote.
Options: All, Captains
(Default: Enabled) Send a notification DM to all players when a match starts.
toggle
: (Required) If players are DMed on start.
Options: Enabled, Disabled
(Default: Disabled) Shuffle the player pool on start.
mode
: (Required) -.
Options: Disabled, Lottery, Priority
(Default: Either) Start the match when the queue fills, or only when forcestarted.
mode
: (Required) Condition for starting the match.
Options: Queue Filled, Forcestart, Either
The matchmaker works by checking the current queue if there are enough players to create a match. A match will only be created if the total range of player MMRs is less than the specified matchmaking range. Every 15 seconds, the range will be increased by the matchmaking leniency, and the match conditions will be rechecked with this new extended matchmaking range.
Every 15 seconds, how much the range will increase for a better chance at a match.
value
: (Required) How much to increase the range by.
The range of MMRs for matches. Tighter range = more waiting and players required.
range
: (Required) Range of player MMRs.
(Default: 3) Sets the delay for when a new queue message comes up.
seconds
: (Required) New message delay.
(Default: Enabled) Sets whether old queue updates should be deleted.
toggle
: (Required) Toggle between editing queue updates, or sending new messages.
Options: Enabled, Disabled
(Default: Enabled) Set whether queue updates should edit the previous message.
toggle
: (Required) Toggle between editing queue updates, or sending new messages.
Options: Enabled, Disabled
(Default: Disable) Sets whether to send a new message for every queue interaction.
toggle
: (Required) Toggle between sending queue join/leaves in the channel.
Options: Enabled, Disabled
(Default: Enabled) Sets whether the queue message sticks to the bottom of the channel.
toggle
: (Required) Toggle the message being sticky.
Options: Enabled, Disabled
Sets the format for the winner message.
mode
: (Required) Formatting type.
Options: Detailed, Simple
Sets whether the message gets pinned.
mode
: (Required) Pin mode.
Options: Enabled, Disabled
Set who can vote for the result, or if results are fully disabled.
value
: (Required) Who can vote, or if the match has no outcome.
Options: Default, Staff Only, Disabled
Sets whether the message sticks to the bottom of chat.
mode
: (Required) Sticky mode.
Options: Enabled, Disabled
(Default: Disabled) Mention the players after teams are created.
toggle
: (Required) If the players are mentioned after teams are created.
Options: Enabled, Disabled
Sets whether to use nicknames or discord names (Default: nick).
type
: (Required) The type of names to be used.
Options: Discord, Nicknames
Delete ALL messages in the channel except the queue message if it exists.
Remove the set results channel.
Sets the results channel to send queue history.
channel
: (Required) The text channel to send queue history to.
serverwide
: (Optional) Should the channel be global for all queues or just this one?.
Add a grace period for a user so they won't be affected by MMR decay.
time
: (Required) Enter the desired grace period time in seconds.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players games, use a negative number to decrement.
games
: (Optional) Enter the desired games to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players losses, use a negative number to decrement.
losses
: (Optional) Enter the desired losses to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players mmr, use a negative number to decrement.
mmr
: (Optional) Enter the desired mmr to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players MVPs, use a negative number to decrement.
mvps
: (Required) Enter the desired MVPs to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players peak mmr, use a negative number to decrement.
mmr
: (Required) Enter the desired mmr to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players peak streak, use a negative number to decrement.
streak
: (Required) Enter the desired streak to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players points (not MMR), use a negative number to decrement.
points
: (Required) Enter the desired points to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players streak, use a negative number to decrement.
streak
: (Optional) Enter the desired streak to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Increment the players wins, use a negative number to decrement.
wins
: (Optional) Enter the desired wins to add.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players games.
games
: (Required) Enter the desired games.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players IGN (used in /register
or /ign
).
account
: (Required) Enter the desired IGN, or 'none' to remove.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players losses.
losses
: (Required) Enter the desired losses.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players mmr.
mmr
: (Required) Enter the desired mmr.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players MVPs.
mvps
: (Required) The new MVPs amount.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players peak mmr.
mmr
: (Required) Enter the desired mmr.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players peak streak.
streak
: (Required) Enter the desired streak.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players points (not MMR).
points
: (Required) The new points amount.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players streak.
streak
: (Required) Enter the desired streak.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
Sets the players wins.
wins
: (Required) Enter the desired wins.
user
: (Optional) The user to modify.
role
: (Optional) The role to modify.
(Default: 1) Sets the number of lobbies to create.
lobbies
: (Required) The number of lobbies.
(Default: 2) Sets the number of teams.
number
: (Required) The number of teams.
Set the max party size that can enter the queue.
max_size
: (Optional) The max party size, or omit to remove.
(Default: Enabled) Prevent a party from joining queue if it over-fills the queue.
toggle
: (Required) If parties can overfill a queue.
Options: Enabled, Disabled
Enable party queue, allowing players to create parties with /party
before joining.
toggle
: (Required) Enable or disable party queue.
Options: Enabled, Disabled
(Default: 100) Set how many points players gain for a loss (not MMR).
value
: (Required) Points for a loss.
(Default: 100) Set how many points players gain for a win (not MMR).
value
: (Required) Points for a win.
Sets the highest number of points a player can reach.
points
: (Optional) Enter the peak points, or omit to reset.
Sets the lowest number of points a player can reach.
points
: (Optional) Enter the lowest points value, or omit to reset.
Remove the points multiplier for the given role.
role
: (Required) Role to remove multiplier for.
Sets the points multiplier for the given role.
role
: (Required) -.
multiplier
: (Required) Multiplier value. (Ex: 1.2 for a 20% boost).
(Default: 0) Set how many points players start with (not MMR).
value
: (Required) Starting points value.
Specify the channel to show predictions.
channel
: (Required) The predictions channel.
Role to ping when a prediction opens.
role
: (Required) Role to ping.
Specify the duration the prediction lasts before closing.
timer
: (Required) (Default: 180) Prediction length in seconds.
Specify the channel to show predictions.
toggle
: (Required) If predictions are enabled or disabled.
Options: Enabled, Disabled
(BETA) Add players to the queue when they join the voice channel.
channel
: (Optional) Queue entry voice channel, or omit to remove.
(BETA) Specify how players can join the queue.
modes
: (Required) The methods players can use to join the queue.
Options: Buttons, Voice Channel, Either
Sets the name for this queue. All stats are tied to the queue name.
name
: (Required) New queue name.
Select the type of queue to run. See docs for detailed explanations.
type
: (Required) The type of queue.
Options: PUGs/Normal Individual Queue, Matchmaking, Full Team vs Full Team, Select Team On Join
PUGs/Normal Individual Queue: The default queue setup, players join individually to get put into a match when the queue is filled. Matchmaking: Players join the queue, and once there are enough players within their MMR range, a match is created. Full Team vs Full Team: Captains join the queue and pull in the entire team. No team setup is required. Select Team On Join: The queue has join buttons for each team, no team setup is required.
Copies the auto roles config to the desired channel.
channel
: (Required) Channel with queue to copy autoroles config to.
Removes a condition where player roles are changed based on games.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on games.
role
: (Required) Role.
lower_value
: (Required) The lowest number of games required to gain the role.
upper_value
: (Required) The upper number of games to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other games autoroles will be allowed.
Assign a role to players who are in a match that is removed after.
role
: (Optional) Enter the role, or omit to remove.
Assign a role to players who are in the queue.
role
: (Optional) Enter the role, or omit to remove.
Removes a condition where player roles are changed based on losses.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on losses.
role
: (Required) Role.
lower_value
: (Required) The lowest number of losses required to gain the role.
upper_value
: (Required) The upper number of losses to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other loss autoroles will be allowed.
Removes a condition where player roles are changed based on MMR.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on MMR.
Usage: /autoroles mmr set [role] [lower_rating] [upper_rating] (lower_lose_rating) (only_one_allowed)
role
: (Required) Role.
lower_rating
: (Required) The lowest MMR required to gain the role.
upper_rating
: (Required) The upper MMR rating to lose the role.
lower_lose_rating
: (Optional) (Default: lower_rating) The MMR the player must fall below to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other MMR autoroles will be allowed.
Removes a condition where player roles are changed based on mvps.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on mvps.
role
: (Required) Role.
lower_value
: (Required) The lowest number of mvps required to gain the role.
upper_value
: (Required) The upper number of mvps to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other mvps autoroles will be allowed.
Toggle sending a DM to players when their rank autorole changes.
toggle
: (Required) If players get a DM for role/rank changes.
Options: Enabled, Disabled
Removes a condition where player roles are changed based on Points.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on points.
role
: (Required) Role.
lower_value
: (Required) The lowest number of points required to gain the role.
upper_value
: (Required) The upper number of points to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other Point autoroles will be allowed.
Recalculates all autoroles for players.
Delete all auto role settings.
Removes a condition where player roles are changed based on streaks.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on streaks.
role
: (Required) Role.
lower_value
: (Required) The lowest number of streaks required to gain the role.
upper_value
: (Required) The upper number of streaks to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other streaks autoroles will be allowed.
Removes a top player role.
role
: (Required) Enter the role.
Conditionally add/remove a role based on leaderboard position.
role
: (Required) Enter the role for the top players.
number
: (Required) Enter the number of players who can have this role.
Removes a condition where player roles are changed based on wins.
role
: (Required) Enter the role.
(Ranks) Adds a condition in which player roles are changed based on wins.
role
: (Required) Role.
lower_value
: (Required) The lowest number of wins required to gain the role.
upper_value
: (Required) The upper number of wins to lose the role.
only_one_allowed
: (Optional) (Default: True) If this role is assigned, no other wins autoroles will be allowed.
Specify roles to assign when users react to the message.
channel
: (Required) Channel where message is.
message_id
: (Required) Message to add reaction to.
role
: (Required) Role to assign/remove.
reaction
: (Required) Reaction that corresponds to this role.
remove_others
: (Optional) If the user has this role, remove all other reactionroles in the message they have.
queue_role
: (Optional) Option role for /roles
that the user will default to.
How players indicate they are ready to play a match.
mode
: (Required) How players show they are ready.
Options: Ready Up Button, Join Lobby Voice Channel, Disabled
(Default: true) Toggle the ability to rematch.
toggle
: (Required) If you want rematches to be enabled or disabled.
For queue types that always start when reaching the queue size, requeue priority won't appear to make any changes. However, there are two specific queue starting modes where it will matter:
/queuetype Matchmaking
: When the matchmaker is running, it will use the overall sum of all player priorities, and use this value to increase the matchmaking range. For example, if the matchmaking range is 300 MMR, but there are two players with 100 priority each, the matchmaking range for that attempted match creation will be 500 MMR, making it more likely for that match to be created. If you want players with priority to ALWAYS be in the match, you can give them a very large priority (like 100,000), which ensures the matchmaker always considers their match as valid./misc startwhen Forcestarted
: When matches can only be forcestarted, the number of players can exceed the maximum queue size. Players who join the queue with priority will take precedence in the queue over lower priority players.
Sets the condition for letting a player requeue.
condition
: (Required) Condition that must be met to requeue.
Options: Must Vote, Winner Selected, None
Delay people from queuing for the given duration after the condition is met.
seconds
: (Required) Seconds to delay from queuing.
Specify if players get automatically requeued if a match is cancelled.
mode
: (Required) If requeue is automatic.
Options: Disabled, Automatic
Give priority to players who requeue after a match.
value
: (Optional) (Default: 0) How much priority value to give.
seconds
: (Optional) (Default: 300) How many seconds to give this temporary priority value for.
Allow players with the given role to gain priority for requeue.
role
: (Required) Priority role.
value
: (Optional) (Default: 100) Priority value to assign.
Allow players with the given role to gain priority for requeue.
role
: (Required) Priority role.
(Default: false) Require if players must set their IGN before they can queue.
toggle
: (Required) If you want to require that users set their IGN.
Options: Enabled, Disabled
Sets the number of votes required for cancelling a game.
type
: (Required) The type of voting requirement to be used.
Options: Half, Majority, One, Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten
Sets the default number of votes required.
type
: (Required) The type of voting requirement to be used.
Options: Half, Majority, One, Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten
Sets the number of votes required for forcestarting a game.
type
: (Required) The type of voting requirement to be used.
Options: Half, Majority, One, Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten
Sets the number of votes required for getting MVP.
type
: (Required) The type of voting requirement to be used.
Options: Half, Majority, One, Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten
Sets the number of votes required for picking a winner.
type
: (Required) The type of voting requirement to be used.
Options: Half, Majority, One, Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten
Add a banned role which can't join the queue.
role
: (Required) Enter the banned role.
Removed a banned role.
role
: (Required) Enter the banned role.
Add a required role to enter this queue. Players can join if they have any of the roles.
role
: (Required) Enter the required role.
Removed a required role to enter this queue.
role
: (Required) Enter the required role.
Sets the channel to post match results.
channel
: (Required) Enter the desired channel.
(Default: None) Sets the roles for this queue, or omit to remove all.
roles
: (Optional) Enter the roles in the form Role,Role,Role,etc.
required
: (Optional) If roles are required to be chosen and enforced.
(BETA) Cancels your currently active schedule setup.
(BETA) Delete a previously scheduled command.
scheduled_command
: (Required) The scheduled command to remove.
(BETA) Toggle if the scheduled command should repeat each time daily.
scheduled_command
: (Required) -.
repeat
: (Optional) If times should repeat after execution.
Options: Enabled, Disabled
(BETA) Start scheduling the execution of any NeatQueue command.
(BETA) Specify an execution time for the scheduled command.
scheduled_command
: (Required) The scheduled command to add an execution time for.
time
: (Required) Time for the command to be executed.
timezone
: (Optional) (Default: /timezone) Respective timezone for the inputted time.
(BETA) List the scheduled times for the command.
scheduled_command
: (Required) The scheduled command to list execution times.
(BETA) Remove an execution time for the scheduled command.
scheduled_command
: (Required) The scheduled command to remove an execution time for.
time
: (Required) Time for the command to be executed.
Cancel the given game.
match_number
: (Required) The match number.
Sets the winner for the given game.
match_number
: (Required) The match number.
team_num
: (Required) The team that won.
Mark the given game as a tie.
match_number
: (Required) The match number.
Show how many games have been played by renaming the specified channel.
channel
: (Optional) Channel to rename, or omit to remove.
format
: (Optional) Format for channel name. Indicate a $ for the replacement. Ex: "Games: $".
Show how many players are in game by renaming the specified channel.
channel
: (Optional) Channel to rename, or omit to remove.
format
: (Optional) Format for channel name. Indicate a $ for the replacement. Ex: "In Game: $".
Show how many players are in queue by renaming the specified channel.
channel
: (Optional) Channel to rename, or omit to remove.
format
: (Optional) Format for channel name. Indicate a $ for the replacement. Ex: "In Queue: $".
Show the total number of players by renaming the specified channel.
channel
: (Optional) Channel to rename, or omit to remove.
format
: (Optional) Format for channel name. Indicate a $ for the replacement. Ex: "Players: $".
Show how many users are in the server by renaming the specified channel.
channel
: (Optional) Channel to rename, or omit to remove.
format
: (Optional) Format for channel name. Indicate a $ for the replacement. Ex: "Users: $".
View all queue names in the server.
Usage: /serverstats info (hidden)
hidden
: (Optional) If you want the stats to be hidden.
Starts the interactive setup.
(Default: '- ($)') Sets the format for ratings in nicknames.
format
: (Required) How the rating should be formatted. A '$' indicates the player's rating.
location
: (Required) -.
Options: Prefix, Suffix
Sets the queue names to use in retrieving player stats, or omit to reset.
names
: (Optional) The queue names separated by ',' to use for inserting ratings into '$' indicators in the format.
Removes all nicknames from all members.
Enable or disable showing player MMR in their nickname.
toggle
: (Required) If ratings should be shown in name.
Options: Enabled, Disabled
Simulate the MMR distribution for the current configuration.
players
: (Optional) The number of players to simulate.
matches
: (Optional) The number of matches to simulate.
Specify a spectator role which can join any voice channel.
role
: (Required) Spectator role.
can_speak
: (Optional) Can this role speak in the channel?.
Remove's a spectator role.
role
: (Required) Spectator role.
Add a staff role that grants access to commands.
role
: (Required) Staff role.
template
: (Required) If the role gets access to all commands or not.
Options: User Commands Only, All Commands
Grants the staff role access to the given command.
role
: (Required) Staff role.
command
: (Required) The command to grant access to.
Removes the staff role's access to the given command.
role
: (Required) Staff role.
command
: (Required) The command to remove access from.
List all configured staff roles.
Remove a staff role.
role
: (Required) Staff role.
Resets the staff role to starting permissions.
role
: (Required) Staff role.
Creates a queue using all players in the given channel.
voice_channel
: (Required) The voice channel to start a queue from.
Starts a queue for the current channel.
queuename
: (Required) Name for the queue.
teamsize
: (Required) Team size.
numberofteams
: (Optional) Number of teams in a match.
Removes the starting mmr for the given role.
role
: (Required) The role to remove starting MMR from.
Sets the starting mmr for the given role.
mmr
: (Required) The starting mmr value.
role
: (Optional) The role.
Sets whether stats are forced to be hidden (only shown to the user).
toggle
: (Required) If you want the stats to be always hidden.
Sets whether players can reshuffle teams in random team selection.
toggle
: (Required) Whether reshuffling is enabled or disabled.
Options: Enabled, Disabled
Choose how teams will be picked.
If team names should be the captains names, if applicable.
toggle
: (Required) Toggle team names being the captain's names.
Options: Enabled, Disabled
Specify the names of each team, or omit for the default behavior..
team_names
: (Optional) Comma separated list of team names. Ex: Team 1,Team 2,...
Sets the size for each team.
size
: (Required) The team size.
(Default: queue-$) Naming format for temporary setup channels.
name_format
: (Required) Channel format, where $ will be replaced with the match number.
Specify a permission to set for a role when creating the temporary channel.
role
: (Required) Role to modify permissions for.
permission
: (Required) Permission name.
value
: (Required) Permission value.
Options: Deny, Allow, Default
(Default: Enabled) Sets whether to create a temporary text channel for setup.
mode
: (Required) If the temporary setup channels are enabled.
Options: Enabled, Disabled
(Default: Text Channels) Specify if the temp channels are threads or normal channels.
type
: (Required) If the new channels should be text channels, or threads of this channel.
Options: Text Channels, Threads
Enables testing mode which allows for duplicate queue joining.
Sets whether tieing is an option for game outcomes.
toggle
: (Required) Whether to show the tie option.
Toggle kicking players for inactivity.
toggle
: (Required) Toggle.
timer
: (Optional) Enter the AFK timer in seconds (Default: 3600).
(Default: 5400) Sets the timeout before a running game is finished.
seconds
: (Required) Enter the time in SECONDS.
(Default: 3) Sets the delay for when a new queue message comes up.
seconds
: (Required) New message delay.
(Default: 3600) Sets the time before the queue is reset.
seconds
: (Required) Enter the time in SECONDS.
(Default: 60) Sets the timeout for voting menus.
seconds
: (Required) -.
(Default: 0) Sets the delay before enabling the winner voting message.
seconds
: (Required) Enter the time in SECONDS.
(Default: 'US/Eastern') Sets the server's timezone.
timezone
: (Required) Server's timezone.
Link your server to challonge using your username and api key.
challonge_username
: (Required) Challonge username.
challonge_api_key
: (Required) Challonge API Key from https://challonge.com/settings/developer.
(BETA) Toggle automatically creating new matches when ready.
mode
: (Required) Toggle automatically creating matches.
Options: Enabled, Disabled
(BETA) Toggle automatically starting the tournament when filled.
mode
: (Required) Toggle automatically starting on fill.
Options: Enabled, Disabled
(BETA) Change the tournament details shown in the queue message.
details
: (Optional) Tournament details, or omit to remove.
(BETA) Create a new tournament and shows signup buttons.
Usage: /tournament create [maximum_participants] (tournament_type) (auto_start_on_fill) (auto_create_matches) (team_size) (name) (url) (details) (forfeit_timer_sec) (hold_third_place_match)
maximum_participants
: (Required) Maximum number of teams that can register.
tournament_type
: (Optional) Tournament type.
Options: single_elimination, double_elimination, round_robin, swiss
auto_start_on_fill
: (Optional) Automatically start the tournament when the participant capacity is hit.
auto_create_matches
: (Optional) If the bot should automatically create matches when ready.
team_size
: (Optional) Number of players on each team.
name
: (Optional) The tournament name, also the name of the queue/stats storage for determining seeding.
url
: (Optional) Challonge tournament URL, or omit to auto generate.
details
: (Optional) Any extra details to show in the queue message.
forfeit_timer_sec
: (Optional) How longer players have to join the match (in seconds) before forfeiting.
hold_third_place_match
: (Optional) If a third place match should be played for single elimination tournaments.
(BETA) Deletes the tournament.
(BETA) Refresh necessary data from challonge and start any required matches.
(BETA) Start the tournament.
(BETA) Starts the next set of ready matches.
(Default: After All Setup) Sets when to move players to team voice channels.
when
: (Required) When to move players to team channels.
Options: After All Setup, After Teams Created
Specify a permission to set for a role when creating voice channels.
role
: (Required) Role to modify permissions for.
permission
: (Required) Permission name.
value
: (Required) Permission value.
Options: Deny, Allow, Default
(Default: Enabled) Toggle creating separate voice channels for each team.
toggle
: (Required) If channels are created per team.
Options: Enabled, Disabled
Add a new voting menu.
Usage: /votingmenu add [title] [options] [key] [team_voting] (order) (button_colors) (show_numbers) (allow_random) (force_random) (number_of_votes)
title
: (Required) (Ex: Vote for the Region) The title for the vote.
options
: (Required) (Ex: NA,EU) Comma separated list of options. Ignored if options_variable exists with values.
key
: (Required) (Ex: Region Name) The key for this vote for displaying the result after.
team_voting
: (Required) Is the vote once per team, once for all teams, or for a specific team?.
order
: (Optional) (Ex: 1) The order for this vote in regard to other votes. Votes will occur in ascending order.
button_colors
: (Optional) (Ex: blurple,red) Comma separated list of button colors. Valid options: blurple, gray, green, red.
show_numbers
: (Optional) If each option should have a number associated with it when displayed.
allow_random
: (Optional) If a 'random' option is included in the vote.
force_random
: (Optional) If you want to skip the vote altogether and just pick a random option.
number_of_votes
: (Optional) Number of votes per player.
Remove the given voting menu.
title_and_order
: (Required) Title and corresponding order of voting menu to delete.
Webhooks receive information about a match as it is being setup. Currently supported actions are:
- MATCH_STARTED
- TEAMS_CREATED
- MATCH_COMPLETED
Additionally, if you have
/requireregister mode: Custom API
, you will receive a webhook with action
- REGISTER_PLAYER
containing various information about the user, as well as the account they are attempting to register. You must either reply with a json object containing at least a "rating" key (ex: {"rating": 1000}), to specify the rating that the player should be registered with, or any non 200 status response to display to the user.
Examples: https://webhook.site/#!/695c599b-fc6d-4a23-aaee-ce170e355fb3/7051d907-b47b-4b05-acc8-96464fa6c565/1
Add a new webhook to receive queue information.
url
: (Required) Your webhook url.
Delete this queue's webhook.
Generate an API token for your account.