Usage

Spike Strips

Deploying

1. Have a spikesbox item in your inventory and the required job (default: police).
2. Use the item - your character plays a planting animation and the spike box is placed in front of you.
3. You receive a spikebox_pilot remote 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.

Strip length

Spikes.Length in shared/spikes_config.lua controls the deployed strip size. 1.0 is the default. Values around 0.75–1.5 look best; much higher will stretch the model.

TIP

Configurable required jobs, strip length, ranges and breakable weapon list are in shared/spikes_config.lua.

GPS Trackers

Placeable GPS

1. Have a placeable_gps item and stand close to any vehicle, facing it.
2. Use the item - a 10-second progress bar plays while the tracker is installed.
3. A map blip for the vehicle appears on your screen and updates every 15 seconds.

Shootable GPS

1. Equip a WEAPON_GPSLAUNCHER with shootable_gps ammo in your inventory.
2. Fire at any vehicle - the GPS projectile sticks to the impact point on the vehicle body.
3. 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, strip length, detection and remote range
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