Queue System

Commands

Commands

Players have no commands — everything happens on the connection screen. You manage the queue from the server console.

What players see

Animated designs (Highway / Boarding / Race):

Element What it does
Scene Your car / plane in line, with the ones ahead of you; tagged YOU
Position Big number, animated every time you move up
IN QUEUE / PRIORITY Time waiting and your priority role
Queue list The first 10 in line, then "N more"; your own row is highlighted and always shows
Discord button Opens your Discord invite (Interface.Elements.DiscordInvite)
Queue Chat button Chat with the other players waiting (Server.ChatEnabled)

Classic design: queue position, priority, a queue list button, Discord and Queue Chat buttons.

Server console commands

All of them work only from the server console (txAdmin console / FXServer window).

Command What it does
queuestatus Players / max slots, queue size, players loading in, test mode on/off
queuelist Everyone in the queue with their priority and minutes waiting
pushqueue [count] Lets the first count players (default 1) skip the waiting timers. Capacity is still respected: if the server is full they go in as soon as a slot opens
queuetest Test mode on/off: everyone is held in the queue, to see the cards with free slots
queuefill [count] Adds fake players (default 10, max 100) to see a long list. Test mode only
queueclear Removes the fake players. Test mode only

Typical look check: queuetest → queuefill 20 → connect → queueclear → queuetest.

Hidden mechanics

  • Reconnect grace — a player who crashes or times out after playing at least 5 minutes gets Priority.ReconnectGrace.BonusPoints on their next connection within Duration seconds. Quitting on purpose (F8 quit, Exiting) doesn't count, and more than 3 "crashes" in an hour stop the bonus.
  • Silent ban — players with any Priority.PermanentQueue.Roles Discord role go through the normal queue but NEVER get connected. For them, the server is just "very busy".
  • Always first — accounts in Priority.AlwaysFirst go to the front of the line.
  • Force queue — with ForceQueue.Enabled = true, every connection sees the queue for at least Server.MinQueueTime seconds, even on an empty server.
  • Back-in protection — a player who leaves the queue and reconnects within 2 minutes goes back in line instead of skipping it.

Server logs

Setting What it does
Server.LogToConsole = true Connect / queue / join events in the server console
LiveEmbed.Enabled = true Live-updating Discord embed in your channel (webhook in server.cfg)

Exports (server)

-- Everyone in the queue, in order
local list = exports['suty-queue']:getQueueList()
-- { { position = 1, name = 'Player', priority = 150010, prioLabel = 'VIP', timeInQueue = 42 }, ... }

-- Frees the "loading in" slot of a license (e.g. from a multicharacter script when a player backs out)
exports['suty-queue']:removePlayerJoining('license:xxxxxxxx')

Merry Christmas.

From Suty.