96 online 3 members  + Join RP Base  +
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

pickpocket
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
  • 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

Dependencies
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 touches ox_inventory for money/items and ox_lib for RPC + UI. Both ox_core and qbox bundle / standardize on those.

Installation
  1. Drop the lapn_pickpocket folder into your server's resources directory (anywhere it gets discovered, e.g. resources/[illusion]/lapn_pickpocket).
  2. Add the resource to your server.cfg:
   ensure ox_lib
   ensure ox_inventory
   ensure ox_target
   ensure bl_ui
   ensure lapn_pickpocket

Make sure it starts after the dependencies above.
  1. Make sure the loot items in [shared/config.lua](https://github.com/xtdocx/pickpocket/blob/main/shared/config.lua) exist in your ox_inventory/data/items.lua (see Items below).
  2. Restart the server.

Framework Notes
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 two Inventory:AddItem calls and the Inventory:CanCarryItem check with your inventory's equivalents (e.g. Player.Functions.AddMoney('cash', cash) and Player.Functions.AddItem(item, count)).

Configuration
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-attempt

Skill 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 params
  • cash — { min, max } payout range
  • alertOnFailChance — 0..1 chance the police dispatch event fires on failure
  • fightBackChance — 0..1 chance the NPC tasks combat against the player on failure
  • fleeOnFail — fall-back to fleeing when not fighting

Add more tiers by extending 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

…