/ShotSpotter

Receive gunshot alerts triggered by other players.

Primary LanguageLuaMIT LicenseMIT

ShotSpotter - Gunshot Detection System

ShotSpotter

📑 Description

This is a simple standalone ShotSpotter script made for FiveM.

The script will detect when gunshots are fired and will put out a sound and text alert to all of the Law Enforcement patrol vehicles with an approximate location. No permissions are being used, you just have to be inside a police car to receive the gunshot alert.

To be realistic, the ShotSpotter has a default delay of 20 seconds to put out an alert after gunshots are detected.
Throwables, melees, fire extinguishers, stunguns, flareguns, and suppressed weapons won't be detected by the ShotSpotter.
These last two parameters can be configured in the config.lua as well as a couple of other options (see config options).

💡 Features

  • Simple and clean
  • Highly customizable
  • Sound effect
  • Animated map blip
  • Suppressed weapons won't be detected
  • Ability to blacklist weapons

👀 Preview

Video demo

Youtube

Gunshot alerts

gunshot alert 1 gunshot alert 2

Map blip

map blip

Config options

config options

📊 Resmon

Context CPU
Idle 0.03 ms
Peak 0.04 ms

📥 Installation

  • Rename the folder from ShotSpotter-main to ShotSpotter
  • Drag the folder to your server resource folder
  • Add start ShotSpotter or ensure ShotSpotter to your server.cfg

✅ Changelog

v1.4

  • Added version checker

v1.3

  • Removed useless AddEventHandler
  • Used pre-hashed string to remove GetHashKey
    (Thanks to Ekinoxx0)

v1.2

  • Reduced resource impact on performance (0.26ms to 0.08ms)

v1.1

  • Updated InvokeNative to the actual Get StreetNameAtCoord native
  • Replaced outdated GetPlayerPed with PlayerPedId
    (Thanks to MichaelCoding25)

v1.0

  • Initial Release