Kivo Electrician Job
Kivo Electrician Job is a job script for FiveM. Players start at a job center, form a lobby (alone or with a partner), take jobs from a dispatcher, drive a work van to a site and fix the electrical equipment there. Every finished job pays money and gives XP. Higher levels raise the pay.
You set it up by editing config.lua. Job sites, pay, levels, markers, the work van and the job center are all in that one file.
What players do
Section titled “What players do”- Start at the job center. Players walk to the job center (it has a blip on the map) and choose Start Electrician Job with the target eye. A lobby window opens.
- Form a lobby. The player who opened the lobby is the host. The host can invite another player (the lobby holds 2 players by default) or work alone, then presses Start Job.
- Get a job offer. Dispatch offers a random job near the host. The offer shows a short description, the distance, the pay and the difficulty. The host can take the job, reroll for a different one, or end the job.
- Use the work van. When the host takes a job, a work van is provided and the host gets its keys. Everyone in the lobby gets a waypoint and a blip for the site.
- Repair the site. At the site, players press E near the equipment to start a repair minigame. Some sites are installation jobs instead: players place a see-through prop with a progress bar.
- Get paid and level up. The pay is shared between the lobby members. Each player earns XP, and a level-up shows a notification with the new pay bonus.
Repair minigames
Section titled “Repair minigames”Each repair site uses one of three minigames. The site’s difficulty makes the minigame harder.
| Minigame | Name in config | What the player does |
|---|---|---|
| Wiring | wiring |
Fix the damaged wiring by connecting the wires correctly. |
| Circuit panel | circuit_panel |
A 3D panel puzzle where fuses and power lines are connected correctly. |
| Terminal | terminal |
A terminal-style puzzle. The player types commands and answers (for example START to begin and HELP for instructions). |
If a player closes a minigame before finishing it, the job counts as failed and pays only a reduced amount.
Leveling
Section titled “Leveling”Players earn XP for every job. XP is saved in your database. When a player reaches the XP needed for the next level, the level-up screen shows and the pay multiplier goes up. The default levels give a pay bonus from +10% at level 2 up to +50% at level 6. You can change every level, multiplier and XP value. See Configuration.
Requirements
Section titled “Requirements”| Requirement | Needed | Notes |
|---|---|---|
ox_lib |
Required | Menus, notifications and progress bars. |
ares-core |
Required | The lobby and vehicle resource this job depends on. The folder must be named exactly ares-core. |
oxmysql |
Required | Stores player XP. |
| Framework | Required | ESX (es_extended), QBCore (qb-core) or QBox. |
| Target | Required in practice | ox_target or qb-target. The job center and the work van use target options. |
| Inventory | Optional | ox_inventory or qb-inventory. Only needed if you give job items with Config.JobItems. |
| Vehicle keys resource | Optional | The script triggers the standard keys event vehiclekeys:client:SetOwner when the van spawns. See Examples and troubleshooting. |
| OneSync | Required | Enable it in your server settings. |
Supported systems
Section titled “Supported systems”| Type | Supported |
|---|---|
| Framework | ESX, QBCore, QBox |
| Target | ox_target, qb-target |
| Inventory | ox_inventory, qb-inventory |
| Notifications | ox_lib, or your own system through notify.lua |
| Language | English included. You can add more language files. |
Start order
Section titled “Start order”Start the resources in this order:
oxmysqlox_lib- Your framework
- Your target resource and, if used, your inventory
ares-coreares_electrician
The full server.cfg block is on the Installation page.
Documentation
Section titled “Documentation”- Installation: folder name, dependencies, database and
server.cfg. - Configuration: every option in
config.luaexcept the job site list. - Job sites: how to add, change and remove work locations.
- Language files: edit the English text or add a new language.
- Framework adapter:
shared/framework.lua,notify.luaand how to adapt the script to other resources. - Examples and troubleshooting: ready-made config examples, edge cases and fixes.
See also the scripts index.
