Kartik Scripts

Migration

Kartik Evidence includes a built-in migration tool to help you transition from Snipe Evidence without losing your historical data, crime scenes, or player biometrics.

๐Ÿš€ How to Migrate

The migration process is handled via a server-side command.

1. Preparation

Ensure that your database still contains the legacy Snipe tables:

  • snipe_evidence_identifiers
  • snipe_evidence_crimescenes
  • snipe_evidence_evidences

2. Run the Command

Run the following command from your Server Console (txAdmin or CMD) or as an administrator with proper ACE permissions:

/migratesnipe

3. Cleanup

Once the migration is complete and you have verified the data in your new Forensic Tablet, you should:

  1. Delete the migration script located at server/migration/migrate_snipe.lua.
  2. (Optional) Backup and remove the legacy snipe_ tables from your database.

๐Ÿ“ฆ What is Migrated?

CategoryDescription
Player BiometricsAll DNA and Fingerprint records for players are moved to player_evidence.
Crime ScenesCase titles, narratives, and "deleted" status are migrated to forensic_cases.
Evidence ItemsPhysical items (Blood, Casings, etc.) are transformed into the new metadata format.
Evidence LockersItems are automatically placed into the new resource's stashes, linked to their respective cases.

๐Ÿ› ๏ธ Evidence Type Mapping

The tool automatically maps Snipe evidence types to the new Kartik Evidence items:

  • blood / car_blood โ†’ evidence_blood
  • casing / car_casings โ†’ evidence_casing
  • projectile โ†’ evidence_projectile
  • vehicle_fragment โ†’ evidence_fragment
  • fingerprint / car_fingerprint โ†’ evidence_fingerprint

[!IMPORTANT] This is a one-time migration. Running the command multiple times may result in duplicate records if not handled carefully.

[!TIP] All migrated cases will show "Migrated" as the reporting officer in the Forensic Tablet.

On this page