Queue System
Queue System
Connection queue with animated queue cards, Discord-role priority, silent-ban, live embed and reconnect grace
🎟️ suty-queue
FiveM connection queue that players actually enjoy waiting in. While they wait, they see an animated scene with their place in line. Priority comes from Discord roles. Cheaters can be silent-banned so they stay in line forever. Players who crash get back in fast, and a live Discord embed shows the whole queue.
✨ Key Features
- Animated queue cards — pick a scene with
QueueConfig.Interface.Design:- 🛣️ Highway (
'autopista') — your car in line at night, driving into the city - ✈️ Boarding (
'embarque') — your plane landing at sunset by the coast - 🏁 Race (
'carrera') — a night Grand Prix, your car on the starting grid - 📋 Classic (
'classic') — the original card
- 🛣️ Highway (
- What every player sees — their position in big numbers (animated when they move up), time in queue, priority, the first 10 in line plus "N more", and Discord + Queue Chat buttons
- Your branding — your server name on the sign and your own colors (
Sign,Accent,Accent2) - Discord-role priority — fetch role membership via bot, weight queue position by role values
- Stacked priority — multiple roles add up (e.g. VIP + Streamer + Booster)
- Always first — list Discord accounts (e.g. the owner) that always go first in line
- Reconnect grace — players who crash reconnect within the window with bonus points
- Silent-ban / "permanent queue" — players with a flagged role NEVER leave the queue, even with empty slots. They see the normal queue but never join.
- Force-queue mode — every player goes through the queue even when the server has room (for branding)
- Dynamic connection delay — the delay between connections scales with free slots
- Live Discord embed — a channel embed that updates with the current queue
- Queue chat — players can talk while they wait
- Your secrets stay safe — the bot token and webhook go in
server.cfg, not in the config - Multi-language — English + Spanish locales (editable)
- Whitelist gating — require a Discord role to enter
📦 Requirements
- Discord bot token + your Discord server (guild) ID
- Discord roles configured for each priority tier
- Any framework (queue runs server-wide, framework-agnostic for queue logic)
🌐 Compatibility
| Framework | Status |
|---|---|
| Standalone | ✅ Queue is framework-agnostic |
| QBX Core / QB-Core / ESX | ✅ Works alongside any |
🆕 What's new in 1.6.0
- The three animated scenes (Highway, Boarding, Race) + options
Design,Brand,Sign,Accent,Accent2 - The queue list on the card shows the first 10 and "N more"; your own row always shows
- The bot token and live embed webhook moved to
server.cfg(orsecrets.lua) — see Installation - New
QueueConfig.Priority.AlwaysFirst - Lighter on the server: the animated card is only resent when something on it changes
- If a scene ever fails to draw, the player gets the classic card instead of waiting forever
