Advanced Pepper Spray

Advanced Pepper Spray - Professional Non-Lethal Control System

The Advanced Pepper Spray system brings realistic less-lethal force options to your FiveM server. This comprehensive script goes beyond basic pepper spray mechanics by introducing a complete decontamination system, recovery mechanics, and protective equipment. Whether you're running a strict law enforcement server or a balanced roleplay community, this script provides the tools officers need while maintaining fairness for all players.

What's Included

You'll get a fully-featured pepper spray system with both offensive and defensive tools. The script includes pepper spray weapons for incapacitating suspects, decontamination spray for treating affected individuals, reloading stations for restocking supplies, and gas mask protection for tactical units. Every element works together to create a realistic non-lethal force continuum that adds depth to police interactions without making gameplay frustrating.

Key Features

• Fully Customizable Configuration - Create unlimited pepper spray types with different characteristics. Adjust effect duration, intensity buildup, recovery rates, and visual effects to match your server's balance needs.
• Decontamination System - Officers can treat pepper sprayed individuals using decontamination spray. Features sound effects and particle effects for visual feedback, allowing medical or police to provide aid after compliance is achieved.
• Interactive Recovery Mechanics - Players can rub their eyes or spit to reduce pepper spray effects faster. Spitting creates realistic water particles on the ground. These actions give affected players agency rather than just waiting helplessly.
• Gas Mask Protection - Tactical units wearing gas masks are immune to pepper spray effects, allowing for realistic SWAT or riot control scenarios where proper equipment matters.
• Reloading Point System - Set up map locations where officers can refill pepper spray or decontamination canisters. Prevents infinite use and adds tactical planning to equipment management.
• Progressive Effect Intensity - Effects build up based on exposure time and recovery rate settings. Short bursts cause temporary disorientation while prolonged exposure creates severe vision impairment.
• Permission System Integration - Built-in job checks for ESX and QBCore ensure only authorized players (police, EMS for decontamination) can use the equipment. Also supports standalone configuration.
• Multi-Language Support - Includes French and English translations with easy configuration for adding your own language.

Perfect For

• Serious roleplay servers needing realistic less-lethal options
• Police departments wanting alternatives to taser or lethal force
• Servers focused on de-escalation and compliance-based policing
• Communities that want balanced non-lethal mechanics
• Law enforcement training scenarios
• Riot control or protest roleplay situations

How It Works

Officers equip the weapon_pepperspray item and aim at a suspect. Holding the spray button deploys a cloud of pepper spray with visual particle effects and realistic sound. The target experiences progressive vision impairment and movement penalties based on exposure duration. To recover faster, affected players can use dedicated keybinds to rub their eyes (reducing effect over time) or spit (clearing some buildup). Officers or EMS personnel can use decontamination spray to immediately begin reversing effects, accompanied by decontamination sound and particle effects.

Gas masks completely prevent pepper spray effects, making them essential for tactical units expecting to deploy or encounter chemical agents. When officers run out of spray charges, they must visit configured reloading points on the map to refill their canisters. The configuration file lets you set up multiple spray types with different effect profiles, allowing for training sprays, duty sprays, and heavy-duty riot control variants.

Technical Details

• Performance: Optimized particle effects and recovery timers ensure minimal server impact even during large crowd control scenarios
• Compatibility: Works with ESX Legacy, QBCore, QBOX, and standalone frameworks
• Dependencies: Requires weapon_pepperspray weapon asset (included)
• Configuration: Single config file for all spray types, effects, locations, permissions
• Target Support: Compatible with ox_target, qb-target for reloading station interactions

Installation

1. Extract the resource to your server's resources folder
2. Add weapon_pepperspray to your weapons.lua or shared items configuration
3. Configure spray types, effects, and reloading locations in config.lua
4. Set up job permissions for police and EMS access
5. Add 'ensure advanced-pepper-spray' to server.cfg
6. Restart server and test spray mechanics with gas mask on/off

Framework Compatibility

• ✅ ESX - Full integration with job checks and item system
• ✅ QBCore - Native support for QB job and item frameworks
• ✅ QBOX - Compatible with QBOX item and permission systems
• ✅ Standalone - Works without framework using configuration-based permissions

What Makes It Stand Out

Most pepper spray scripts are simple screen overlays with timers. This system goes further by adding decontamination gameplay, interactive recovery mechanics, equipment-based immunity, and a reloading system that creates tactical depth. The progressive effect intensity means exposure time matters, not just getting hit. Officers have to manage their limited spray charges, EMS gets a meaningful treatment role, and affected players aren't completely helpless thanks to eye rubbing and spitting mechanics. The result is a balanced less-lethal tool that enhances police roleplay without being frustrating or overpowered.

Related Standalone Scripts

• Lab Storage (ESX/QB)
• FiveM Text-UI Script
• FiveM Garage Script (Plus)
• Frkn Spawn Selector v2