> For the complete documentation index, see [llms.txt](https://docs.tworst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tworst.com/scripts/electrician-job.md).

# Multiplayer Electrician Job

## Overview

**TW Electrician Job** is a multiplayer electrician job: drive the utility truck around the city, raise its lift platform and repair transformers, house circuit boards, street lamps, traffic lights and phone poles. Work alone or as a crew of up to 4 players, share the pay and level up your electrician career.

{% hint style="success" %}
**Version 3.0** runs on **tw-lib**, the free Tworst library. Framework, inventory, vehicle keys, fuel and clothing are detected automatically, and your settings are kept in the database, so **an update never resets your economy, language or settings again.**
{% endhint %}

***

## Features

### Core Features

* **Multiplayer Crew** - Up to 4 players in one lobby; invite nearby players from the job menu
* **Utility Truck** - A work truck with a lift platform you raise and lower to reach high equipment
* **Transformer Repair** - Fix street transformers
* **Circuit Board Repair** - Repair house circuit boards
* **Street Lamp Repair** - Maintain the city's street lamps
* **Traffic Light Repair** - Fix broken traffic lights
* **Phone Pole Repair** - Repair telephone poles
* **Minigames** - A cable game (socket colours shuffle every game) and a welding panel

### Additional Features

* **Reward Split** - The lobby owner decides each member's share of the money reward
* **Level & XP System** - 70 levels, regions can require a minimum level
* **6 Work Regions** - Alta, El Burro Heights, Vespucci, Rockford Hills, Strawberry and Mirror Park
* **Daily Missions** - Daily tasks with extra money and XP
* **Leaderboard** - Top players of the job
* **Reconnect & Restart Safe** - A player who disconnects gets their seat back, and a member takes over the job if the owner drops
* **One Job at a Time** - A player working another Tworst job is offered to leave it first
* **Tutorial** - In-game video tutorials and hint cards on every prompt
* **Admin Menu** - `/twlib`: live lobbies, money paid, players and job settings in one menu
* **Update Notice** - The server console tells you when a new version is out
* **7 Languages** - English, Turkish, German, French, Portuguese, Russian, Arabic

***

## How It Works

### Step 1: Start a Lobby

Go to the electrician NPC and open the job menu. Pick a region, invite players nearby (optional) and start.

### Step 2: Take the Utility Truck

The crew's utility trucks spawn next to the NPC. Drive to the marked work spots.

### Step 3: Repair

Each region gives a random number of each task:

1. **Transformers** - Open the transformer and fix it
2. **House Circuit Boards** - Repair the boards on the houses
3. **Street Lamps** - Raise the lift platform and fix the lamp
4. **Traffic Lights** - Fix the signals at a junction
5. **Phone Poles** - Repair the poles

A failed repair minigame costs some health, so take care.

### Step 4: Get Paid

Deliver the truck back to the region's delivery point to finish. The crew is paid (split by the owner if enabled).

***

## Requirements

| Resource                        | Required | Notes                                                                                                      |
| ------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| [**tw-lib**](/tw-lib/tw-lib.md) | ✅ Yes    | Free. [Download](https://github.com/Tworst-Shop/tw-lib/releases/latest) or from your Cfx.re Granted Assets |
| **oxmysql**                     | ✅ Yes    | Database                                                                                                   |
| **tw\_electrician\_stream**     | ✅ Yes    | Map, props and vehicles (comes with the script)                                                            |
| Framework                       | Optional | QBCore, QBox, ESX, TMC, vRP, or none (standalone)                                                          |

### Optional

| Resource               | Purpose                                                 |
| ---------------------- | ------------------------------------------------------- |
| ox\_target / qb-target | Target interaction instead of the Tworst prompt         |
| Vehicle keys script    | Keys for the utility truck (detected automatically)     |
| Fuel script            | Full tank on the utility truck (detected automatically) |
| Clothing script        | Job uniform on and off (works without one too)          |

{% hint style="info" %}
PolyZone and ox\_lib are **not** required by the script. If you use qb-target, it needs its own dependencies as usual. ox\_lib is only needed if you pick `Config.DrawTextUI = "ox_lib"` (see [Configuration](/scripts/electrician-job/configuration.md#interaction)).
{% endhint %}

***

## Supported Systems (Auto-detected by tw-lib)

Nothing to set in the config: tw-lib finds what runs on your server and prints it on start:

```
[tw-lib] 1.0.0 | framework=qb | inventory=ox_inventory | keys=qs-vehiclekeys | fuel=LegacyFuel | clothing=illenium-appearance
```

| System       | Supported                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Framework    | qbx\_core, qb-core, es\_extended, TMC, vRP, standalone                                                                                                                                                                                                                                                                                                                                          |
| Inventory    | ox\_inventory, qs-inventory, qs-inventory-pro, codem-inventory, codem-inventoryv2, tgiann-inventory, origen\_inventory, ak47\_qb\_inventory, ak47\_inventory, core\_inventory, jaksam\_inventory, one\_inventory, and the framework's own inventory (qb-inventory, ps-inventory, ESX)                                                                                                           |
| Vehicle keys | qbx\_vehiclekeys, qb-vehiclekeys, qs-vehiclekeys, wasabi\_carlock, MrNewbVehicleKeys, jc\_vehiclekeys, Renewed-Vehiclekeys, Jaksam vehicles\_keys, tgiann-hotwire, 0r-vehiclekeys, LifeSaver\_KeySystem, ak47 keys, filo\_vehiclekey, ic3d\_vehiclekeys, is\_vehiclekeys, mk\_vehiclekeys, mm\_carkeys, p\_carkeys, rd\_vehiclekeys, t1ger\_keys, mx\_carkeys, cd\_garage, okokGarage, mVehicle |
| Fuel         | LegacyFuel, ox\_fuel, cdn-fuel, ps-fuel, x-fuel, lc\_fuel, qb-fuel, Renewed-Fuel, myFuel, okokGasStation, qs-fuelstations, BigDaddy-Fuel, esx-sna-fuel, lj-fuel, hyon\_gas\_station, nd\_fuel, rcore\_fuel, ti\_fuel                                                                                                                                                                            |
| Clothing     | illenium-appearance, fivem-appearance, qb-clothing, esx\_skin, rcore\_clothing, codem-clothing, codem-appearance, qs-appearance, 4bit\_appearance, qf\_skinmenu, crm-appearance, tgiann-clothing, 0r-clothing                                                                                                                                                                                   |

{% hint style="info" %}
Using something else? Pick it by hand in the console (`twlib set tw-lib bridge.keys <resource>`), or connect your own script with `exports['tw-lib']:RegisterBridge(...)`. See [tw-lib → Configuration](/tw-lib/tw-lib/configuration.md#choosing-a-script-by-hand).
{% endhint %}

***

## Commands

| Command                    | Who     | Description                                                 |
| -------------------------- | ------- | ----------------------------------------------------------- |
| `/jobresetelectrician`     | Players | Reset your current job (lobby owner)                        |
| `/jobleaveelectrician`     | Players | Leave the crew                                              |
| `/openTutorialelectrician` | Players | Open the video tutorial                                     |
| `/twlib`                   | Admins  | Tworst admin menu: live lobbies, economy, players, settings |
| `twlib` (server console)   | Console | Status, detected scripts, saved settings                    |

***

## Items

The electrician job needs **no inventory items**. There is nothing to add to your inventory.

{% hint style="info" %}
You can still hand out extra items at the end of a region with `missioncompletedItems`. See [Configuration](/scripts/electrician-job/configuration.md#mission-completion-items).
{% endhint %}

***

## Preview

{% embed url="<https://www.youtube.com/watch?v=nRDyul8Zwgw>" %}

***

## Quick Links

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Install or update to 3.0</td><td><a href="/scripts/electrician-job/installation.md">Installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Where settings live and what they do</td><td><a href="/scripts/electrician-job/configuration.md">Configuration</a></td></tr><tr><td><strong>Changelog</strong></td><td>Version history</td><td><a href="/scripts/electrician-job/changelog.md">Changelog</a></td></tr></tbody></table>

***

## Purchase

{% hint style="info" %}
Purchase Multiplayer Electrician Job from tworst.com in two editions: [**Open Source**](https://tworst.com/script/electrician) or [**Escrow**](https://tworst.com/script/electricianescrow).
{% endhint %}
