| Bot is offline / queue never loads roles | The token is wrong, or the bot was kicked from your guild. Reset the token in the Discord Developer Portal and paste the new one into Config.Server.DiscordBotToken. |
Everyone is queued as Standard with priority 0 | Server Members Intent is OFF. Turn it on in the bot’s settings (see Discord setup, step 2) and restart the resource. |
| Whitelist is on and everyone is being kicked | Same as above — without Server Members Intent the bot can’t see role memberships, so no one passes the whitelist. |
| Players bypass the queue when they shouldn’t | A role ID in Config.Permissions.BypassRoles is too broad (e.g. @everyone’s ID, or a “Member” role everyone holds). Remove it. |
| The live waitlist embed never shows up | EnableLiveFeed = false, the channel ID is wrong, or the bot is missing View Channel / Send Messages in that channel. |
| The live feed posts but never updates | The bot doesn’t have Manage Messages in the channel — it can’t edit its own message, so it stops trying. |
| Wrong tier shown on the card | Config.Tiers is order-dependent. The first entry whose role the player holds wins. Reorder so the highest tier is at the top. |
| Priority isn’t ordering correctly | Check that the role IDs in Config.Permissions.PriorityLevels are keys (["123"] = 5000), not array entries. The numbers add up across roles — a player with multiple priority roles will outrank a single high-tier role. |
Server feels full but I have ReservedSlots = 2 set | That is the point — those 2 slots are kept open for staff with BypassRoles. Lower the number to free them for regular players. |
| Players get stuck at “Connecting” after their position hits #1 | Increase Config.Server.HaltDuration so the slot stays reserved longer while they load. Common on heavily-modded servers. |
Config.Interface.Theme = "neon" does nothing | "neon" isn’t a built-in theme. Use one of: classic, banner, factset, boardingpass, compactbar, minimal, centered, cards. |
| Banner / icon doesn’t load | Image host is rate-limiting or the URL 404s. Try the URL in a browser — if it doesn’t load there, it won’t load on the card. |
| Two queues are fighting / players get kicked instantly | Another queue resource (e.g. connectqueue) is also running. Stop one of them. |
| Token got pasted into a screenshot | Reset it immediately in the Discord Developer Portal and update config.lua. |
