Skip to content
⌘ K

Forensics Config

PoliceApp

Forensics Evidence System#

Overview#

The forensics system lets law enforcement collect scene evidence, store it in an evidence locker, analyze it in the lab, and attach the results to incident reports.

It is designed around this flow:

  1. Evidence is created in the world.
  2. Officers collect the evidence into an evidence bag.
  3. Officers deposit the evidence bag at the evidence locker.
  4. Authorized lab officers analyze stored evidence.
  5. Analyzed evidence can be linked to police reports.

Evidence Types#

The system supports these evidence types:

  • shell_casing
  • blood_dna
  • fingerprint
  • weapon
  • vehicle
  • photo
  • bodycam

By default, shell casings and blood DNA can be created automatically. Fingerprint evidence is not automatically generated unless another script calls the fingerprint export.

Configuration#

Main settings are located in:

lua
modules/forensics/config.lua

Important options:

lua
ForensicsConfig.Enabled = true
ForensicsConfig.EvidenceBagItem = "evidence_bag"
ForensicsConfig.ForensicScannerItem = "forensic_scanner"
ForensicsConfig.RequireForensicScannerItem = false
ForensicsConfig.AutoCreateShellCasings = true
ForensicsConfig.AutoCreateBloodEvidence = true
ForensicsConfig.AutoCreateFingerprints = false
ForensicsConfig.LabMinGrade = 2

Jobs#

Only configured law enforcement jobs can use the evidence system:

lua
AllowedJobs = { "police", "sheriff", "state", "doj", "trooper", "lspd", "bcso" }

Lab analysis uses LabAllowedJobs if set. If LabAllowedJobs is nil, it uses the same jobs as AllowedJobs.

Evidence Locker#

Collected evidence must be deposited at an evidence locker before it can be analyzed.

Current locker location:

lua
LockerZones = {
    { label = "Evidence locker", coords = vector3(441.6005, -996.0329, 30.6896), radius = 2.5 },
}

When an officer is near this location, they will see:

text
[E] Store evidence in locker

Pressing E opens the locker menu and lists collected evidence bags that can be stored.

Requirements:

  • The player must have an allowed police job.
  • The evidence must already be collected.
  • The player must be inside the locker zone.
  • If LockerStoreRequiresBag = true, the player must have the matching evidence_bag.

Forensics Lab#

Stored evidence is analyzed from the Police App inside the tablet.

Current lab location:

lua
LabZones = {
    { label = "Forensics lab", coords = vector3(437.1269, -996.2137, 30.6896), radius = 2.5 },
}

To analyze evidence:

  1. Open the tablet.
  2. Open the Police App.
  3. Go to the Forensics Lab tab.
  4. Select stored evidence.
  5. Run lab analysis.

Requirements:

  • The evidence status must be stored.
  • The officer must be inside the lab zone.
  • The officer must have an allowed lab job.
  • The officer grade must be at least LabMinGrade.

Default required grade:

lua
LabMinGrade = 2

Collecting Evidence#

Officers can collect nearby evidence in the world.

Default collection distance:

lua
EvidenceCollectionDistance = 2.2

Default scanner distance:

lua
ScannerDistance = 35.0

If the scanner is enabled, nearby evidence is shown with markers. When close enough, press E to collect it.

Collected evidence is placed into an evidence bag:

lua
EvidenceBagItem = "evidence_bag"

The inventory item should exist in your inventory system and support metadata such as:

  • evidence_id
  • evidence_type
  • label

Shell Casings#

Shell casing evidence can be created automatically when a player fires a valid weapon.

Relevant settings:

lua
AutoCreateShellCasings = true
ShellCasingCooldownMs = 2200
ShellStreetPickupEnabled = true
ShellStreetPickupProgressMs = 4500
ShellStreetPickupSkipsScannerItem = true

Shell casings can be collected from the street by authorized officers.

During lab analysis, shell casings can match by:

  • weapon serial
  • ballistic hash

Blood DNA#

Blood DNA evidence can be created automatically when a player takes damage, depending on chance and cooldown.

Relevant settings:

lua
AutoCreateBloodEvidence = true
BloodEvidenceCooldownMs = 9000
BloodEvidenceChance = 0.28

During lab analysis, blood DNA is matched against the forensic profile database.

Fingerprints#

Fingerprint evidence is supported, but automatic fingerprint creation is disabled by default:

lua
AutoCreateFingerprints = false

Fingerprints can be created by another script using the export:

lua
exports['0r-smarttab']:CreateFingerprintEvidence(coords, surfaceType, metadata)

Example:

lua
local coords = GetEntityCoords(PlayerPedId())

exports['0r-smarttab']:CreateFingerprintEvidence(coords, "vehicle_door", {
    fingerprint_hash = "example_hash",
    owner_citizenid = "ABC12345",
    owner_name = "John Doe"
})

After a fingerprint is created, officers collect and store it like any other evidence.

During lab analysis, fingerprint evidence is matched against fingerprint_hash in the forensic profile database.

Tablet Police App#

The Police App uses the forensics system in two places:

Forensics Lab#

Used to view stored evidence and run analysis.

Path:

text
Police App -> Forensics Lab

Incident Reports#

Used to attach stored or collected evidence to a report.

Path:

text
Police App -> Incident Report -> Forensic Evidence

Officers can browse the evidence locker and link relevant evidence to the report.

Evidence Status Flow#

Evidence moves through these states:

text
created/uncollected -> collected -> stored -> analyzed/linked

Meaning:

  • created / uncollected: Evidence exists in the world.
  • collected: Officer collected it into an evidence bag.
  • stored: Evidence was deposited at the locker.
  • analyzed result: Lab analysis generated match data.
  • linked: Evidence was attached to an incident report or case.

Troubleshooting#

No evidence appears near the officer#

Check:

  • ForensicsConfig.Enabled
  • player job is in AllowedJobs
  • scanner state and scanner distance
  • evidence has not expired
  • database tables were created

Cannot store evidence#

Check:

  • player is inside LockerZones
  • evidence status is collected
  • player has the correct evidence_bag
  • LockerStoreRequiresBag

Cannot analyze evidence#

Check:

  • player is inside LabZones
  • evidence status is stored
  • player job is allowed
  • player grade is at least LabMinGrade

Fingerprints do not appear#

This is expected unless another script creates fingerprint evidence. Use:

lua
exports['0r-smarttab']:CreateFingerprintEvidence(coords, surfaceType, metadata)
  • Add evidence_bag to your inventory items.
  • Add forensic_scanner if RequireForensicScannerItem = true.
  • Adjust LockerZones and LabZones for your police station MLO.
  • Confirm police job names in AllowedJobs.
  • Set LabMinGrade to match your department ranks.
  • Add fingerprint export calls from your vehicle, burglary, robbery, or interaction scripts if fingerprint evidence is needed.