Tasers handle one escalation level. Pepper spray handles another — the non-lethal option that keeps a suspect upright but buying time for cuffs. This script adds weapon_pepperspray as a real addon weapon, not a re-skin. It registers hit detection on actual player contacts, applies a configurable paralysis effect, and locks usage behind a job check so civilians can’t pick it up and run wild.

How the Effect Works

When a sprayed player takes a hit inside the configured cone and range, the paralysis kicks in for a set duration. The intensity, duration, range, and spray angle are all config values, so a roleplay-light server can keep it subtle while a heavier simulation server can make it genuinely incapacitating. Players with a compatible gas mask (via skinchanger immunity flag) are immune — meaning the gear system you already have actually matters in confrontations.

Addon weapon registered as weapon_pepperspray — functions like any native weapon
Hit detection on real player contacts within a configurable cone and range
Configurable paralysis duration, intensity, and spray angle
Job check for ESX and QBCore — restrict to police or any custom job
Skinchanger-compatible immunity for gas mask items
Bridge functions exposed for encrypted version — hook into your own events without editing core files
Performance: 0.00ms idle / 0.03ms maximum when actively used

Framework & Compatibility Notes

Runs standalone with ESX, QBCore, and Qbox job-check bridges pre-built. Note: CodeM-Inventory has a known conflict — all other major inventory setups are unaffected.

Where It Fits on Your Server

Pepper spray fills the force-escalation gap between verbal commands and a taser. It gives officers a tool that works on foot pursuits and close-quarters situations where a taser would be overkill — and it costs almost nothing in resmon. At 0.03ms peak, the entire resource uses less CPU than most notification libraries sitting idle. If your server takes police interactions seriously, this is a logical addition to any LEO loadout.