IMPORTANT: Always back up your current revo_idcard folder and any custom inventory item definitions before updating.
Use this page after downloading the latest Revo ID Card version. It focuses on the upgrade steps that matter for v1.2 so your config, inventory images, and item definitions stay in sync.
Replace the Old Script
- Unzip the newly downloaded bundle
- Open your server
resources folder
- Delete the old
revo_idcard folder
- Move the new
revo_idcard folder into resources
Restore and Review Your Config
Copy your backed-up config.lua settings into the new version, then compare them with the new default config.Revo ID Card v1.2 introduced a config-driven card system. Review the new Config.Cards, Config.CardDisplayDuration, validation settings, and any new options before going live.
Apply the v1.2 Inventory Migration
Revo ID Card v1.2 changed the default inventory image names. You must update your inventory item definitions and replace the images to avoid missing icons or broken item display.Image name changes:
id_card -> revo_design_1.png
driver_license -> revo_design_2.png
firearm_license -> revo_design_3.png
Update ox_inventory/data/items.lua and replace the old image names with the new ones, or replace the existing card entries with this updated version:['id_card'] = {
label = 'ID Card',
weight = 1,
stack = false,
close = true,
description = "Your personal identification card.",
client = {
image = 'revo_design_1.png',
}
},
['driver_license'] = {
label = 'Driver License',
weight = 1,
stack = false,
close = true,
description = "Your driver's license.",
client = {
image = 'revo_design_2.png',
}
},
['firearm_license'] = {
label = 'Firearm License',
weight = 1,
stack = false,
close = true,
description = "Your weapon's license.",
client = {
image = 'revo_design_3.png',
}
},
Then copy the new images from the items-images folder in revo_idcard to ox_inventory/web/images/. Update qb-core/shared/items.lua, or your relevant QB items file, and replace the old image names with the new ones:['id_card'] = {
name = 'id_card',
label = 'ID Card',
weight = 1,
type = 'item',
image = 'revo_design_1.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your personal identification card.'
},
['driver_license'] = {
name = 'driver_license',
label = 'Driver License',
weight = 1,
type = 'item',
image = 'revo_design_2.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your driver\'s license.'
},
['firearm_license'] = {
name = 'firearm_license',
label = 'Firearm License',
weight = 1,
type = 'item',
image = 'revo_design_3.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your weapon\'s license.'
},
Then copy the new images from revo_idcard/items-images to qb-inventory/html/images/. Update your Quasar items file, such as qs-inventory/shared/items.lua, or the relevant items file used by your setup. Replace the old image names with the new ones:['id_card'] = {
name = 'id_card',
label = 'ID Card',
weight = 1,
type = 'item',
image = 'revo_design_1.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your personal identification card.'
},
['driver_license'] = {
name = 'driver_license',
label = 'Driver License',
weight = 1,
type = 'item',
image = 'revo_design_2.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your driver\'s license.'
},
['firearm_license'] = {
name = 'firearm_license',
label = 'Firearm License',
weight = 1,
type = 'item',
image = 'revo_design_3.png',
unique = true,
useable = true,
shouldClose = true,
description = 'Your weapon\'s license.'
},
Then place the new images from revo_idcard/items-images into the image folder used by your Quasar inventory build. If you only change the image files but leave the old names inside your items file, the new images will not appear correctly. Both the items file and the image folder must be updated.
Restart the Updated Resources
Restart your inventory resource first, then restart Revo ID Card:refresh
restart ox_inventory
restart revo_idcard
If you use another inventory, restart that resource instead of ox_inventory.
Updating to v1.2
If you are upgrading from v1.1 or older to v1.2, make sure you complete all of the following:
- Replace the old
revo_idcard script files with the new version
- Review and merge the new config options, especially
Config.Cards, Config.CardDisplayDuration, and validation settings
- Update inventory item image names from the old filenames to the new design-based filenames
- Replace the old card entries in your inventory
items.lua file with the updated code if needed
- Copy the new images from
revo_idcard/items-images into your inventory image folder
Do not skip the inventory migration when updating to v1.2. Old image names like revo_id_card.png, revo_driver_license.png, and revo_weapon_license.png are no longer the default names used by the updated docs and setup.
Verification
After updating, verify the script works correctly:
- Check that the inventory icons load for ID cards, driver licenses, and firearm licenses
- Create a real ID and confirm the card image and data display correctly
- Test fake ID creation if enabled
- Run
/idcheck with a police job to confirm the validation flow works
- If you use custom cards in
Config.Cards, verify you also created matching inventory item definitions
If something looks wrong after updating, compare your inventory item definitions and image filenames first. Most v1.2 upgrade issues come from keeping the old image names in the items file.