How police evidence works on a FiveM server
On a FiveM server, evidence is what a crime leaves behind for police to find. Shots drop casings, wounds leave blood, and a driver leaves fingerprints in the car. Officers find each piece, collect it and analyse it to put a name to a scene.
Our Realistic Evidence System V2 runs this on ESX, Qbox and QBCore. The numbers in this guide are the shipped defaults, and most of them sit in its config for you to change.
What leaves evidence
- Shooting. Each shot can drop a bullet casing near the shooter and a fragment on the ground where the bullet lands. A wall or other surface also gets a bullet hole. People and vehicles don’t.
- Getting hurt. A player hurt by a weapon leaves a blood sample where they stand.
- Driving. A non-police player who drives a car without gloves leaves a fingerprint in it. The car keeps only the latest driver’s print, for 120 minutes.
- Gunshot residue. Shooting also puts GSR on the shooter’s hands.
A stun gun leaves no fragment, bullet hole or GSR. Each weapon list sits in config, so you can add more.
Who the evidence points to
Some pieces carry the DNA of the player who left them. Blood and fingerprints always do. A casing does half the time. Fragments from a shooting and bullet holes name nobody.
Gloves stop DNA on casings and fingerprints, but blood still gives it away. The script reads gloves from the character’s arms clothing, in HasGloves in client/.
With ox_inventory, qs-inventory or qb-inventory, every casing also carries the gun’s serial number. On ESX with its default inventory, casings show no serial.
One option makes it harder. With Config, DNA shows a name only after police have scanned that person with the fingerprint_scanner item. The scan works within 3 metres and fails if the person wears gloves. It ships off.
How police find and collect it
- An officer holds a flashlight and aims it with the right mouse button. Evidence within 10 metres shows up on screen.
- They press E within 2 metres to collect it. With ox_inventory, qs-inventory or QBCore, each piece becomes an inventory item. On ESX with its default inventory, the script keeps it for the player instead.
- For a car, the officer sits inside and uses the
uv_lightitem. “Fingerprints found” means they now carry the print. - For GSR, they use a
gsr_test_kiton a player within 3 metres. The result is “GSR Negative”, “GSR Positive (Recent)” within 10 minutes of shooting, or “GSR Positive (Aged)” after that. Each test uses up a kit.
GSR fades after 60 minutes. A gsr_cloth removes it, and so do 15 seconds in water. Evidence nobody collects disappears after 360 minutes, and the server clears it every 10 minutes.
Only jobs in Config count as police. It ships with police and sheriff, from grade 0.
Analysis, lockers and the scene
Police analyse evidence at the points in Config, where an “Analyze Evidence” prompt shows within 2 metres. Set them to your own station. The analysis screen shows each piece with its tag, time, DNA, weapon and serial number or plate, in a 3D viewer or as plain text.
On the same screen, officers create named lockers, store evidence in them and take it out. Lockers hold evidence only. Whatever goes in stays until an officer deletes it.
The evidence_camera item rebuilds a scene where the officer stands. It marks every piece they carry that was found within 20 metres, at the spot where it lay. Use it again to leave the view.
Criminals can clean up too
Anyone holding a flashlight sees ground evidence. They can collect it with E, or remove it for good with Y. A careful criminal can wipe a scene before police arrive. Analysis, lockers and the UV light stay police-only, and so does the GSR kit as shipped.
To keep ground evidence for police alone, return false for other jobs from CanSeeEvidence, CanSeeCollectOption and CanSeeRemoveOption in client/.
What it connects to
- Inventory: ox_inventory, qs-inventory or qb-inventory. The item list for each is in the script’s
README, and how to add items to ox_inventory shows where they go..txt - MDT: with
Config, every piece put in a locker gets an entry on the police page of All-in-One MDT V2, and taking it out removes the entry. Start.UseMDT = true tk_mdtbeforetk_evidence. It ships off, and the MDT is sold separately. - Ambulance Job: with
Configin Advanced Ambulance Job, a medic who removes a bullet gets a bullet fragment carrying the patient’s DNA. It also ships off. The medic’s side is in how death works in FiveM..UseTKEvidence = true - Your own scripts: the client exports
saveEvidenceandsaveFingerprintleave evidence on the ground. The server exportaddEvidenceItemhands it straight to a player.
For how evidence fits with the jail, dispatch and MDT, see how our police scripts work together.
What to check before you choose
- Your inventory. Items and serial numbers need ox_inventory, qs-inventory or QBCore. Plain ESX gets neither.
- Who may see evidence. Decide whether criminals should be able to clean up, and edit the three functions if not.
- Your departments. Add every other police job to
Config..PoliceJobs - Known problems. The evidence docs answer the common setup questions.
- See it in game. The showcase on YouTube runs 2:09.
Realistic Evidence System V2 is sold on its own, and it’s also in our Essential and Ultimate plans. Compare the plans if you run several of our police scripts.
