FreeScriptQBox
postbox_robbery
by xtdocx · version 2026.05.05 · updated 3 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 17 KB
- Code check
- Clean
- Licence
- MIT
- Released
- Nov 2026
Immersive postbox robbery system for FiveM, built for the **Qbox** framework.
postbox_robbery
Immersive postbox robbery system for FiveM, built for the Qbox framework.
Players can pry open any
Features
Resource, Purpose
ox_lib,
qbx_core, Player object, money handling
ox_target, Third-eye interaction
ox_inventory, Item rewards, weapon detection
bl_ui, Skill check minigame
Installation
All tunables live in [
Key, Description
Item names must match real entries in your
Project Structure
Customisation Tips
See AUTHORS.md.
License
Released under the MIT License — see LICENSE for details.
Immersive postbox robbery system for FiveM, built for the Qbox framework.
Players can pry open any
prop_postbox_01a in the world using a crowbar. A bl_ui slider skill check decides the outcome — succeed and walk away with cash plus loot, fail and your hand gets stuck in the postbox while a police alert may fire.Features
- Works on every
prop_postbox_01amap prop in the world — no manual placements needed - Third-eye interaction via ox_target, gated on the player having weapon_crowbar equipped
- bl_ui
Progressskill check (configurable rounds + difficulty) - Skillcheck pops up immediately while the pry animation plays in parallel
- Failure plays the looping
pull_tooth_loop_weak_player"stuck" animation and locks the player in place - Server-validated cooldowns, weapon checks, and reward distribution
- Guaranteed cash + at least one item drop on every success
- Configurable police alert with job-filtered blip on failure
- Clean module structure following the Qbox / ox_lib
requirepattern
Resource, Purpose
ox_lib,
lib.callback, lib.notify, lib.class, requireqbx_core, Player object, money handling
ox_target, Third-eye interaction
ox_inventory, Item rewards, weapon detection
bl_ui, Skill check minigame
Installation
- Drop the
postbox_robberyfolder into yourresources/directory (typically under[illusion]or any other category). - Make sure all listed dependencies are already installed and started before this resource.
- Add to your
server.cfg:
ensure postbox_robbery
- Restart the server (or
refresh; ensure postbox_robberyfrom the console).
All tunables live in [
shared/config.lua](https://github.com/xtdocx/postbox_robbery/blob/main/shared/config.lua). Highlights:Key, Description
PROP_MODEL, Postbox model hash. Default prop_postbox_01a.REQUIRED_WEAPON, Weapon that must be equipped to start a robbery. Default weapon_crowbar.SKILLCHECK.iterations, Number of bl_ui Progress rounds.SKILLCHECK.difficulty, 1–100. Higher = faster slider, smaller target.STUCK.chance, % chance of the stuck-hand penalty after a failed skill check.STUCK.durationMs, How long the stuck animation locks the player (ms).REWARDS.cash, Min/max cash payout on success.REWARDS.guaranteed, Items that always drop on success.REWARDS.bonus, Chance-rolled extras on top of the guaranteed pool.COOLDOWN.perPlayerMs, Per-player cooldown between robbery attempts.POLICE_ALERT.chanceOnFail, % chance to dispatch a police blip on failure.Item names must match real entries in your
ox_inventory/data/items.lua.Project Structure
postbox_robbery/
├── fxmanifest.lua
├── shared/
│ ├── config.lua # All tunables
│ ├── classes/
│ │ └── robbery.lua # Robbery state OOP class
│ └── utils/
│ ├── random.lua # Range / chance helpers
│ └── logger.lua # Centralised logging
├── client/
│ ├── main.lua # ox_target setup + entry point
│ ├── robbery.lua # Robbery sequence / skill check / animations
│ └── dispatch.lua # Police-alert blip handler
├── server/
│ └── main.lua # lib.callback endpoints + validation
└── modules/
├── cooldowns.lua # Per-player cooldown tracking
└── rewards.lua # Loot generation + payout distributionCustomisation Tips
- Different bl_ui minigame: swap
ProgressforCircleProgress,KeySpam,NumberSlide, etc. in [client/robbery.lua](https://github.com/xtdocx/postbox_robbery/blob/main/client/robbery.lua) — the call signature is identical. - Custom dispatch: replace the implementation in [
client/dispatch.lua](https://github.com/xtdocx/postbox_robbery/blob/main/client/dispatch.lua) anddispatchPoliceAlertin [server/main.lua](https://github.com/xtdocx/postbox_robbery/blob/main/server/main.lua) with your dispatch system of choice (ps-dispatch, cd_dispatch, etc.). - Different police jobs: edit the
isPolice()helper in [client/dispatch.lua](https://github.com/xtdocx/postbox_robbery/blob/main/client/dispatch.lua).
See AUTHORS.md.
License
Released under the MIT License — see LICENSE for details.