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.BonusPointson their next connection withinDurationseconds. Quitting on purpose (F8quit, Exiting) doesn't count, and more than 3 "crashes" in an hour stop the bonus. - Silent ban — players with any
Priority.PermanentQueue.RolesDiscord role go through the normal queue but NEVER get connected. For them, the server is just "very busy". - Always first — accounts in
Priority.AlwaysFirstgo to the front of the line. - Force queue — with
ForceQueue.Enabled = true, every connection sees the queue for at leastServer.MinQueueTimeseconds, 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')
