Skip to content

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.

TIP

Configurable required jobs 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:

ZoneRangeEffect
Full flash4 m in front / 2 m behindWhite screen, ringing, camera shake, ragdoll
Weak effect4–11 mReduced 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.

ZoneRangeEffect
Full effect4 m in front / 2 m behindMovement speed reduced to 10%
Weak effect4–11 mMovement 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

WeaponSmoke colourNotes
WEAPON_SMOK2GRENADEOrangeStandard police smoke
WEAPON_HELLGRENADERed
WEAPON_FREEZESMOKECyan
WEAPON_FIREWORKGRENADE(fireworks)Random starburst and fountain particles; lasts half the normal duration

Configuration

FilePurpose
shared/spikes_config.luaRequired jobs, destroyable weapon list, spike item names
shared/gps_config.luaPlacement progress bar duration, GPS prop attachment, item names
shared/flashbang_config.luaExplode delay, effect durations, effect ranges, sound volumes, ragdoll toggle
shared/smokegrenade_config.luaSmoke deploy delay, smoke duration, smoke size, visibility distance