Troubleshooting

Check the server console first — JM-NPCRoadRage logs startup messages and errors with the prefix [JM-NPCRoadRage].

Resource Fails to Start#

• Confirm all three dependencies (qb-core, qb-policejob, qb-ambulancejob) are listed above JM-NPCRoadRage in server.cfg.
• Verify the folder name matches the ensure line exactly — names are case-sensitive on Linux.
• Check that fxmanifest.lua is present and has not been accidentally modified.

NPCs Are Not Reacting#

• Make sure you are inside a vehicle — the road rage detection only runs while the player is driving.
• Confirm your location is not inside one of the Config.BlacklistedAreas safe zones (hospital, police station, airport by default).
• Check Config.RoadRageChance — the default is 15 %, so rage will not trigger every collision. Use /testrage to force a trigger for testing.
• Verify Config.MaxRageNPCs has not been reached. Use /ragestats to see how many are currently active.

Police Are Never Notified#

• Config.MinPoliceOnline defaults to 2. If fewer than two officers with the police job are on duty, no alert is sent.
• Check Config.PoliceJob matches the exact QBCore job name your server uses.
• Config.PoliceNotifyChance is 80 % by default — it will occasionally not trigger. Use /testrage multiple times to confirm.

Discord Webhook Not Posting#

• Confirm Config.Discord.enabled = true and that the webhook URL is correctly pasted with no extra spaces.
• Check the server console for HTTP error codes after an incident fires.
• Verify the relevant event type is set to true in Config.Discord.logEvents.
• If logs appear to stop after a burst of activity, spam prevention may be throttling them — check spamPrevention.cooldownTime and maxLogsPerMinute.

Admin Commands Not Working#

• The player's QBCore job must be admin, or they must have the QBCore admin permission level.
• Confirm client/commands.lua and server/commands.lua are loading without errors.

Troll Cops Not Spawning#

• Config.TrollCops.enabled must be true.
• You must be standing inside an enabled jurisdiction zone. Use /trollcopinfo to see which jurisdiction (if any) you are currently in.
• The cooldown (Config.TrollCops.cooldown, default 5 minutes) or session cap (maxPerSession, default 3) may have been reached.

Weapon Blacklist Issues#

• Use /weaponinfo to see exactly how many weapons passed the filter and how many were removed.
• If NPCs only use fists, your allowed weapon list may be empty — all entries in Config.RageWeapons may be present in Config.BlacklistedWeapons. Remove them from the blacklist or add different weapons to the rage list.