Queue System
Queue System
Advanced connection queue with Discord-role priority, silent-ban, live embed, and reconnect grace
🎟️ suty-queue
Production-grade FiveM connection queue. Discord-bot-driven priority tiers (Owners, Admins, VIPs, milestone-based player progression), silent-ban for cheaters who stay in queue forever without knowing it, reconnect grace, live Discord embed showing the full queue, and dynamic connection-delay tiers.
✨ Key Features
- 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)
- Reconnect grace — disconnected players reconnect within window with bonus points (no re-queue)
- Silent-ban / "permanent queue" — players with a flagged role NEVER leave the queue, even with empty slots. They see normal queue UI but never join.
- Force-queue mode — all players go through queue regardless of server fullness (for welcome card branding)
- Dynamic connection delay —
connectionDelayscales by slot count (more slots free = faster cycle) - Live Discord embed — auto-updates a Discord channel embed with current queue state every 3s
- Multi-language — Spanish + English locales
- Whitelist gating — require Discord role to even enter the queue
📦 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 |
