This documentation covers resource version 1.0.6. The examples assume the resource folder is named
fa_shoprobbery.Why use FA Shop Robbery?
Flexible setup
Use ESX, QBCore, Qbox, or standalone mode with configurable inventory, target, dispatch, and minigame bridges.
Server-authoritative
Reward, distance, cooldown, item, and duplicate-claim checks run on the server.
Built for roleplay
Configure clerk reactions, silent alarms, police requirements, safe methods, reward tiers, and robbery order.
Robbery flow
1
Control the clerk
Intimidate the clerk through your target system, by aiming an allowed weapon, or with either method.
2
Loot the store
Rob individual registers and shelves. Different players can reserve different targets at the same time.
3
Open the safe
Use a keypad, drill, or a configured legacy safe method. The correct keypad code stays on the server.
4
Reset after cooldown
Store, player, and optional global cooldowns control when another robbery can begin.
Start here
Check compatibility
Review required resources and built-in integrations.
Install the resource
Install both resource folders in the correct order.
Configure gameplay
Set bridges, robbery rules, stores, safe access, and rewards.
Connect integrations
Configure supported systems or add a custom adapter.
Use client exports
Connect a custom shop or target to live clerk state.