Content generated with AI — it may contain mistakes.

ExyliaPracticeCore/GuidesUpdated in v1.4.0

Set up the queue and matchmaking

Let players queue for several kits at once, tune how wide the rating search gets, and see exactly how two players are paired.

Page 11 of 356 min read

The queue pairs two players who want the same kit, in the lobby, without anyone sending a challenge. By the end of this page the queue works for your kits and you know which knobs change who meets whom.

Before you start#

  • A category and a kit with Queue on in Playability & ranked, and an arena linked to it: see Play your first match.
  • The lobby spawn is set: /epc → Set lobby spawn.
  • For ranked kits, how ratings work: ELO and ranks.

Steps#

Make the kit queueable

/epc → Manage kits → All kits → your kit → Playability & ranked. Turn on Queue. Turn on Ranked only if the kit should move ELO. A kit that is disabled, or has Queue off, never shows in the queue menu.

Queue as a player

Run /queue (or /q, or use the Queues item in the lobby hotbar). Pick a category, then a kit. Clicking a kit joins its queue and clicking it again leaves only that one. /queue <category> skips the category list; the id tab-completes.

Queue for several kits at once

Keep clicking kits. The player stays in the lobby, free to walk around, with an action bar showing the kits, the elapsed time and the rating band being searched. More than three kits collapse to first, second, third +N.

Leave or rejoin

/leavequeue leaves every queue, and the hotbar item Leave queue appears while queued. /requeue rejoins every kit the player was queued for when their last match started.

Choose how long a match is

In config.yml, queue.rounds-to-win is the rounds a player needs to take a queue match, ranked or not: 1 is a single fight, 2 is best of 3, 3 is best of 5 (range 1 to 10). A kit can set its own under Kit rules → Win conditions.

CommandWhat it does
/queue, /qOpen the queue menu
/queue <category>Open one category's kits
/quickqueue, /qq, /quick-queueJoin a random kit that already has somebody waiting; if nobody is waiting, any enabled kit
/requeue, /rqRejoin every kit you were queued for when your last match started
/leavequeue, /lqLeave every queue
Ranked needs a permission, and everybody has it

Joining a ranked kit's queue needs exyliapractice.queue.ranked, which every player holds by default. Remove it from a group to keep them on unranked kits: the ranked kit is refused and /quickqueue only picks unranked ones. Leaving a queue never needs it.

Check that it works#

  • With two accounts on different IPs, queue both for the kit. Within a second or two both get a match found title and are sent to the arena.
  • /queue lists your category and kit. If the kit is missing, it is disabled, has no category, or Queue is off.
  • If two players wait forever, read How a match is found, then Common problems. On a test server the anti-boost same-IP check is the usual cause.

How a match is found#

The queue ticks once a second. For each kit with two or more players waiting:

Sort by rating

Everybody waiting for that kit is sorted by their MMR on it.

Walk adjacent pairs

Only neighbours in that sorted list are considered: the closest possible ratings first.

Check the radius

The pair matches if their rating difference is within the wider of their two search radii.

Check anti-boosting

Same IP, or having played each other too recently, refuses the pair. See ELO.

Take them

The pair is removed from every queue they were in, both are claimed, and the match starts. Their queue list is saved first so /requeue can rebuild it.

Unranked kits skip the rating checks

A kit that is not ranked has no ELO at stake: any two players waiting on it are paired, the radius and anti-boosting checks are skipped, and the action bar reads any rank.

The search radius#

It starts at elo.matchmaking-base-radius and widens by elo.matchmaking-expand-rate every elo.matchmaking-expand-interval-seconds, up to elo.matchmaking-max-radius.

SettingDefaultMeaning
matchmaking-base-radius150MMR either side, at the moment of queueing
matchmaking-expand-rate50Added per interval
matchmaking-expand-interval-seconds15How often it widens
matchmaking-max-radius600The ceiling
matchmaking-ignore-elofalseWhen true, any two players match and the action bar reads any rank

With the defaults a player starts searching at ±150 and reaches the ±600 ceiling after 2m15s.

The band shown is the first kit you queued for

The action bar renders one rating band, taken from the kit the player joined first. Someone queued for a kit where they are Copper and another where they are Nova sees the Copper band. Matchmaking still uses the correct per-kit rating for each queue.

Going further#

Who cannot join

/queue refuses when any of these is true:

  • The player is not free: in a match, editing a kit, spectating, in a party (queue as a party in a party duel instead), or claimed by another plugin.
  • Their stats have not finished loading from the database.
  • The queue is locked, which happens during a season rotation.
  • No lobby spawn is set.
  • The kit is disabled, or has Queue turned off.
  • No arena is available for the kit right now.
The teaser bar

When somebody is waiting, everyone else in the lobby sees a boss bar naming them and the kits they wait on, with each kit's rank icon. It rotates through the queued players one at a time.

SettingDefaultMeaning
queue.teaser-enabledtrueTurns the whole thing off
queue.teaser-rotation-seconds5How long each player is featured
queue.teaser-max-kits-shown3Kits listed before it collapses to +N with the global rank

The bar is only shown to players who could act on it: available, queued, editing a kit, or in a PvP zone. Nobody in a match is offered a queue they cannot join.

The wait between finding and fighting

Once a pair is found both players get a match found title and a loading action bar. If an arena had to be cloned, that is where the paste happens. If a free arena already existed, the plugin still waits queue.no-clone-extra-delay ticks (40 by default, two seconds) so a match found instantly does not feel like a teleport glitch.

Something missing on this page? Tell us on Discord