prp-storerobbery

A server-authoritative store robbery resource with complex reward flows, minigames, and deep integration.

Features

• Complete Robbery Loop: Threaten clerk -> Loot bag -> Hack computer -> Crack safe.
• Secure Rewards: Server-side validation of all payouts to prevent abuse.
• Integrations:
  • Works seamlessly with `prp-shops` for dynamic locations.
  • Auto-supports `ps-dispatch`, `cd_dispatch`, `qs-dispatch`, and others.
  • `rcore_cam` integration for CCTV alerts.
• Minigames: "PathFind" hacking minigame (via `bl_ui`) and safe cracking mechanic.

Installation

1. Ensure dependencies are started first:

   ensure ox_lib
   ensure qbx_core
   ensure ox_inventory
   ensure ox_target
   ensure prp-shops  # REQUIRED for locations
   ensure bl_ui      # For minigames

2. Add `ensure prp-storerobbery` to your `server.cfg`.
3. Configure `config.lua` to match your server's police count.
4. Restart server and run `storerobbery:doctor` in console to verify setup.

Configuration

The resource is highly configurable via `config.lua`.

Core Settings

Config.Framework = 'auto'  -- Auto-detects Qbox/QBCore/ESX
Config.Target = 'auto'     -- Auto-detects target system
Config.Police = {
    MinRequired = 0,       -- Minimum police online to rob
    Jobs = { 'police' }
}

Security & Cooldowns

Config.Security = {
    StartCooldownSeconds = 30,
    RequireWeapon = true,
    RequireBagBeforeHack = true  -- Must loot clerk first
}
Config.Cooldowns = {
    StoreSeconds = 4500  -- 75 minutes per store
}