Suty
Queue System

Troubleshooting

Troubleshooting

Players see "License not found" or "Discord not found"

  • QueueConfig.DiscordBot.RequireLink = true requires every player to have linked Discord on FiveM. Players with no Discord linked get rejected.
  • For testing, set RequireLink = false to allow connections without Discord.

Players see "Not whitelisted" / "Not in Discord"

  • They're missing the WhitelistRole Discord role
  • OR they're not in your Discord guild (MustBeInServer = true)
  • Confirm by manually checking their Discord — do they have the role? Are they in the server?
  • Verify the bot can READ members: bot has View Members permission AND Server Members Intent is enabled in the Developer Portal

Bot token invalid

Test by querying:

GET https://discord.com/api/v10/guilds/<GUILD_ID>/members/<USER_ID>
Authorization: Bot <BOT_TOKEN>

401 = bad token. 403 = bot lacks permissions. 404 = wrong guild or user.

Priority not stacking

QueueConfig.Priority.CombinePoints = true — must be true for stacking. With false, only the highest single role's value counts.

Live embed isn't updating

  • QueueConfig.LiveEmbed.Enabled = true
  • WebhookURL is valid (paste in browser → should return JSON, not error)
  • UpdateInterval >= 3 — Discord rate-limits webhooks. Lower than 3 seconds will get rate-limited and silently drop updates

Reconnect grace doesn't work

  • Priority.ReconnectGrace.Enabled = true
  • Duration is in seconds — 3000 = 50 minutes (NOT milliseconds)
  • The reconnecting player must use the SAME license — different account = no grace

"Silent banned" player still got in

  • Their Discord role must EXACTLY match an entry in Priority.PermanentQueue.Roles
  • The bot must be able to see the role assignment (members intent)
  • Test by setting their role and checking Server.LogToConsole = true — you should see them queued but never connected

Server doesn't queue at all

  • suty-queue must boot BEFORE the framework. Check server.cfg ensure order.
  • sv_maxclients must be set
  • If ForceQueue.Enabled = false (default), queue only triggers when server is full

Dynamic delay seems wrong

DynamicDelayTiers is sorted by slots descending (more slots = first match). Make sure your tier list is in the right order. The delay is in seconds between connection-cycle ticks.

Still stuck?

Discord — include QueueConfig.DiscordBot.Active, whether you're using whitelist, and a relevant server console snippet.