Troubleshooting

"No tienes permisos" — admins can't run /comserv

If useDiscordWhitelist = true:

1. The admin's Discord ID must be linked to their FiveM account (license)
2. They must be IN the guild specified by Config.Discord.guildId
3. Their Discord role ID must appear in Config.Permissions.discordRoles
4. The bot token must have View Members permission on the guild

If useDiscordWhitelist = false, they need one of Config.Permissions.allowedGroups ACE groups.

Discord role check always fails

The bot token is invalid or the guild ID is wrong. Test by querying:

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

If you get a 401/403, the token or permissions are wrong.

Player escapes — auto-teleport doesn't fire

• Config.MaxDistance is too high — drop it (default 60.0 meters)
• The service area is overlapping a no-collision zone — pick a different Config.ServiceLocation

Routing bucket isn't isolating

Config.PunishmentBucket = 999 — make sure no other resource is using bucket 999. If you have a custom routing system, pick a unique bucket ID.

Tasks never complete / skill-check broken

• Config.SkillCheck.enabled = true
• Config.SkillCheck.difficulty must contain at least one valid difficulty ('easy', 'medium', 'hard')
• Config.SkillCheck.inputs must be valid key letters

Disable temporarily to confirm: Config.SkillCheck.enabled = false — tasks then complete on touch.

Weapons aren't stripped on release

• Config.RemoveWeaponsOnCompletion = true
• ox_inventory is started (the strip uses ox_inventory exports)
• The release happened via task completion OR /endcoms (manual escape via routing bucket bypass won't trigger it)

Chat announcements don't show

• Config.ChatAnnouncement.enabled = true
• The specific event toggle (onAssignment, onCompletion, onRelease) is also true

Still stuck?

Discord — include your Config.Framework, whether Discord or ACE permissions are in use, and which step in the flow is failing.