Configuration

config/config.lua

Main Settings

boolean

default:"false"

Shows polyzones created inside the game. Useful for testing zone placement.

boolean

default:"false"

Disables all minigames. Useful for testing the full robbery flow without completing minigame challenges.

number

default:"38"

The key code used to trigger drawtext interactions. 38 is [E] by default.

vector3

default:"vec3(0.8, 0.8, 2)"

The size of the drawtext interaction zone.

number

default:"70.0"

The default rotation of the drawtext interaction zone. Individual stores can override this in Config.Stores.

boolean

default:"true"

Spawns networked props server side. Set to false to spawn them client side instead.

boolean

default:"true"

Spawns networked peds server side. Set to false to spawn them client side instead.

number

default:"0"

Minimum number of police required online before a robbery can be started. Set to 0 to disable.

table

default:"{\"police\"}"

The jobs that count as police for the MinimumPolice check and dispatch alerts.

PoliceJobs = {"police", "fbi"}

table

Requires a minimum number of players nearby to start a robbery.

RequiredPlayersNearby = {amount = 0, radius = 20.0}

Set amount to 0 or false to disable.

number

default:"0"

Maximum number of store robberies that can be active at the same time. Set to 0 to disable.

boolean

default:"false"

Disables the loud approach path entirely.

boolean

default:"false"

Disables the silent approach path entirely.

boolean

default:"false"

Disables all particle effects during robberies.

boolean

default:"false"

Disables weapon removal during robberies. Only enable this if you use a weapon wheel resource.

Cooldowns & Limits

boolean

default:"true"

When true, robbing one store puts all stores on cooldown. When false, each store has its own cooldown.

number

default:"180"

Cooldown duration in minutes.

number

default:"0"

Per-player cooldown in minutes after completing a robbery. Set to 0 to disable.

table

Maximum robberies per server restart, split by store type. Set each value to 0 to disable.

TotalRobberiesPerRestart = {
    ['Stores247'] = 0,
    ['GasStations'] = 0,
    ['LiquorStores'] = 0,
}

table

Maximum robberies a single player can complete per restart, split by store type. Set each value to 0 to disable.

RobberiesPerPlayer = {
    ['Stores247'] = 0,
    ['GasStations'] = 0,
    ['LiquorStores'] = 0,
}

Skill System

boolean

default:"false"

Requires players to meet a minimum level from an integrated XP/skill system before starting a robbery. Must have an XP system configured in the bridge.

number

default:"10"

Minimum level required to initiate a robbery. Only applies when SkillSystem is true.

Dispatch

string

default:"\"Store Robbery\""

Title shown in the dispatch alert.

string

default:"\"A store is being robbed\""

Message body shown in the dispatch alert.

string

default:"\"10-70\""

Radio code shown in the dispatch alert.

number

default:"5"

Time in seconds the dispatch alert remains visible. Not all dispatch systems support this.

table

Blip settings for the dispatch map marker.

Blip = {
    Text = 'Store Robbery',
    Color = 1,
    Sprite = 41,
    Scale = 0.8
}

table

Controls which steps trigger dispatch alerts. Loud and Silent can be enabled independently.

DispatchLocation = {
    ["Loud"] = true,
    ["Silent"] = false,
    ["Register"] = false,
    ["Atm"] = true,
}

Bonus Items

boolean

default:"false"

Enables or disables bonus item drops at the end of a robbery.

number

default:"15"

Percentage chance that any bonus item is given at all.

number

default:"1"

Number of items that can be given from the bonus items table.

table

Table of possible bonus items. Each entry has a Name, Chance (%), and Amount range. The total chance across all items needs to add up to 100%.

Items = {
    {Name = "x_device", Chance = 30, Amount = {min = 1, max = 1}},
    {Name = "x_phone", Chance = 50, Amount = {min = 1, max = 1}},
    {Name = "x_stethoscope", Chance = 20, Amount = {min = 1, max = 1}},
}

Evidence & Stress

boolean

default:"true"

Enables fingerprint evidence drops at the crime scene.

number

default:"50"

Percentage chance that fingerprint evidence is left behind.

boolean

default:"true"

Enables the stress system. Stress is only applied when a minigame is failed.

number

default:"90"

Percentage chance that stress is applied on a minigame fail.

table

default:"{min = 1, max = 3}"

The minimum and maximum amount of stress applied per failure.

Required Items

table

Maps logical item names to your inventory item names.

Items = {
    ["Circuit"] = "x_circuittester",
    ["Lockpick"] = "advancedlockpick",
    ["Harddrive"] = "x_harddrive",
    ["Device"] = "x_device",
    ["Key"] = "storekey",
}

table

Break chance (%) for each item when used during a robbery.

ItemsBreak = {
    ["Circuit"] = 0,
    ["Lockpick"] = 0,
    ["Device"] = 0,
}

Rewards

boolean

default:"true"

Set to true to give money directly. Set to false to give a cash item instead.

string

default:"'markedbills'"

The item name used when Cash is false.

table

The minimum and maximum cash or item amount per reward.

StackAmount = {min = 3000, max = 6000}

boolean | table

default:"false"

Optional item metadata. Used if markedbills or similar items carry random value data in their info table.

Reward tables by store type:

Table	Description
`Config.RegisterStores247`	Register loot from 24/7 stores
`Config.RegisterGasStations`	Register loot from gas stations
`Config.RegisterLiquorStores`	Register loot from liquor stores
`Config.AtmStores247`	ATM loot from 24/7 stores
`Config.AtmGasStations`	ATM loot from gas stations
`Config.SafeStores247`	Safe loot from 24/7 stores (uncorrupted data)
`Config.SafeCorruptStores247`	Safe loot from 24/7 stores (corrupted data)
`Config.SafeGasStations`	Safe loot from gas stations
`Config.SafeLiquorStores`	Safe loot from liquor stores

Shelf loot is configured in Config.RewardShelf. Config.MaxItems controls how many items can be taken from each shelf.

Store Locations

Enable or disable store types and individual locations using these tables:

Config.Stores247 — 24/7 supermarkets (9 locations, default GTA interiors)
Config.GasStations — Gas stations (5 locations)
Config.LiquorStores — Liquor stores (5 locations)

Each enabled location has a full entry in Config.Stores with coordinates, interactions, NPC settings, reset timers, and per-store overrides. Use the store key (e.g. "Strawberry", "Davis") when calling exports.

No custom map is required. This variant uses default GTA store interiors. You can add custom store locations by copying an existing entry in Config.Stores and adjusting the coordinates and interaction zones.

Other Settings

table

Controls the safe code range and UI text for the office computer step.

number

default:"15"

How long the alarm lasts in minutes.

table

Weapons allowed for threatening the clerk during the loud approach. Add or remove weapon hashes as needed.

Step durations (FuseboxDuration, RegisterDuration, ServerDuration, etc.) control how long progress bars run for each interaction step.

Logs

Configured in config/logs.lua.

boolean

default:"false"

Enables or disables the logging system.

string

default:"\"\""

Your Discord webhook URL, or your Fivemerr/Fivemanage API key.

string

default:"\"default\""

The Fivemanage dataset to log activity to. Leave as "default" unless you have a specific dataset configured.

Getting Started

Project X Bridge

Paid Resources

Free Resources

config/config.lua

Main Settings

Cooldowns & Limits

Skill System

Dispatch

Bonus Items

Evidence & Stress

Required Items

Rewards

Store Locations

Other Settings

Logs