π₯ Overview & Key Features
π« Dynamic Ballistics & Casing Props
-
Physical Casings: Firing any configured weapon spawns a physical 3D bullet casing prop (
p_bulletcasing01x) on the ground. - Smart Markers: Authorized jobs see gold markers pointing out evidence when nearby, helping them locate casings in bushes or grass.
- Auto-Despawn: Casings have configurable timers to ensure they clean up automatically.
π·οΈ Serial Number & Weapon Tracking
- Traceable Metadata: Every casing collected carries unique metadata, including the weapon model, the weapon's serial number, a timestamp, and the exact location of the shooting.
- Match Weapons to Crimes: Detectives can inspect casings in their inventory and compare the serial numbers to seized weapons to link suspects to crime scenes.
π§Ό GSR (Gunshot Residue) System
- Residue Tracking: Firing a gun leaves GSR on the shooter's hands for a configurable duration (e.g., 15 minutes).
- Forensic Washing: Suspects can wash their hands by standing in natural water sources (rivers, lakes) to clean off the residue before being inspected.
π§ Crime Scene Barriers
-
Area Control: Officers can place dynamic, physical crime scene barriers (
p_sawhorse01xwooden sawhorses) to block off roads or investigate sites. - Removal prompts: Authorized jobs can easily pick up and clean crime scenes using 3D prompts.
β‘ Hyper-Optimized Performance
- Built for high-intensity action and large-scale shootouts (optimized for 10v10 scenarios).
- 0.00ms Idle consumption.
- Configurable caps (e.g., max 30 casings total in the world, max 3 per player to prevent spamming) to protect server performance.
π οΈ Configuration Options (config.lua)
The script is highly customizable. You can adjust:
- Authorized Jobs: Specify which job names can see and collect evidence (e.g., sheriff, marshal, deputy, detective).
- Casing Limits: Configure despawn timers, rendering distances, and maximum casings.
- Weapon Compatibility: Add or remove which weapons spawn casings and customize their labels.
- GSR Settings: Define the residue duration and whether water washes it away.
π§ Technical Details & Installation
-
Framework: RSG-Core (integrates with
rsg-inventory/ QB inventory exports). - Optimized: 0.00ms (idle) / ~0.01ms - 0.03ms during heavy gunfights.
-
Commands:
/clearevidence(Admin command to clear all active evidence). -
Database: Includes a simple
items.sqlto register theevidence_casingitem.