Overview

Go beyond simple "press E to rob". Threaten the clerk or use location-based start (no clerk ped required) to fill the bag, loot the register, hack the back office computer to get the safe code, and then crack the safe for the big payout. All rewards are validated server-side. prp-shops is optional when fallback mapping from robberylocations.lua is enabled.

Server Authoritative

All logic and rewards are handled on the server, making it impossible for cheaters to exploit.

Hacking & Cracking

Integrated minigames for hacking computers and cracking safes add depth to the robbery.

Camera Support

Compatible with rcore_cam and other camera scripts for enhanced immersion.

Dispatch Integration

Supports ps-dispatch, cd_dispatch, and more out of the box.

Integrations & Compatibility

System Support Level Notes
Frameworks Qbox, QBCore, ESX Auto-detected at startup
Inventory ox_inventory, qb-inventory, qs-inventory Bridge provided
Target ox_target, qb-target Optional (TextUI fallback)

Configuration

Highly configurable to match your server's economy and style.

Config = {}
Config.Debug = false

-- Robbery Settings
Config.RobberyTime = 300 -- Seconds
Config.RequiredCops = 3
Config.Cooldown = 1800 -- Seconds

-- Reward Multipliers
Config.RewardMultiplier = 1.0
Config.LootTable = {
    ['money_bag'] = { chance = 50, min = 1, max = 3 },
    ['gold_bar'] = { chance = 10, min = 1, max = 1 },
}

Frequently Asked Questions

Is this script encrypted?

Yes, it uses FiveM's Asset Escrow system. However, the config.lua and bridge files are fully open for editing.

Do I need prp-shops?

No. You can enable Config.Integrations.AllowRobberySettingsFallback = true and define stores in robberylocations.lua only. prp-shops (or any GetShops provider) is optional when fallback is enabled. Location-based start also allows robbery at stores without clerk peds.