Migration

Built-in migration tools for transferring database records and item configs from OX or Quasar.

Player Data Migration

Automatic database detection runs on initial resource startup via server/_init.lua:

  • OX Inventory: Automatically migrates players, vehicles, and stashes into database.
  • ESX and QBCore: Decodes inventory JSON columns into ak47_inventory format.

[!WARNING]
Server restart is mandatory once database migration completes.

Item and Config Migration

Convert custom items and weapons directly using convert/converter.lua:

  1. Locate the convert/ox/ or convert/qs/ directory.
  2. Place items.lua or weapons.lua into the corresponding folder.
  3. Start the ak47_inventory resource.
  4. Converted items and durability settings save into shared/.
  5. Restart the server to finalize item registration.

[!TIP]
Restart the resource after converter completes to reload shared files.