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

# Cuxial Electrician

Crew-based electrician job for FiveM: transformers, house panels, street lamps, traffic lights and utility poles.

Cuxial Electrician is a job for one to four players who repair the power grid of a region of the map and get paid when they bring the service trucks back. Each kind of fault has its own minigame, and street lamps and utility poles are repaired from a ladder or a lifting platform.

## What it does

* **Five kinds of repair.** Transformers, house panels, street lamps, traffic lights and utility poles, picked at random in the chosen region on every job.
* **Three minigames.** A breaker box tested with a multimeter, traffic light wiring by colour, and wire welding.
* **Work at height.** Street lamps are reached with a ladder taken from the truck; poles with a platform the crew builds and raises. Both are configurable.
* **Traffic light junctions.** The lights of a junction flicker until its transformer is fixed; only then can each light be repaired.
* **Crews.** The owner invites nearby players, picks the region and can split the money by percentage.
* **Service trucks.** One truck per job, and a second one for larger crews. All of them must come back to get paid.
* **Progress.** Levels with XP, regions locked by level, daily tasks, job history and ranking.
* **One panel.** Home, progress, ranking and a guide tab that explains every repair.
* **Work clothes** (optional) put on at the start of the job and removed at the end.
* **Reconnection.** A player who drops during a job keeps their seat for a configurable time.
* **Logs** to a Discord webhook and an audit table in the database.

## Requirements

| Resource             | Required | Used for                                                               |
| -------------------- | -------- | ---------------------------------------------------------------------- |
| OneSync              | Yes      | Server-side trucks, platforms and distance checks                      |
| `ox_lib`             | Yes      | Callbacks, commands, key bindings, notifications, locales              |
| `oxmysql`            | Yes      | Profiles, history, ranking and audit                                   |
| `cuxial_bridge`      | Yes      | Connects to your framework (QBox, QBCore or ESX)                       |
| `cuxial_jobs`        | Yes      | Shared library of the Cuxial jobs. Delivered with the script           |
| `sleepless_interact` | Yes      | Interaction with the job NPC, the repair points, ladders and platforms |
| `cuxial_garages`     | No       | Gives and removes the keys of the service trucks                       |

{% hint style="info" %}
The ladder for street lamps uses a game model added in game build 2944. On older builds the script falls back to a shorter ladder. See [Installation](/scripts/jobs/cuxial-electrician/installation.md).
{% endhint %}

## Pages

<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>Dependencies, convars and start order.</td><td><a href="/scripts/jobs/cuxial-electrician/installation.md">Installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Every option in <code>shared/config.lua</code> and the editable data files.</td><td><a href="/scripts/jobs/cuxial-electrician/configuration.md">Configuration</a></td></tr><tr><td><strong>Commands &#x26; permissions</strong></td><td>Player and staff commands, keys and who can work.</td><td><a href="/scripts/jobs/cuxial-electrician/commands.md">Commands &amp; permissions</a></td></tr><tr><td><strong>Exports &#x26; events</strong></td><td>Read a player's crew and level, and react when a job is paid.</td><td><a href="/scripts/jobs/cuxial-electrician/developers.md">Exports &amp; events</a></td></tr><tr><td><strong>Troubleshooting</strong></td><td>Common problems and how to fix them.</td><td><a href="/scripts/jobs/cuxial-electrician/troubleshooting.md">Troubleshooting</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/jobs/cuxial-electrician.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.