Gunshot residues

Leaving gunshot residues

Gunshot residues on players

When a player fires a weapon, gunshot residues will be left on the player's body and clothes. By targetting the player, other players can remove the residues. Permitted players (as defined in config.lua) may collect them from the player's body in case they have a forensic_kit item with them. They receive a collected_gunshot_residue item.

config.permissions = {
    collect = { -- Allowed jobs and their minimum grades required to collect evidence
        police = 0,
        fib = 0
    }
}

Gunshot residues are removed from players automatically after some time which you can configure in config.lua:

config.gunshotResidues = {
    -- Cron expression defining when gunshot residues on players shall be removed.
    -- See https://overextended.dev/docs/ox_lib/Cron/Server#cron-expression to learn more about the syntax of cron expressions.
    -- This adds some intended randomness, e.g. when the cron job runs every 15 minutes, it could happen that the gunshot residues are already
    -- removed after 1 minute or as late as 15 minutes depending on the time the cron job started.
    decayCron = "*/15 * * * *" -- default: run every 15 minutes
}

Analysing gunshot residues

1. Place an evidence_laptop.
2. Open the Ballistics Analysis App.
3. Have an collected_gunshot_residue item in your inventory.
4. On the left side of the app, all those gunshot residue items in your inventory and in evidence boxes are displayed. By selecting an gunshot residue item from the sidebar, the corresponding information will be displayed on the right side. In the upper section, you can see detailed information about the evidence (crime scene, time of collection). You also have the option to add additional notes if needed. In the lower section, you can analyze the gunshot residue. After a short processing time the app will display the type of the weapon fired by the gunshot residues' source and the time of that event.