> For the complete documentation index, see [llms.txt](https://kartik-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kartik-scripts.gitbook.io/docs/scripts/kartik-evidence.md).

# Evidence

The most advanced and immersive forensic evidence system for FiveM, supporting **ESX, QBCore, and Qbox**. Track every shot, every drop of blood, and every fingerprint with unparalleled realism and performance.

Designed for high-quality serious RP servers, this system bridges the gap between field work and investigation.

***

### 🌟 Key Feature Modules

#### 📊 Advanced Forensic Tablet (React-Powered)

A centralized, high-performance UI hub for all investigative needs.

* **Crime Scene Manager**: Create, archive, and manage detailed reports with narratives and photo attachments.
* **Evidence Locker**: A secure, per-case stash system for physical evidence items.
* **Home Dashboard**: Real-time activity logs, personal assigned cases, and global forensic stats.
* **Biometric Database**: Search and cross-reference DNA and Fingerprints (AFIS).

#### 🧬 Advanced Biometrics

Move beyond simple text-based matching with a deep biological evidence layer.

* **DNA Profiling**: Collect DNA from blood, saliva, or forensic body examinations.
* **Fingerprint AFIS**: Lift prints from vehicles or objects and match them against the state database.
* **Body Examination**: Detailed coroner-level inspection of deceased individuals to find trace evidence.

#### 🔫 Ballistics & Firearms

Realistic weapon tracking and scene analysis.

* **Trajectory Visualization**: Trace the path of a bullet from impact back to its origin.
* **Serial Recovery**: Weapons can have their serial numbers scratched off by criminals and professionally recovered by forensics.
* **Casing & Projectile Analysis**: Match projectiles found at scenes to the specific weapon that fired them.

#### 🧪 Gunshot Residue (GSR)

Track firing history with realistic persistence and cleaning logic.

* **Field Testing**: Use specialized GSR kits to test suspects on the scene.
* **Persistence & Decay**: Residue remains for a configurable time and can be washed off in water.
* **Forensic Validation**: Positive tests provide immediate investigative leads.

#### 🔥 Arson Forensics

The most comprehensive arson investigation kit on the market.

* **Accelerant Detection**: Detect traces of gasoline or other fuels used to start fires.
* **Burn Pattern Analysis**: Understand fire intensity and origin based on baked-in ground patterns.
* **Ignition Sources**: Recover melted lighters or fuse components from the heart of the blaze.
* **Petrol Can Sycn**: Real-time syncing of gasoline pouring for manual arsonists.

#### 💣 Forensic Explosives

Advanced post-blast investigation for explosive devices.

* **Blast Tracking**: Automated detection of explosive events with remnant generation.
* **Fragmentation Analysis**: Recover and analyze metallic shards, wiring, and adhesive residues.
* **Chemical Compounds**: Specialized swabbing for unreacted explosive material and chemical tracers.

#### 📄 Physical Forensic Reports

Move investigation results from the tablet into the physical world with integrated report items.

* **Usable Report Items**: Generate physical `Ballistics`, `Biometrics`, and `Toxicology` reports that can be handled as inventory items.
* **Court-Ready Evidence**: These items contain immutable metadata including case IDs, timestamps, and investigator signatures, perfect for legal roleplay.
* **Evidence Containers**: Specialized items for bag-and-tag operations, ensuring chain of custody.

#### 🧪 BAC & Toxicology

Integrated blood alcohol tracking.

* **Breathalyzer Tool**: Realistic digital tool for field sobriety checks.
* **Timed Decay**: BAC levels naturally decay over time based on configurable metabolism rates.

#### 🏛️ Scene Reconstruction

Revisualize the past with cutting-edge reconstruction tools.

* **Virtual Scene Buckets**: Teleport to a virtual instance of the crime scene for isolated focus.
* **Ghost Entities**: See transparent "ghost" versions of vehicles in their exact positions at the time of the incident.
* **World-Space DUI Labels**: Digital labels attached to world coordinates for high-tech metadata viewing.

***

### 🚀 Quick Links

{% content-ref url="<https://github.com/kartik1410/documents/blob/main/scripts/kartik-evidence/features/README.md>" %}
<https://github.com/kartik1410/documents/blob/main/scripts/kartik-evidence/features/README.md>
{% endcontent-ref %}

{% content-ref url="/pages/NlKX7EDjZf6acjZmSGvZ" %}
[Gunshot Residue (GSR)](/docs/scripts/kartik-evidence/features/gsr.md)
{% endcontent-ref %}

{% content-ref url="/pages/bI2lGzbWfGgyKo29geK6" %}
[Installation](/docs/scripts/kartik-evidence/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/m4A3T8NP2qCVIrt53fbh" %}
[Client Exports](/docs/scripts/kartik-evidence/exports/client-exports.md)
{% endcontent-ref %}

{% content-ref url="/pages/zpQXpG3byZiciwuSPoF4" %}
[Server Exports](/docs/scripts/kartik-evidence/exports/server-exports.md)
{% endcontent-ref %}

***

### 📦 Installation Preview

To get started, ensure you have the required items in your `ox_inventory/data/items.lua`:

```lua
['evidence_tablet'] = {
    label = 'Forensic Tablet',
    weight = 500,
    description = 'Access the forensic database and manage crime scene reports.'
},
['breathalyzer'] = {
    label = 'Breathalyzer',
    weight = 200,
    description = 'Digital device for estimating blood alcohol content.'
},
['gsr_test_kit'] = {
    label = 'GSR Test Kit',
    weight = 200,
    description = 'A kit used to collect and analyze gunshot residue from a suspect.'
}
```

For full setup instructions, visit the [Installation](/docs/scripts/kartik-evidence/installation.md) page.