Changelog
Released version and their changes.
#Changes
- Integrations now receive documented key-change and robbery events with plate, source, action, access mode, frequency, temporary-status, removal and robbery-context data.
- Compatibility key-removal exports for qb-vehiclekeys, qbx_vehiclekeys, qs-vehiclekeys and wasabi_carlock now resolve supplied identifiers to the correct plate before removing access.
- Players can configure personal engine-start and vehicle-exit behavior through
/keysettings, with the values persisted for the character. - The
GiveKeyexport supports VIN and model-label expansion, replacement-key limit enforcement and reconciliation of matching existing physical keys. - Identifier-based access now persists temporary vehicle grants alongside permanent access instead of treating them as runtime-only.
- Integrations can grant temporary vehicle access through
SetTemporaryAccessand retrieve a vehicle key's frequency throughGetKeyFrequency. - Vehicle key labels now default to the model label and plate format
{MODEL_LABEL} - {PLATE}, while custom labels remain supported. - Garage provider rows remain available without a current runtime key for GPS, summon and key-replacement flows, while lock and engine actions continue to enforce key access.
- Vehicle menu items now treat keys with an unspecified ownership value as owned by default.
- Keys, robbery and vehicle access.
- Lockpicking can be blocked in garage sections when the garage resource is running and the restriction is enabled.
- Lockpicking and hotwiring stop safely when their network target is missing or is not a vehicle.
- The native vehicle hotwire requirement is cleared while the player remains in the vehicle.
- Gunpoint NPC robbery can grant temporary vehicle keys.
- Robbing an NPC can create a physical key bag for the player to pick up instead of granting the temporary key immediately.
- Key-bag pickup props and lifetimes are configurable, with a paper bag lasting 300 seconds by default.
- Robbery integrations now receive client-detected witness status and witness details in the server-side robbery data.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/hooks.lua
- server/locked/*
- server/unlocked/hooks.lua
- shared/unlocked/config.lua
- nui/*
- README.md
- external_support/keys/main.lua
- external_support/keys/qb-vehiclekeys.lua
- external_support/keys/qbx_vehiclekeys.lua
- external_support/keys/qs-vehiclekeys.lua
- external_support/keys/wasabi_carlock.lua
- extras/sounds/carkey_beep.wav
- fxmanifest.lua
#Config Changes
shared/unlocked/config.lua- Edited
Config.Settings.keys.itemLabel.base:"{ITEM_LABEL} - {PLATE}"->"{MODEL_LABEL} - {PLATE}" - Added
Config.Settings.lockpicking.blockInGarageSections=true - Added
Config.Settings.npcVehicles.robbery.gunRob=true - Added
Config.Settings.npcVehicles.robbery.pickupLifetime=300 - Added
Config.Settings.npcVehicles.robbery.pickupModels={"prop_paper_bag_01"} - Added
Config.Settings.personalSettings.command="keysettings" - Added
Config.Settings.personalSettings.force.autoStartEngine=false - Added
Config.Settings.personalSettings.force.holdExitToKeepState=false - Added
Config.Settings.personalSettings.kvp="zyke_vehiclekeys:personal_settings" - Added
Config.Settings.vehicleActions.sounds.keyBeep={name = "carkey_beep.wav", volume = 0.025, distance = 2.0}
- Edited