​
Configuration Guide

This is where you can choose your framework, recommended to just leave this on “auto”.

Config.lua
Config.Framework = 'auto' -- (type: string)

This is where you can set a cooldown to how long it takes a store to reset after it is robbed.

Config.lua
Config.Cooldown = 5 -- (type: integer)

This is where you can set a global cooldown, so after or during a store robbery another cannot instantly be started.

Config.lua
Config.GlobalCooldown = { -- (type: table)

    Enabled = true, -- (type: boolean)

    Time = 4 -- (type: integer)

}

This will enable or disable the 3-erd eye option. (requiers ox_target)

Config.lua
Config.Target = true -- (type: boolean)

This is where you can change and edit things about the progress bar.

Config.lua
Config.Progress = {

    Duration = 20, -- Time in seconds it takes to complete the NPC robbery. (type: integer)

    Increases = { Aiming = 0.3, Shooting = 5.7 }, -- How much the progress increases when aiming or shooting. (type: table)

    Bar = { -- Progress bar (type: table)

        Enabled = true, -- Enable or disable the progress bar. (type: boolean)

        Color = { 0, 255, 0, 200 }, -- RGBA (type: table)

        Position = { 0.5, 0.15 }, -- X, Y (type: table)

    },

    HelpText = { -- Help text

        Enabled = true, -- Enable or disable the help text that displays above the progress bar. (type: boolean)

        Color = { 255, 255, 255, 255 }, -- RGBA (type: table)

        Position = { 0.5, 0.10 }, -- X, Y (type: table)

    }

}

This is where you can change options about the cash register model, if you are using a custom store MLO this may need to be changed.

Config.CashRegister = {

    Model = `prop_till_01`, -- Model (type: hash)

    BrokenModel = `prop_till_01_dam` -- Model (type: hash)

}

This is where you can set a list of jobs that are not allowed to start store robberys.

Config.lua
Config.BlacklistedJobs = {

    ['police'] = true,

    ['ambulance'] = true,

    ['mechanic'] = true,

}

This is where you can edit settings about the safe hack. Please note we have added support for 6 of the most popular hack minigames.

Supported minigames
Supported Hack Minigames (can be edited in modules/sync/client.lua):

- ps-ui (reccomended): https://github.com/Project-Sloth/ps-ui

- ultra-voltlab: https://github.com/ultrahacx/ultra-voltlab

- ultra-keypadhack: https://github.com/ultrahacx/ultra-keypackhack

- datacrack: https://github.com/utkuali/datacrack

- howdy-hackminigame: https://github.com/HiHowdy/howdy-hackminigame



- electus_hacking (paid): https://forum.cfx.re/t/qb-esx-paid-electus-hacking-hacker-job-terminal-hack/4989175
Config.lua
Config.Safes = { -- Safe Configuration

    Hack = 'ps-ui', -- Hacking minigame, see above for a list of minigames.

    Cooldown = 5, -- Time (in minutes) until the safe is reset.

    CooldownOnAttempt = true, -- Enable cooldown as soon as a player attempts to open the safe.

}

Used in disatch to alert police, dispatch can be edited in modules/sync/server.lua

Config.lua
Config.PoliceJobs = { 'police', 'sheriff' } -- (type: table)

This is where you can enable/disable a synchronized alarm sound when the store is being robbed

Config.lua
Config.Alarm = {

    Enabled = true, -- Enable or disable the alarm. (type: boolean)

    Time = 4, -- Time in minutes until the alarm is disabled. (Make this matches up with the progress bar duration) (type: integer)

    Distance = 70.0 -- Distance on how far the alarm can be heard. (type: integer)

}

This is where you can configure the store robberys, you can add/remove as many as you want. (the script comes pre-configured with all 10 gas stations, but for this example I will only be showing one)

Config.lua
Config.Stores = {

    [1] = {

        Ped = {

            Enabled = true, -- Enable/Disable the ped robbery (type: boolean)

            Model = `a_m_y_mexthug_01`, -- The ped model (type: hash)

            Position = vec4(2555.5, 380.8461, 107.6230, 0.0), -- The location of the ped (x, y, z, heading) (type: vector4)

            Rouge = { -- This is where you can edit settings about making the ped go rouge and defend the store.

                Enabled = true, -- Enable/Disable (type: boolean)

                Chance = 15, -- Percentage chance the ped will go rouge (type: integer)

                Weapons = { `WEAPON_PISTOL`, `WEAPON_PUMPSHOTGUN`, `WEAPON_MICROSMG` }, -- The weapons that the ped will use, will randomly select from this table (type: table)

            },

            Rewards = { -- The rewards from picking up the bag after the ped throws it.

                ['black_money'] = { 25000, 50000 }, -- [itemName] = { minAmount, maxAmount }

            }

        },

        Safe = {

            Enabled = true, -- Enable/Disable the safe robbery (type: boolean)

            TargetCoords = vec3(2548.6, 384.8648, 108.06), -- If Config.Target is enabled, this is where the box will be placed (only touch if you know what you doing)

            MarkerCoords = vec3(2549.3774, 384.8537, 108.6228), -- If Config.Target is disabled, this is where the marker will be placed (only touch if you know what you doing)

            RequiredItems = { -- Then required items to hack the safe.

                ['hacking_laptop'] = 1 -- [itemName] = amountRequired

            },

            Rewards = { -- The rewards from hacking the safe

                ['black_money'] = { 25000, 50000 }, -- [itemName] = { minAmount, maxAmount }

            }

        },

    },

}
Getting StartedCommon Issues