Queues and ranked

Set which kits appear in casual and ranked queues, how matchmaking widens its search, and how Duels ratings and divisions work.

Casual and ranked queues

Players join queues from the lobby:

/play opens the team size menu for casual. /play ranked opens it for ranked.
/casual (or /unranked) and /ranked open the queue menu for that type.
The first two hotbar slots in the lobby open casual and ranked.

A party leader queues the whole party. Other party members cannot join a queue themselves.

A player can be in up to 4 queues at once. Change this with queue.maxQueues in plugins/Scaffold/settings.yml.

Which kits are in which queue

Each kit's QueueSizes flag lists the team sizes and queue types it appears in. The format is size:types, separated by commas, with + between types.

Value	Meaning
`1:casual+ranked`	1v1 in casual and ranked. This is the default for every kit.
`1:casual`	1v1 casual only.
`2:casual,3:ranked`	2v2 casual and 3v3 ranked.

/kit features add sumo QueueSizes
/kit features metadata add sumo QueueSizes sizes 1:casual+ranked,2:casual

Disabled kits and kits a player's client cannot use are hidden from the menus. See Kits.

Matchmaking

Matchmaking runs on the game servers. One game server does the work at a time. If it stops, another takes over within a few seconds.

Ranked players are matched by rating. Each player starts with a search range around their rating that grows while they wait. These keys are in plugins/Scaffold/settings.yml:

Key	Default	Meaning
`queue.eloRange`	`10`	Starting range, in rating points either side.
`queue.eloRangeGrowth`	`1.5`	The range is multiplied by this each time it grows.
`queue.eloRangeIntervalMillis`	`1500`	How often the range grows, in milliseconds.
`queue.eloRangeLimit`	`2000`	Largest range.
`queue.sendDelayTicks`	`60`	Delay between a match being found and the players being sent, in ticks.

Players are paired with someone from their own region first. See How servers find each other.

Ranked access

Ranked needs the duels.ranked permission. Players without it get a message when they try to queue ranked. Grant it to the ranks that should play ranked.

Staff with duels.admin can close ranked for everyone from /duels ranked. While ranked is closed, only operators can still queue it. Click the same button to open it again.

Ratings

Every kit has its own rating. New players start at 1400 and play 10 placement matches before their division is shown.

Pick the rating system in /duels ranked:

System	Notes
Glicko-2	The default.
Regular Elo
MMR

Switching asks for confirmation. Players keep their ratings, but pending promotions and demotions are cleared. Switching to Glicko-2 also resets every player's rating deviation and volatility.

/duels overall rebuilds the overall rating ladder from every kit.

Divisions

Division	Rating from
Bronze V to Bronze I	788
Silver V to Silver I	1170.5
Gold V to Gold I	1553
Emerald V to Emerald I	1935.5
Diamond V to Diamond I	2318
Masters	2700

Division names can be changed in common-messages.yml.

When both players in a ranked match are in one of the top divisions, the start of the match is announced to the network. match.highRankAlertDivisions in the game server's settings.yml sets how many divisions count as top. It is 3 by default; 0 turns it off.