Skip to content

Configuration

config/main.lua, scenarios.lua, and levels.lua — setup, job, routes, and progression.

Editable settings live in three files under config/:

FilePurpose
main.luaCore setup, employer NPC, vehicles, markers, minigames
scenarios.luaEasy/Hard routes, rewards, cooldowns, repair points
levels.luaXP thresholds and pay/XP multipliers (levels 1–10)

Open each file and change only what you need — this page is the short reference.


Setup (config/main.lua)#

lua
setup = {
    debug = 4,
    checkVersion = true,
    autoSQL = true,
    textui = 'auto',
    notify = 'auto',
    fuel = 'auto',
    vehiclekeys = 'auto',
    progress = 'auto',
},
OptionDefaultWhat it does
debug4Console output. Use 1 on a live server unless troubleshooting.
checkVersiontrueWarns if a newer script release exists on startup.
autoSQLtrueCreates 0r_electrician_players if missing.
textui'auto'[E] prompts backend.
notify'auto'Toast notifications.
fuel'auto'Fills spawned trucks.
vehiclekeys'auto'Gives keys when the job starts.
progress'auto'Pre-minigame progress bar.

Supported setup.textui values: auto, ox_lib, lt-ui, jg-textui, esx_textui, okokTextUI, cd_drawtextui, lation_ui, lab-HintUI.

Supported setup.notify values: auto, ox_lib, lt-ui, esx_notify, okokNotify, pNotify, mythic_notify, brutal_notify, wasabi_notify, origen_notify, lation_ui, qb-notify.

Supported setup.fuel values: auto, ox_fuel, lt-fuel, LegacyFuel, qb-fuel, qs-fuelstations, cdn-fuel, x-fuel, okokGasStation, esx-sna-fuel, ps-fuel, BigDaddy-Fuel, Renewed-Fuel, lc_fuel.

Supported setup.vehiclekeys values: auto, qb-vehiclekeys, qbx_vehiclekeys, qs-vehiclekeys, mk_vehiclekeys, 0r-vehiclekeys, MrNewbVehicleKeys, t1ger_keys, mVehicle, okokGarage.

Supported setup.progress values: auto, ox_lib, lt-ui, progressbar, lation_ui, wasabi_uikit.

With 'auto', LTBridge picks the first compatible running resource.


General#

OptionDefaultWhat it does
locale'en'UI and notify language — see locales below
currency'USD'Symbol shown in the job menu
currencyFormat'en-US'Number formatting (e.g. tr-TR, de-DE)

Locales in locales/: en, tr, de, fr, pl, es, pt, th, zh.

Set locale to match your server language. Translation files are JSON in the locales/ folder.


Job#

OptionDefaultWhat it does
interactionDistance1.325How close players must be to start a repair
paymentAccount'cash'Framework money account for job payout
inviteDistance10.0Max meters to invite another player

Blips#

blips.employee, blips.vehicle, blips.point — each has label (locale key or plain string), color, sprite, scale.


Employer NPC (employees)#

Array of employer locations. Default is one NPC at 735.74, 130.51, 79.7.

FieldWhat it does
labelDisplay name (locale key or string)
coordsvector4 — position and heading
modelPed model
scenarioIdle animation scenario
blipShow map blip
targetIconTarget menu icon
vehicleSpawnCoordsvector4[] — where work trucks spawn

Add more entries to run multiple job sites.


Vehicles#

lua
vehicle = {
    model = 'utillitruck4',
    lostPenalty = 10,
    secondaryVehicle = {
        model = 'utillitruck3',
        minPlayers = 3,
    },
},
OptionWhat it does
modelPrimary crane truck (do not change unless you know the crane logic)
lostPenaltyPercent deducted from pay per lost truck at job end (e.g. 10 → $1000 becomes $900)
secondaryVehicle.modelExtra truck for larger crews
secondaryVehicle.minPlayersSpawn second truck when crew size is at least this (default 3)

Plates are generated as EC####; fuel is set to 100% on spawn.


Reconnection#

OptionDefaultWhat it does
reconnection.enabledtrueAllow disconnected members to rejoin the same lobby
reconnection.time5Minutes before the player is removed from the lobby

Check problem (pre-minigame)#

OptionDefaultWhat it does
checkProblem.enabledtrueProgress bar before the minigame opens
checkProblem.duration2500Bar duration in ms
checkProblem.animDict / animNamethink animAnimation during the check

Clothing#

OptionDefaultWhat it does
clothing.enabledtrueShow uniform toggle in lobby
clothing.animationtruePlay change animations
clothing.forcefalseAuto-apply uniform on job start
clothing.datacomponent slotsDrawable/texture per body part

Markers#

OptionDefaultWhat it does
useCustomMarkerstrueUse res_markers textures from electricianjob-assets
markers.default—Fallback marker style
markers.fusebox / traffic_light / cable / breaker—Per-type icon, size, color, offset

When useCustomMarkers is false, standard GTA markers are used instead.


Minigames (minigames)#

BlockKey options
lampbrokenChance (0–100), zone size/offset, objects[] streetlight models
fuseboxtickMs, swapDurationMs, successDelayMs
traffic_lightrandomizeInterval min/max ms, traffic light object hashes

animations — per-type in / loop / out anim dicts. traffic_light and breaker can alias cable.


UI#

OptionDefaultWhat it does
ui.roster.position'bottom-right'In-job progress HUD placement

Allowed values: top-left, top-right, left-center, bottom-left, bottom-right, right-center.


Scenarios (config/scenarios.lua)#

Each scenario is one table in the returned array:

FieldWhat it does
idUnique string (easy, hard)
difficulty1 = Easy, 2 = Hard (UI display)
players{ min, max } crew size allowed
imageScenario card image in web/public/images/scenario/
awardsBase { xp, money } before level multipliers
cooldownMinutes after start before same scenario again (0 = off)
regionsArray of regions; each region must have the same number of points

Each point inside a region:

FieldRequiredWhat it does
typeYeslamp, traffic_light, fusebox, cable, or breaker
coordsYesvector3 world position
headingfusebox onlyPed facing at the panel
camerafusebox only{ x, y, z, rotX, rotY, rotZ } for the fusebox view

On job start, one region is picked at random. Edit coordinates to build custom routes for your map.


Levels (config/levels.lua)#

Ten levels. Only XP is stored in the database; level is calculated at runtime from these thresholds.

LevelMin XPXP multiplierMoney multiplier
101.001.00
21001.051.05
32001.101.10
43001.151.15
54001.201.20
65001.251.25
76001.301.30
87001.351.35
98001.401.40
1010001.451.45

Final payout: scenario awards × level money multiplier − vehicle loss penalty.