Overview
A complete electrician job for your server. Design routes in-game with a visual editor and choose which minigame each fault requires. Players run them solo or in groups: they grab the toolbox from the van, repair 3D fuse boxes and level up.
Includes 3 minigames: sort the wires, memorise the breakers and a skill check, plus a random option.
Features
- In-game route editor (
/electricianadmin, ACE permission): create, edit, duplicate and delete routes without touching files. - Visual placement of faults, with preview and position, rotation and radius adjustment. They can use map boxes or spawn their own model.
- Per-fault minigame: wires, breakers, skill check or random. Chosen for each point, while placing it or for the whole route.
- 3D wiring minigame: open the box, loosen the screws, move each wire to its terminal and tighten again. Leave a wire loose and you get an electric shock.
- 3D breaker minigame: memorise the box pattern and repeat it in time.
- Toolbox: taken from the trunk before repairing and returned afterwards. It is shown in hand and its position can be adjusted in-game.
- Configurable work outfit. The player's clothes are restored when finished.
- Per-route payment: cash, bank or item; per fault or at the end; penalty for unrepaired faults.
- Levels and XP (up to 50 levels, configurable curve) and routes that require a minimum level.
- Group routes for up to 4 players with invites. Pay is split or given in full to each member.
- Per-route requirements: job and grade, time limit, per-player cooldown, own vehicle and blip.
- "Electrician" job with 3 grades, auto-registered on QS Core, QBCore and ESX. You can also let any player run routes, without a job.
- Ready-to-use routes: includes 12 starter routes across the city, which you can change in the editor.
- Server-side validation: distances, repair times, minigame results, per-player rate limiting and ACE permissions.
- Interaction with ox_target, qb-target or a key (E). Detected automatically.
- Menu colours of your choice, from in-game.
Compatibility
| Item | Details |
|---|---|
| Frameworks | QS Core, QBCore, ESX (auto-detected) |
| Inventory | qs-coreinventory, qs-inventory, ox_inventory, qb-inventory, ESX inventory (auto-detected). No items need to be created. |
| Dependencies | ox_lib, oxmysql |
| Optional | ox_target / qb-target, qs-textui, qs-smartphone / lb-phone (payment notifications), qs-banking (bank history), qs-corevehiclekeys / qb-vehiclekeys |
| Database | Tables are created automatically on start (MySQL / MariaDB via oxmysql). |
| Language | English (default), Spanish and French. Chosen in Config.Locale and translatable in locales/. |
| Artifacts | No minimum version. Recent artifacts recommended. |
What you can edit
config.lua— language, new route defaults, levels, groups, outfit, vehicles, NPC, minigames, toolbox, electric shock, keys and limitslocales/— all in-game and UI textsbridge/— framework, inventory, bank and phone adapters, in case you use other resources- From the in-game editor — routes, faults and their minigames, NPC position, vehicle spots, return point, who can work and menu colours
Installation
- Download the script from Keymaster → Granted Assets (Cfx.re portal).
- Copy the
lt-electricianfolder intoresources/without renaming it (if using FTP, binary mode). - Add to
server.cfg, after its dependencies:
ensure ox_lib ensure oxmysql ensure lt-electrician add_ace group.admin lt_electrician.admin allow
Restart the server: tables and starter routes are created automatically. Use /electricianadmin to edit them or create your own.
Full guide: lite-scripts.com/docs-electrician
License & delivery
- Delivery: automatic to your Cfx.re account (Keymaster) after payment.
- Protection: Cfx.re Asset Escrow. Configurable files are left open.
- License: for your Cfx.re account, on as many servers as you want. No reselling, sharing or leaking.
- Updates: free forever, announced on Discord.
- Third-party 3D models: "Small Fuse Box" by big guy (CC BY 4.0) and "Electric Distribution Box" by Avadhoot (CC BY-SA 4.0), adapted for the minigames.