Pepper Spray as a Real Addon Weapon

This script adds pepper spray to your server as a proper addon weapon, weapon_pepperspray, that players equip and fire like any other gun. Whenever the spray hits another player, the script picks it up and applies a configurable effect that temporarily paralyses the target.

It is fully standalone and needs no other scripts to run. On ESX and QBCore a built-in job check makes sure only police can actually apply the pepper spray effect, so the weapon stays a law enforcement tool rather than a griefing item.

Tune It to Your Server

• The pepper spray effect itself is configurable, along with the total effect time.
• The maximum range and the angle relative to the target can both be set, so you decide exactly when a spray connects.

Performance

The script runs at 0.00 ms while idle and peaks at 0.03 ms only while a pepper spray effect is active.

Clothing Immunity

If you run skinchanger, you can mark pieces of clothing that grant immunity to the spray, think gas masks or riot gear from your own wardrobe setup. The immunity function is accessible, so other skin resources can be wired in as well.

Escrow and Bridge Code

The normal version ships encrypted, but the key functions stay reachable through bridge code, so you can still hook the effect and immunity logic into your own resources.

Known Limitation

CodeM-Inventory is known to not work properly with the pepper spray. We cannot offer support for that combination.