> 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/builder-job.md).

# Multiplayer Builder Job

## Overview

**tw-builderjob** is a full-scale construction job for FiveM. Work a real building site with your crew — operate a **mobile crane**, a **concrete pump**, a **tower crane** and an **excavator**, carry material by hand, rig loads with slings, and finish **12 different construction regions**, each with its own mechanics.

{% hint style="success" %}
**Multiplayer Support:** Up to 4 players can share a lobby, split the reward, and work the same site together with fully synced machines.
{% endhint %}

***

## Regions (12)

Each region is an independent mini-job with its own flow, machines and rewards.

<table><thead><tr><th width="60">#</th><th width="220">Region</th><th width="180">Type</th><th>What you do</th></tr></thead><tbody><tr><td>1</td><td><strong>El Burro Heights</strong></td><td>Frame &#x26; Concrete</td><td>Build the frame, then pour concrete with the pump</td></tr><tr><td>2</td><td><strong>Tower Crane — Main</strong></td><td>Tower Crane</td><td>Lift stone from the cabin with the tower crane</td></tr><tr><td>3</td><td><strong>Tower Crane — Site 2</strong></td><td>Tower Crane</td><td>Larger tower crane site, longer lifts</td></tr><tr><td>4</td><td><strong>Pipe Yard</strong></td><td>Crane Work</td><td>Sling and place pipe sections with the mobile crane</td></tr><tr><td>5</td><td><strong>Panel Façade</strong></td><td>Hand Carry</td><td>Carry and mount façade panels by hand</td></tr><tr><td>6</td><td><strong>Water Facility</strong></td><td>Pump &#x26; Crane</td><td>Combined concrete pour and crane placement</td></tr><tr><td>7</td><td><strong>Water Facility 2</strong></td><td>Crane Work</td><td>Second facility stage, crane-led</td></tr><tr><td>8</td><td><strong>Sidewalk Repair</strong></td><td>Excavator &#x26; Haul</td><td>Dig with the excavator and haul the dirt away</td></tr><tr><td>9</td><td><strong>Lumber Stacking</strong></td><td>Hand Carry</td><td>Stack lumber by hand into the given pattern</td></tr><tr><td>10</td><td><strong>Plank Decking</strong></td><td>Hand Carry</td><td>Lay plank decking across the structure</td></tr><tr><td>11</td><td><strong>Wall &#x26; Roof Assembly</strong></td><td>Hand &#x26; Crane</td><td>Mixed job — hand work plus crane lifts</td></tr><tr><td>12</td><td><strong>Crane Haul</strong></td><td>Haulage</td><td>Move heavy loads across the site</td></tr></tbody></table>

***

## Machines

All machines ship with the script as **custom vehicles** in `tw-builder-vehicles` — nothing is a re-used base-game model, so they do not clash with anything already on your server.

| Machine              | Highlights                                                                         |
| -------------------- | ---------------------------------------------------------------------------------- |
| **Mobile Crane**     | Slew, main boom, telescope, knuckle boom, winch, slow-precision mode, camera views |
| **Concrete Pump**    | Boom + package + tip sections, outriggers, hopper lid, live pouring                |
| **Tower Crane**      | Static site crane — cabin operation, slew, trolley, hook, cabin camera             |
| **Excavator**        | Dig and load dirt                                                                  |
| **Support vehicles** | Mixer, haulers and tippers for material transport                                  |

All machines are **network-synced** — your crew sees the boom, rope, hook and load move in real time. Machines can be run from the **cabin** or with a **remote control**.

***

## Features

### Core

* **12 construction regions** with genuinely different mechanics
* **Multiplayer lobbies** (up to 4) with owner-assigned reward split
* **Realistic machine controls** — crane, pump, tower crane, excavator
* **Sling & rigging system** with hook grab/release
* **Hand-carry system** — pick up, carry and place material
* **Hologram placement guides** so players see exactly where a piece goes
* **70-level XP progression**

### Systems

* **Training mode** — a practice field to learn the crane, pump and tower crane before working
* **Vehicle rental** — rent from the company lot with a deposit, damage penalty and hand-back on finish
* **Daily missions** (4 rotating tasks)
* **Leaderboard** — top earners and most jobs completed
* **Region stats** and job history
* **Reconnection system** — rejoin your lobby after a disconnect
* **Discord webhook logging** — job start/finish, lobby events, rewards, security
* **Admin panel** (`/builderadmin`) — live lobbies, players, region usage, event log, force-end and site reset
* **Ambient control** — traffic and pedestrians suppressed inside a site
* **Sync quality menu** — per-player visual/performance toggles with an FPS-based Auto mode
* **In-game site & zone builder** (`/tw_bp`) — place new build sites without touching coordinates
* **Movable HUD** — players reposition the UI from Settings

***

## Requirements

| Resource      | Required | Notes                                              |
| ------------- | -------- | -------------------------------------------------- |
| **ox\_lib**   | ✅ Yes    | Hard dependency                                    |
| **oxmysql**   | ✅ Yes    | Hard dependency — tables are created automatically |
| **Framework** | ✅ Yes    | QBCore, QBox, ESX, vRP, or Standalone              |

{% hint style="info" %}
The script ships as **four resources** — `tw-builderjob` (the script), `tw-builder-stream` (**map 1**, the construction sites), `tw-builder-map` (**map 2**, the company HQ) and `tw-builder-vehicles` (the machines). All four must be started. See [Installation](/scripts/builder-job/installation.md).
{% endhint %}

***

## Supported Systems

### Frameworks

| Framework   | Config Value       |
| ----------- | ------------------ |
| Auto-detect | `'auto'` (default) |
| QBCore      | `'qb'`             |
| QBox        | `'qbox'`           |
| Old QBCore  | `'oldqb'`          |
| ESX Legacy  | `'esx'`            |
| Old ESX     | `'oldesx'`         |
| vRP / vRP2  | `'vrp'` / `'vrp2'` |
| Standalone  | `'standalone'`     |

### Inventories

| System           | Config Value         |
| ---------------- | -------------------- |
| Auto-detect      | `'auto'` (default)   |
| QBCore Inventory | `'qb_inventory'`     |
| ESX Inventory    | `'esx_inventory'`    |
| ox\_inventory    | `'ox_inventory'`     |
| codem-inventory  | `'codem-inventory'`  |
| qs-inventory     | `'qs_inventory'`     |
| tgiann-inventory | `'tgiann-inventory'` |

### Interaction

**One setting** decides how players are prompted — `Config.InteractionStyle` in `config/config.lua`:

| Value         | What players see                                         |
| ------------- | -------------------------------------------------------- |
| `'badge'`     | Our world-space badge with an icon — **default**         |
| `'text'`      | Plain 3D text, no badge                                  |
| `'oxlib'`     | `ox_lib` TextUI in the screen corner                     |
| `'ox-target'` | Hands interaction over to **ox\_target**                 |
| `'qb-target'` | Hands interaction over to **qb-target**                  |
| `'auto'`      | Uses ox\_target / qb-target if installed, else `'badge'` |

{% hint style="info" %}
For the three built-in styles (`badge`, `text`, `oxlib`) focus, distance and the **E** key behave **identically** — only where the prompt is drawn changes.
{% endhint %}

{% hint style="success" %}
**Framework, inventory and vehicle keys auto-detect.** Leave them on `auto` and the script reads whatever is running on your server. Set a value by hand only to override.
{% endhint %}

### Languages

**12 languages included:** English, Türkçe, Deutsch, Español, Français, Magyar, 日本語, Nederlands, Português, Română, Русский, Svenska.

{% hint style="success" %}
The language menu is built from the `locales/` folder — drop your own `<code>.lua` in there and it appears by itself, no code change needed.
{% endhint %}

***

## 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>Step-by-step installation guide</td><td><a href="/scripts/builder-job/installation.md">Installation</a></td></tr><tr><td><strong>Configuration</strong></td><td>Complete configuration reference</td><td><a href="/scripts/builder-job/configuration.md">Configuration</a></td></tr><tr><td><strong>Regions</strong></td><td>Guide to all 12 regions</td><td><a href="/scripts/builder-job/regions.md">Regions</a></td></tr><tr><td><strong>Interface</strong></td><td>Job menu, settings, admin panel and site builder</td><td><a href="/scripts/builder-job/interface.md">Interface</a></td></tr><tr><td><strong>Controls</strong></td><td>Machine keybinds &#x26; commands</td><td><a href="/scripts/builder-job/controls.md">Controls</a></td></tr><tr><td><strong>Changelog</strong></td><td>Version history and updates</td><td><a href="/scripts/builder-job/changelog.md">Changelog</a></td></tr></tbody></table>

***

## Purchase

{% hint style="info" %}
Purchase Multiplayer Builder Job from our [Tebex Store](https://tworst.tebex.io) or [CFX Store](https://tworst.com).
{% endhint %}