Configuration · JM Modifications

All configuration lives in config.lua, which is the only file you need to edit for day-to-day customisation.

Core Settings#

Option	Default	Description
`Config.Debug`	`false`	Enables additional console logging for troubleshooting.
`Config.Version`	`"1.0.0"`	Script version string — do not change.

Road Rage Settings#

Option	Default	Description
`Config.RoadRageChance`	`15`	Percentage chance (1–100) that road rage triggers when conditions are met.
`Config.TriggerDistance`	`20.0`	Radius in game units within which nearby vehicles are checked.
`Config.RageTimeout`	`30000`	Milliseconds before an enraged NPC calms down.
`Config.MaxRageNPCs`	`5`	Maximum number of road rage NPCs active at the same time.
`Config.InjuryChance`	`30`	Percentage chance the player receives an injury when damaged by an enraged NPC.

NPC Behaviour Settings#

Option	Default	Description
`Config.AttackChance`	`70`	Percentage chance the NPC attacks rather than just yelling.
`Config.WeaponChance`	`40`	Percentage chance an attacking NPC draws a weapon instead of using fists.
`Config.FleeChance`	`20`	Percentage chance the NPC flees after the rage timeout.

Weapon Settings#

Config.RageWeapons is the list of weapons NPCs may use. The resource ships with thirteen entries including melee weapons, pistols, and thrown weapons. Add or remove entries using the exact weapon hash name:

Config.RageWeapons = {    'WEAPON_KNIFE',    'WEAPON_BAT',    'WEAPON_PISTOL',    -- add more here}

Config.BlacklistedWeapons lists weapons NPCs will never use regardless of Config.RageWeapons. The defaults exclude all explosive, launcher, and area-of-effect weapons. Add any weapon you want permanently banned:

Config.BlacklistedWeapons = {    'WEAPON_RPG',    'WEAPON_MINIGUN',    'WEAPON_GRENADE',    -- add more here}

Warning

If a weapon appears in both lists, the blacklist wins — it will never be given to an NPC.

Police Integration#

Option	Default	Description
`Config.PoliceNotifyChance`	`80`	Percentage chance police are notified when road rage triggers.
`Config.PoliceJob`	`'police'`	QBCore job name for police. Change this if your server uses a different name.
`Config.PoliceResponseTime`	`120000`	Milliseconds before the player receives a police-response notification.
`Config.MinPoliceOnline`	`2`	Minimum number of on-duty police required for a notification to be sent.

Safe Zones#

Config.BlacklistedAreas defines coordinates and radii where road rage will never trigger. The defaults cover the hospital, police station, and airport:

Config.BlacklistedAreas = {    {x = -545.0, y = -204.0, z = 38.0, radius = 100.0}, -- Hospital    {x = 440.0,  y = -982.0, z = 30.0, radius = 150.0}, -- Police Station    {x = -1037.0, y = -2737.0, z = 20.0, radius = 200.0}, -- Airport    -- Add custom zones here}

Sound Settings#

Option	Default	Description
`Config.UseCustomSounds`	`true`	Plays ambient speech from `Config.RageSounds` when road rage triggers.
`Config.RageSounds`	(list)	Speech parameter names played on the NPC when it becomes enraged.

Troll Cops#

The Troll Cops feature is a comedic, admin-only tool. It is disabled by default and should stay disabled on serious RP servers.

Option	Default	Description
`Config.TrollCops.enabled`	`false`	Master toggle. Must be `true` for `/trollcops` to work.
`Config.TrollCops.triggerChance`	`5`	Percentage chance troll cops trigger automatically (rarely used).
`Config.TrollCops.copCount`	`{min=2, max=4}`	Range for how many troll cops spawn.
`Config.TrollCops.spawnDistance`	`50.0`	Distance from the player at which cops spawn.
`Config.TrollCops.shootDuration`	`15000`	Milliseconds the cops actively attack before fleeing.
`Config.TrollCops.disappearTime`	`30000`	Milliseconds before spawned cops are deleted.
`Config.TrollCops.cooldown`	`300000`	Milliseconds between troll cop events (5 minutes).
`Config.TrollCops.maxPerSession`	`3`	Maximum troll cop events allowed per server session.
`Config.TrollCops.useBlips`	`true`	Shows red map blips for spawned troll cops.
`Config.TrollCops.useSirens`	`true`	Plays a police siren sound when troll cops spawn.
`Config.TrollCops.logToDiscord`	`true`	Logs troll cop events to the Discord webhook.

Jurisdictions restrict where troll cops can operate. Each entry has a name, coordinates, radius, and an enabled flag:

Config.TrollCops.jurisdictions = {    {        name    = "Sandy Shores Sheriff",        coords  = {x = 1853.0, y = 3686.0, z = 34.0},        radius  = 500.0,        enabled = true    },    -- add custom zones here}

Discord Webhook Integration#

Option	Default	Description
`Config.Discord.enabled`	`true`	Set to `false` to disable all Discord logging.
`Config.Discord.webhook`	`""`	Your Discord webhook URL. Required when `enabled = true`.
`Config.Discord.botName`	`"Road Rage Bot"`	Display name of the webhook bot in Discord.
`Config.Discord.serverName`	`"Your Server Name"`	Appears in the embed footer. Change this to your server name.

Control which events are logged:

Event key	Default	What it logs
`roadRageIncidents`	`true`	Each road rage trigger.
`policeNotifications`	`true`	Each police dispatch.
`playerInjuries`	`true`	Each player injury.
`adminActions`	`true`	Each admin command use.
`systemStats`	`false`	Hourly system statistics (high volume — keep disabled unless needed).

See the Discord Logging page for full setup instructions.