Usage
Spike Strips
Deploying
- Have a
spikesboxitem in your inventory and the required job (default:police). - Use the item - your character plays a planting animation and the spike box is placed in front of you.
- You receive a
spikebox_pilotremote linked to the deployed strip.
Activating / deactivating
Use the spikebox_pilot item to toggle the strip. The spikes roll out from the box when active and retract when deactivated. You must be within 200 m of the strip.
Picking up
Target the spike box on the ground and select Pickup Spike Strip (requires the police job). The box is returned to your inventory and the strip is removed.
Breaking
Any player carrying a melee weapon from the configured list can target the box and select Break Spike Strip with target/interaction system. The strip is going to be permanently destroyed.
TIP
Configurable required jobs and breakable weapon list are in shared/spikes_config.lua.
GPS Trackers
Placeable GPS
- Have a
placeable_gpsitem and stand close to any vehicle, facing it. - Use the item - a 10-second progress bar plays while the tracker is installed.
- A map blip for the vehicle appears on your screen and updates every 15 seconds.
Shootable GPS
- Equip a
WEAPON_GPSLAUNCHERwithshootable_gpsammo in your inventory. - Fire at any vehicle - the GPS projectile sticks to the impact point on the vehicle body.
- A map blip for the vehicle appears and updates every 15 seconds.
Removing a tracker
- Target the vehicle and select Remove Device - plays a 5-second progress bar to remove the tracker.
- If prp-scanner is installed, scanning a vehicle with a GPS active triggers an instant removal interaction.
Flashbang
Equip and throw WEAPON_FLASHBANG like a standard grenade. The flashbang detonates after 2.5 seconds and applies effects to nearby players:
| Zone | Range | Effect |
|---|---|---|
| Full flash | 4 m in front / 2 m behind | White screen, ringing, camera shake, ragdoll |
| Weak effect | 4–11 m | Reduced sound volume, mild disorientation |
- Full flash effect lasts 15 seconds, white screen 3 seconds
- Optionally cuts voice chat (mumble) for 6 seconds
- All timings and ranges are configurable in
shared/flashbang_config.lua
Freeze grenade variant
WEAPON_FREEZEGRENADE uses the same throwing and detection logic but applies a different effect: instead of flashing, it slows the affected player's movement speed for 15 seconds.
| Zone | Range | Effect |
|---|---|---|
| Full effect | 4 m in front / 2 m behind | Movement speed reduced to 10% |
| Weak effect | 4–11 m | Movement speed reduced to 25% |
Smoke Grenade
Equip and throw WEAPON_SMOK2GRENADE like a standard grenade. The smoke deploys after 3 seconds and creates a persistent cloud lasting 35 seconds by default.
The smoke is visible from up to 80 m away. Size and duration are configurable in shared/smokegrenade_config.lua.
Variants
| Weapon | Smoke colour | Notes |
|---|---|---|
WEAPON_SMOK2GRENADE | Orange | Standard police smoke |
WEAPON_HELLGRENADE | Red | |
WEAPON_FREEZESMOKE | Cyan | |
WEAPON_FIREWORKGRENADE | (fireworks) | Random starburst and fountain particles; lasts half the normal duration |
Configuration
| File | Purpose |
|---|---|
shared/spikes_config.lua | Required jobs, destroyable weapon list, spike item names |
shared/gps_config.lua | Placement progress bar duration, GPS prop attachment, item names |
shared/flashbang_config.lua | Explode delay, effect durations, effect ranges, sound volumes, ragdoll toggle |
shared/smokegrenade_config.lua | Smoke deploy delay, smoke duration, smoke size, visibility distance |