FreeScript
pickpocket
by xtdocx · version 2026.05.04 · updated 3 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 18 KB
- Code check
- Clean
- Licence
- MIT
- Released
- Nov 2026
Lightweight FiveM pickpocketing script. Players can lift cash and low-tier items from any nearby NPC
lapn_pickpocket
Lightweight FiveM pickpocketing script. Players can lift cash and low-tier items from any nearby NPC by passing a short bl_ui skill check. Framework-agnostic — drops into either an ox_core or qbox server unchanged.
Author: lapn — see AUTHORS for full credits.
Features
Resource, Required, Notes
ox_lib, yes, Module loader, callbacks, notifications
ox_inventory, yes, Cash + items
ox_target, yes, Interaction option on peds
bl_ui, yes, Skill-check minigame
ox_core or qbx_core, yes, Either works — the script doesn't call into either directly
Make sure it starts after the dependencies above.
The resource doesn't call any core-specific API —
ox_core
Works out of the box. ox_core uses ox_inventory by default, so cash via the
qbox (qbx_core)
Works out of the box. qbox also uses ox_inventory natively. If you migrate from qb-core to qbox, no changes are needed in this resource.
qb-core (legacy, not qbox)
This resource targets
Everything tunable lives in [
Cooldown / leash
Skill check
The hack is
Per-tier overrides under
Loot
Each entry rolls independently. Cash is always rolled in
NPC tiers
Three built-in tiers —
Disabling fight-back globally
Set
Police dispatch
Failed pickpockets fire a server event when the per-tier alert roll passes:
```lua
-- payload: { source = src, coords = vector3, reason = 'pickpocket_failed' }
AddEventHandler('lapn_pickpocket:server
…
Lightweight FiveM pickpocketing script. Players can lift cash and low-tier items from any nearby NPC by passing a short bl_ui skill check. Framework-agnostic — drops into either an ox_core or qbox server unchanged.
Author: lapn — see AUTHORS for full credits.
Features
- Pickpocket any ambient NPC via an
ox_target"Pickpocket" option - bl_ui KeyCircle skill check (single round, two keys) — fully configurable
- Reward pool: $5–$60 cash + small chance of low-tier items (configurable)
- 15-second cooldown after success only — no penalty for failing the minigame
- NPC reactions on failure: flee, fight back, or call the cops (per-tier rolls)
- Difficulty / loot / alert chance tiered by ped type (default / cop / military)
- Per-NPC claim system — two players can't pickpocket the same target at once
- Leash check — if the player walks away mid-attempt, it cancels with no penalty
- No per-frame loops on the client; minimal server state
Resource, Required, Notes
ox_lib, yes, Module loader, callbacks, notifications
ox_inventory, yes, Cash + items
ox_target, yes, Interaction option on peds
bl_ui, yes, Skill-check minigame
ox_core or qbx_core, yes, Either works — the script doesn't call into either directly
The resource is purely framework-agnostic. It only touchesInstallationox_inventoryfor money/items andox_libfor RPC + UI. Both ox_core and qbox bundle / standardize on those.
- Drop the
lapn_pickpocketfolder into your server's resources directory (anywhere it gets discovered, e.g.resources/[illusion]/lapn_pickpocket). - Add the resource to your
server.cfg:
ensure ox_lib
ensure ox_inventory
ensure ox_target
ensure bl_ui
ensure lapn_pickpocketMake sure it starts after the dependencies above.
- Make sure the loot items in [
shared/config.lua](https://github.com/xtdocx/pickpocket/blob/main/shared/config.lua) exist in yourox_inventory/data/items.lua(see Items below). - Restart the server.
The resource doesn't call any core-specific API —
source, lib.callback, and exports.ox_inventory are the only touchpoints, and all of them behave identically across ox_core and qbox. No code changes are needed when switching frameworks.ox_core
Works out of the box. ox_core uses ox_inventory by default, so cash via the
'money' item and AddItem / CanCarryItem calls just work.qbox (qbx_core)
Works out of the box. qbox also uses ox_inventory natively. If you migrate from qb-core to qbox, no changes are needed in this resource.
qb-core (legacy, not qbox)
This resource targets
ox_inventory. If you're on stock qb-core with qb-inventory, you'll need to either:
- Switch to ox_inventory (recommended path qb-core → qbox is moving toward), or
- Edit [
server/modules/rewards.lua](https://github.com/xtdocx/pickpocket/blob/main/server/modules/rewards.lua) — replace the twoInventory:AddItemcalls and theInventory:CanCarryItemcheck with your inventory's equivalents (e.g.Player.Functions.AddMoney('cash', cash)andPlayer.Functions.AddItem(item, count)).
Everything tunable lives in [
shared/config.lua](https://github.com/xtdocx/pickpocket/blob/main/shared/config.lua).Cooldown / leash
cooldownSeconds = 15, -- post-success cooldown per player
interactionDistance = 1.5, -- ox_target reach
leashRadius = 3.0, -- cancel if player walks further than this from the NPC mid-attemptSkill check
The hack is
exports.bl_ui:KeyCircle(iterations, difficulty, numberOfKeys). Defaults are intentionally lenient:
hackDefaults = {
iterations = 1, -- rounds; all must pass
difficulty = 15, -- 1-100, lower = easier
numberOfKeys = 1, -- 1 = single A+K-style pair shown
},Per-tier overrides under
tiers..hack let you make cops harder than a random pedestrian.Loot
lootPool = {
{ item = 'rolling_paper', min = 1, max = 2, chance = 0.18 },
{ item = 'lighter', min = 1, max = 1, chance = 0.10 },
{ item = 'phone', min = 1, max = 1, chance = 0.04 },
}Each entry rolls independently. Cash is always rolled in
tiers..cash. Counts are intentionally tiny — this is not meant to be a money-maker.NPC tiers
Three built-in tiers —
default, cop, military — keyed off the ped's GetPedType value (resolved client-side in [client/modules/flow.lua](https://github.com/xtdocx/pickpocket/blob/main/client/modules/flow.lua) and reported to the server only as a string). Each tier carries its own:
hack— KeyCircle paramscash—{ min, max }payout rangealertOnFailChance— 0..1 chance the police dispatch event fires on failurefightBackChance— 0..1 chance the NPC tasks combat against the player on failurefleeOnFail— fall-back to fleeing when not fighting
config.tiers and the tierKeyFor mapping in [flow.lua](https://github.com/xtdocx/pickpocket/blob/main/client/modules/flow.lua).Disabling fight-back globally
Set
config.allowFightBack = false to skip the fight-back roll entirely on every tier. Failed pickpockets will then only ever produce a flee (or idle if fleeOnFail is also off). Useful for low-RP servers where you don't want random NPCs swinging at players.Police dispatch
Failed pickpockets fire a server event when the per-tier alert roll passes:
```lua
-- payload: { source = src, coords = vector3, reason = 'pickpocket_failed' }
AddEventHandler('lapn_pickpocket:server
…