Installation

Follow these steps to get JM-NPCRoadRage running on your server.

Requirements#

Before you start, confirm you have the following already installed and working:

• FiveM server build 4752 or higher
• QBCore framework
• qb-policejob
• qb-ambulancejob

Step 1 — Place the Resource#

Copy the JM-NPCRoadRage folder into your server's resources directory. The final path should look like:

resources/└── JM-NPCRoadRage/    ├── fxmanifest.lua    ├── config.lua    └── ...

Step 2 — Add to server.cfg#

Open your server.cfg and add the ensure lines in the correct order. Dependencies must load first:

# Dependenciesensure qb-coreensure qb-policejobensure qb-ambulancejob​# JM Modificationsensure JM-NPCRoadRage

Step 3 — Configure the Resource#

Open config.lua and adjust the settings to match your server. At minimum, review:

• Config.RoadRageChance — how often road rage triggers.
• Config.PoliceJob — must match your QBCore police job name.
• Config.Discord.webhook — paste your webhook URL here if you want Discord logging.

See the Configuration page for a full reference.

Step 4 — Optional Database Setup#

An optional database.sql file is included. Importing it creates an npc_road_rage_incidents table that allows the /npcrage-history command to return real data. If you skip this step the resource still works fully — incident history will return empty results.

-- Run this in your MySQL client against your server's databaseSOURCE /path/to/JM-NPCRoadRage/database.sql;

See the Database page for details.

Step 5 — Restart and Verify#

Start or restart your server. In the server console you should see:

[JM-NPCRoadRage] Client loaded successfully![JM-NPCRoadRage] Weapon filtering: X/Y weapons allowed[JM-NPCRoadRage] Server script loaded successfully!

If you see errors instead, check the Troubleshooting page.