For the complete documentation index, see llms.txt. This page is also available as Markdown.

F.A.Q

Common setup mistakes and quick fixes.

Missing props, markers, or fusebox models

Ensure electricianjob-assets is installed, started before 0r-electricianjob.

The server checks this dependency on startup. Check the console for version warnings.

I cannot start the job

Common causes:

  • Wrong crew size — Easy needs 1–2 players; Hard needs 3–4.

  • Not the leader — only the lobby leader can start.

  • Scenario cooldown — each player has a per-scenario cooldown (default 15 minutes).

  • Region in use — another active crew already took that scenario’s region; wait or try again.

Lamp repair does not start

Lamp points require the primary crane truck:

  1. Deploy outriggers on utillitruck4.

  2. Move the bucket near the streetlight.

  3. Enter the bucket seat via target.

  4. Press [E] in the interaction zone.

Standing on foot at a lamp marker will not work.

No payment or XP after finishing

Rewards are only granted when all repair points are complete when the leader ends the job.

If objectives were skipped, the warning UI appears and no payout is made.

Also verify paymentAccount in config/main.lua matches an account your framework supports (e.g. cash, bank).

XP is not saving

Check:

  • setup.autoSQL = true or manual import of sql/electricianjob.sql

  • oxmysql is running and connected

  • Table 0r_electrician_players exists with write access

XP is saved every 2 minutes and on player disconnect.

Invites do not work
  • Target must be within inviteDistance (default 10 m).

  • Target cannot already be in another lobby or mid-job.

  • Only the lobby leader can send invites.

Two crews conflict on the same map area

By design, two active lobbies cannot use the same scenario + region at once. One crew must finish or leave before another gets that region.

Each job still picks a random region from the scenario pool, so conflicts are less common with multiple regions configured.

Work trucks disappear or pay is reduced

If trucks are destroyed or despawned before job end, vehicle.lostPenalty (default 10%) is deducted per lost vehicle from each member’s pay.

The leader sees a warning when ending if vehicles are missing.

Notifications or progress bars look wrong

Set the correct backend in config/main.luasetup:

  • notify — for errors and job messages

  • progress — for the pre-minigame check bar

  • textui — for [E] interact text

Use a specific resource name instead of 'auto' if LTBridge picks the wrong one.

How do I add another employer location?

Add a new entry to the employees array in config/main.lua with coords, model, vehicleSpawnCoords, and optional blip.

See Configuration for field details.

Last updated