Changelog
Released version and their changes.
#Changes
- Added support for resources to offer nearby locks when players use a lockpick from their inventory.
- Using a configured lockpick requires a tension wrench.
- Added a usable lockpick kit that supplies five lockpicks and one tension wrench by default.
- Servers can configure the kit item and its contents.
- Optional kit item definitions for
ox_inventoryandqb-core, and an icon, are supplied.
- Added editable pick wear metadata so servers can adapt icons and labels to their inventory.
- Added support for displaying the resource in each player's chosen language.
#Files Affected
- client/locked/*
- server/locked/*
- server/unlocked/functions.lua
- server/unlocked/kit.lua
- server/unlocked/picks.lua
- shared/locked/*
- shared/unlocked/config.lua
- README.md
- extras/items/README.md
- extras/items/images/256/lockpick_kit.png
- extras/items/ox_inventory.txt
- extras/items/qb-core.txt
- locales/*
- types/items.lua
- fxmanifest.lua
#Config Changes
shared/unlocked/config.lua- Added
Config.Items.kit.lockpick="lockpick" - Added
Config.Items.kit.lockpicks=5 - Added
Config.Items.kit.name="lockpick_kit" - Added
Config.Items.kit.tensionWrenches=1 - Added
Config.Items.usable={"lockpick"}
- Added
#Changes
- Added integration anchors that place the lock close-up at a target surface facing the player, with a clear camera view.
- Lockpick now supports multiple configured pick items, each with its own wear multiplier and optional wear-stage inventory images.
- A prepared usable slot is preferred; otherwise the first configured pick the player has is used.
- The shipped order is
lockpick,veh_lockpick, thenveh_advancedlockpick.
- The server now validates lockpick results before accepting them.
- A win with no pick health left, or one faster than the minimum possible solve time, is rejected as cancelled.
- Pick wear is now saved to the item as the attempt reaches each new wear stage, so reported wear is kept even if the attempt ends early.
StartLockpicknow returnstruefor a validated win,falsefor a snapped pick, andnilwhen the attempt is cancelled or cannot start.- Integrations can consume the server-validated result and pin count of a player's latest finished attempt once, within 30 seconds.
- Added server hooks and events for when a pick is reserved and when an attempt finishes, with finish notifications sent after wear is settled.
- Added two nonstacking pick item names:
lockpickto replace an existing default item, orhook_pickto keep that item for other scripts. Supplied ox_inventory and qb-core definitions cover both; copy only one and match the configured pick name. - Inventory icons are now supplied under
extras/items/images/256/, including the newhook_pickicon, the lockpick wear-stage icons, and the tension wrench icon. The 4096×4096 originals are not bundled and are linked separately. - The resource now warns in the console at startup when a configured pick or tension wrench item is missing from the inventory.
PrepareLockpicknow notifies the player whenever it refuses, whether the slot is not a usable configured pick or the tension wrench is missing.- Fixed a stale result from an earlier attempt being treated as the result of a newly prepared attempt.
- The help panel no longer shows the replace-pick control during real attempts; it remains available in practice sessions.
/lockpicktestis now registered only when debug is enabled and requires thecommandACE; debug is off by default.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- server/locked/*
- server/unlocked/hooks.lua
- shared/locked/*
- shared/unlocked/config.lua
- nui/*
- README.md
- extras/items/README.md
- extras/items/images/256/hook_pick.png
- extras/items/images/256/lockpick.png
- extras/items/images/256/lockpick_wear_1.png
- extras/items/images/256/lockpick_wear_2.png
- extras/items/images/256/lockpick_wear_3.png
- extras/items/images/256/lockpick_wear_4.png
- extras/items/images/256/tension_wrench.png
- extras/items/images/4096/README.md
- extras/items/ox_inventory.txt
- extras/items/qb-core.txt
- locales/*
- types/items.lua
- types/preview.lua
- fxmanifest.lua
#Config Changes
shared/unlocked/config.lua- Removed
Config.Items.images.critical(was"lockpick_wear_3") - Removed
Config.Items.images.damaged(was"lockpick_wear_2") - Removed
Config.Items.images.intact(was"lockpick") - Removed
Config.Items.images.snapped(was"lockpick_wear_4") - Removed
Config.Items.images.worn(was"lockpick_wear_1") - Removed
Config.Items.lockpick(was"lockpick") - Added
Config.Items.lockpicks.[1].images.critical="lockpick_wear_3" - Added
Config.Items.lockpicks.[1].images.damaged="lockpick_wear_2" - Added
Config.Items.lockpicks.[1].images.intact="lockpick" - Added
Config.Items.lockpicks.[1].images.snapped="lockpick_wear_4" - Added
Config.Items.lockpicks.[1].images.worn="lockpick_wear_1" - Added
Config.Items.lockpicks.[1].name="lockpick" - Added
Config.Items.lockpicks.[1].wear=1.0 - Added
Config.Items.lockpicks.[2]={name = "veh_lockpick", wear = 1.0} - Added
Config.Items.lockpicks.[3]={name = "veh_advancedlockpick", wear = 0.5} - Removed
Config.Preview.enabled(wastrue) - Added
Config.Settings.commandPermission="command" - Added
Config.Settings.debug=false
- Removed