Configuration

config/config.lua

Main Settings

boolean

default:"false"

Shows polyzones created inside the game.

boolean

default:"true"

Enables exploit check box zones. Disable if this causes polyzone issues.

boolean

default:"false"

Disables all minigames for flow testing.

string

default:"'ox_target'"

Interaction system. Must match the bridge setting: ox_target, qb-target, or interact.

boolean

default:"false"

Disables particle effects during robberies.

boolean

default:"true"

Disables the C4 explosion when blowing up ATMs. Keep true if your anticheat blocks explosion events.

boolean

default:"false"

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

table

default:"{\"police\"}"

Jobs that count as police for approach cop checks and dispatch alerts.

PoliceJobs = {"police", "fbi"}

number

default:"750"

Client wait interval for rope handling. Higher values lower resmon (rope loads slower); lower values increase responsiveness (higher resmon).

number

default:"170.0"

Physics weight of the ATM while being dragged by a vehicle. Lower values weigh the car down less.

string

default:"'initiation'"

When cooldown starts: 'initiation' (starting the robbery) or 'rope' (attaching the rope to the car).

boolean

default:"true"

Removes step items after each step. Set to false to keep items for crafting, pawn shops, etc.

string

default:"'X'"

Default key for /removerope (RegisterKeyMapping). See the Commands page.

number

default:"38"

Control ID to stop the beating approach. 38 is [E] by default.

boolean

default:"true"

Shows the destroy ATM interaction on placed consoles.

number

default:"5000"

Duration in milliseconds for success and error notifications.

boolean

default:"false"

Requires players to meet per-approach RequiredLevel via the bridge XP system before starting that approach.

boolean

default:"false"

Resets ATM consoles after cooldown (rope and explosive approaches).

Cooldowns

boolean

default:"false"

Enables a global cooldown shared across approaches. When active, per-approach cooldowns are disabled.

number

default:"10"

Global cooldown duration in minutes.

boolean

default:"true"

Enables per-player cooldowns.

number

default:"10"

Per-player cooldown duration in minutes.

Dispatch

table

Dispatch alert settings used by the bridge.

Dispatch = {
    Title = 'ATM Robbery',
    Message = 'ATM being robbed',
    Code = '10-35',
    Time = 3,
    Blip = {
        Text = '911 - ATM Robbery',
        Color = 1,
        Sprite = 272,
        Scale = 1.0,
    },
}

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. Total chance across items should 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 stress on minigame failure.

number

default:"90"

Percentage chance that stress is applied on a minigame fail.

table

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

Minimum and maximum stress applied per failure.

Approaches

Each entry in Config.Approaches can be enabled or disabled with Status. Toggle approaches independently to suit your server economy.

Approach	Required items	Notes
`Rope`	`laserdrill`, `nylonrope`, `screwdriverset`	Drill holes → rope to vehicle → pull console → place & break down
`Drill`	`laserdrill`	Direct drill loot on the ATM
`C4`	`weapon_stickybomb`	Plant sticky bomb and loot exploded console
`Thermite`	`thermite`	Burn through the ATM
`Hacking`	`x_device`	Device hack for smaller payout
`GasTank`	`x_gastank`, `lighter`	Ignite a gas tank on the ATM
`Beating`	Weapons in `Config.Weapons`	Melee smash; lowest payout
`Impersonation`	`x_fakecredit`	Fake credit card swipe

All approaches share the same config structure. Fields common to most approaches:

Status, RequiredItem / RequiredItem2 / RequiredItem3
ItemsBreak, Cooldown, ProgressBarDuration
RobberyTimeFrame, CopsRequired, RequiredLevel, Exp
Jackpot (Status, Chance, Multiplier)
Dispatch / Reward (ItemForCash, CashName, CashItem, CashAmount, ItemInfo)

The Rope approach also has pull timing (MinimumDurationToRemoveAtmFromWall, SpeedFactor), pickup timer, tracker, and extra dispatch flags.

Example: Drill approach structure

["Drill"] = {
    ["Status"] = true,
    ["RequiredItem"] = "laserdrill",
    ["ItemsBreak"] = { ["Drill"] = 100 },
    ["Cooldown"] = 5,
    ["ProgressBarDuration"] = 25,
    ['RobberyTimeFrame'] = {min = 20, max = 5},
    ['CopsRequired'] = 0,
    ['RequiredLevel'] = 10,
    ['Exp'] = 1,
    ['Jackpot'] = {
        ['Status'] = true,
        ['Chance'] = 10,
        ['Multiplier'] = 2,
    },
    ['Dispatch'] = {
        ['Status'] = true,
        ['Chance'] = 100,
    },
    ["Reward"] = {
        ['ItemForCash'] = false,
        ['CashName'] = 'cash',
        ['CashItem'] = "markedbills",
        ['CashAmount'] = {min = 1000, max = 2000},
        ['ItemInfo'] = false,
    }
},

Props

Config.Props = {
    ["Default"] = {"prop_atm_02", "prop_atm_03", "prop_fleeca_atm"},
    ["CustomConsoles"] = {"projectx_atm_02", "projectx_atm_03", "projectx_fleeca_atm"},
    ["CustomFrames"] = {"projectx_atm_02_frame", "projectx_atm_03_frame", "projectx_fleeca_atm_frame"},
    ["ExplodedConsoles"] = {"projectx_atm_02_exploded", "projectx_atm_03_exploded", "projectx_fleeca_atm_exploded"},
}

Default GTA ATM models are targeted for approaches. Custom console/frame/exploded models come from projectx-atmprops.

Placeable ATM Settings

Config.Settings controls placing pulled ATM consoles:

Config.Settings = {
    ['PlacementMinDistance'] = 2.5,
    ['Atms'] = {
        ['Atmred'] = { ['Prop'] = 'projectx_atm_03', ['ItemName'] = 'atmred' },
        ['Atmblue'] = { ['Prop'] = 'projectx_atm_02', ['ItemName'] = 'atmblue' },
        ['Atmgreen'] = { ['Prop'] = 'projectx_fleeca_atm', ['ItemName'] = 'atmgreen' },
    }
}

Breakdown Steps

After placing a pulled console, players break it down in three steps (Config.Steps):

Step	Tool	Reward
`FirstStep`	`blowtorch`	`atmpanel`
`SecondStep`	`atmpanel`	`atmcables`
`ThirdStep`	`atmcables`	`atmmotherboard` (also required to take cash)

Vehicle Classes (Rope)

Config.Vehicles is a blacklist of vehicle classes for the rope pull. Commented-out classes are whitelisted. By default, SUVs (2), Off-road (9), Industrials (10), Utility (11), Vans (12), Military (19), and Commercial (20) are allowed.

Beating Weapons

Config.Weapons lists melee weapons allowed to start the beating approach (nightstick, hammer, bat, crowbar, golf club, hatchet, machete, wrench, battle axe).

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.

Getting Started

Project X Bridge

Paid Resources

Free Resources

config/config.lua

Main Settings

Cooldowns

Dispatch

Bonus Items

Evidence & Stress

Approaches

Props

Placeable ATM Settings

Breakdown Steps

Vehicle Classes (Rope)

Beating Weapons

Logs