Install Evidence System

1. Prepare your server and data#

1. Verify OneSync, qbx_core, ox_lib, oxmysql, ox_target, and ox_inventory are installed and working together.
2. Back up your existing evidence and inventory data before replacing an evidence resource. Stop the previous scene producer so both systems do not generate traces together.
3. Install the complete entitled download in a folder named BigB_evidence. Place fxmanifest.lua directly inside that folder and retain all Cfx delivery files.
4. Use the database configured for oxmysql. The resource creates six bigb_evidence_* tables at startup; its database account needs table-creation permission as well as normal runtime access.

There is no separate SQL file to import for a fresh installation. Existing data migrations are a separate operation: the automatic creation of new tables does not convert an older XSC Evidence installation.

2. Merge inventory items and copy the images#

1. Open the package's install/ox_inventory_items.lua and merge its entries into your existing ox_inventory data/items.lua return table. Check duplicate item names first; do not replace the entire inventory file or paste a second return statement into it.
2. Copy install/images/*.png into your configured inventory image directory, normally ox_inventory/web/images. Preserve the supplied filenames.
3. Keep the bagged evidence items nonstackable so each item's evidence record metadata remains separate.
4. Supply the tools through your existing equipment, shop, or loadout setup. This package does not create a shop automatically.
5. Restart inventory as part of a planned server restart after changing item definitions, then start Evidence System after it.

['uv_light'] = {
    label = 'Forensic UV Light', weight = 200,
    stack = false, close = true, consume = 0,
    client = { image = 'xev_uv.png', export = 'BigB_evidence.uv_light' }
},
['gsr_test_kit'] = {
    label = 'GSR Test Kit', weight = 200,
    stack = false, close = true, consume = 0,
    client = { image = 'xev_swab.png', export = 'BigB_evidence.gsr_test_kit' }
},

These two entries illustrate the export wiring; merge the full supplied file for all sample types and tools. It includes UV light, camera, GSR cloth, GSR test kit, DNA swab, and fingerprint scanner definitions, plus the bagged evidence items.

3. Configure access and start the resource#

Edit shared/config.lua for your job names and grades, room/lab coordinates, ammunition item mappings, and timers. Station coordinates must match accessible locations on your installed maps. Keep Config.Legacy.import = false for a fresh install and retain the default locker prefix.

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_target
ensure ox_inventory
ensure BigB_evidence

Keep the complete startup sequence required by your framework and inventory; this excerpt only shows Evidence System's dependencies. Optional medical, MDT, police, and camera peers are enabled separately in Config.Integrations.

4. Verify the complete evidence flow#

1. Use a test officer in an authorized on-duty job, in routing bucket 0. Check both server and client consoles after startup.
2. Create a small test scene with a supported firearm. Aim a normal flashlight at a casing, move within the configured interaction distance (3 metres by default), and use E to bag it.
3. Confirm exactly one evidence item appears. Try the UV light on an appropriate print/impact trace, and check that drawing a weapon ends UV use.
4. Visit a configured evidence room, create or open an authorized locker, and check the evidence remains after closing and reopening it.
5. At a configured lab bench, submit evidence for analysis and verify the result after the configured processing time.
6. With a second player, test sampling consent, refusal, and successful kit consumption. Also test full inventory and cancelled collection before opening the system to players.

An administrator with the group.admin ACE can use /evidence_stats to inspect counts. Staff access to that command is separate from an officer's job permissions.

Upgrading an existing evidence installation#

Version 1.0.1 defaults to xev_locker_. Do not change prefixes or delete old stashes to bypass a migration error: that can make stored evidence inaccessible. The new default namespace does not require modifying ox_inventory source code.