Store Robbery 2.0

Official documentation for prp-storerobbery. Follow these steps to get up and running.

Installation

Download the script from Tebex / Keymaster.
Extract the folder to your server's resources directory.
Ensure dependencies are started before this script in your server.cfg:

ensure ox_lib
ensure ox_inventory
ensure ox_target
# ensure prp-shops   # Optional when AllowRobberySettingsFallback = true
ensure prp-storerobbery

prp-shops is optional: set Config.Integrations.AllowRobberySettingsFallback = true and define stores in robberylocations.lua. Enable Config.Targeting.EnableLocationStartTarget for location-based robbery start (no clerk ped required).

Configuration

The configuration file is located at config.lua. Key options:

Config.Framework = 'auto'   -- qbox, qbcore, esx
Config.Integrations.AllowRobberySettingsFallback = true  -- Use robberylocations.lua only
Config.Targeting.EnableLocationStartTarget = true        -- Start at store coords (no ped)
Config.Police.MinRequired = 0
Config.Cooldowns.StoreSeconds = 4500

Compatibility

System	Support	Notes
Qbox	✅ Native	Full support
QBCore	✅ Native	Full support
ESX	✅ Native	Legacy and current versions

Troubleshooting

Common Issues

Error: "prp-shops not found" - Only when fallback is disabled. Either start prp-shops (or your GetShops provider) or set Config.Integrations.AllowRobberySettingsFallback = true and define stores in robberylocations.lua.
Inventory not opening - Check if you are using a supported inventory system and have the correct bridge.

Still stuck? Open a ticket on Discord.