Documentation
Move from qs-licenses to qs-licensescreator without losing issued licenses, templates or offices: what carries over, the safe upgrade steps and the export and command changes.
Licenses Creator 2 (qs-licensescreator) replaces the first version (qs-licenses). It is a new resource with a new interface, but it reads the same tables, so every license your players already hold, every template and every office comes across. What changes is the resource name — and with it the command and the exports your other scripts call.
Data |
|---|
In v2 |
|---|
License templates and their designs | Kept. They open in the new Designer as they were. New columns — validity, inventory image, starter flag — are added on first boot. |
License offices, terminals, centers, forgers | Kept, in the Peds tab. The old |
Issued licenses | Kept, with their numbers, expiry, status and photos. A points column is added at zero. |
Authorization requests | Kept. Approved requests now have to be collected at the Authorization center as a document. |
Panel users and settings | Kept. Open Settings once and check Photo upload and the theme colours. |
Nothing below deletes data, but a backup costs a minute. From your database tool, or from a shell:
mysqldump -u root -p your_database qs_licenses_categories qs_licenses_templates qs_licenses_interactions qs_licenses_global_interactions qs_licenses_issued_licenses qs_licenses_authorization_requests qs_licenses_users qs_licenses_general_settings > licenses_backup.sqlDelete its ensure qs-licenses line from server.cfg and move the folder out of resources/. Both versions answer the same license items, so they must never run at the same time.
Follow Installation from the top, skipping the SQL import. On first boot the console should report the licenses you already had:
[INFO] Loaded 4 license template(s).
[INFO] Loaded 312 issued license(s).
[INFO] qs-licensescreator ready.Any item definition that referred to qs-licenses must now say qs-licensescreator — on ox_inventory that is server = { export = 'qs-licensescreator.useLicenseItem' }. The creator's Inventory item setup button prints the exact snippet.
Version 2 hands out one item per license by default. If your server used a single license item instead, set Config.SeparateItemPerLicense = false and Config.Item to that item's name, so the cards already in players' pockets stay usable.
Search your resources for exports['qs-licenses'] — an MDT, a police job, a driving school — and change the resource name. The export names and their arguments are the same:
-- before
exports['qs-licenses']:RevokeLicense(citizenid, 'driver_license')
-- after
exports['qs-licensescreator']:RevokeLicense(citizenid, 'driver_license')v1 | v2 |
|---|---|
|
|
|
|
Card designs from v1 are kept exactly as they were saved. If you want the new example designs instead, see Common Errors — importing them overwrites the template rows with the same ids.