MS_HwyWrk | Heavy Rotator Wrecker for FiveM

A heavy rotator tow truck with working equipment. Turn and extend the boom, carry the winch hooks to a wreck, lift it, tow with the wheel-lift, and light up the scene. Everything is controlled from the truck's own panels and synced to every player.

## Rotator and winches

- **360° rotating boom** that raises and extends in 2 stages

- **3 winches**: 2 over the boom head plus a rear drag winch

- **Carry the hook** to any vehicle, attach it, then wind in to pull or lift. Hanging vehicles swing on the cable.

- **Stability rule**: with a load on a boom winch, the boom will not lift, extend or rotate until the outriggers are planted. Lowering always works.

## Towing

- **Wheel-lift**: lock a vehicle's wheels in the forks, lift and drive. The towed vehicle follows behind like a trailer.

- **Trailer hitch** on the wheel-lift

- **Outriggers** that really lift the truck off its wheels

## Operator controls

- **Two rear control panels** with 12 levers each. The lever you hold moves, and other players see it move.

- **Cab switch panel**: PTO, amber lightbar, beacons, green lights, work lights, scene lights. Each rocker shows its state.

- Emergency stop, and the levers only work with the PTO on

## Lights and sound

- Amber warning lights with fast flash patterns

- **2 rotating roof beacons** with sweeping beams

- Green lights, work lights and scene lights (lights only, no siren)

- **Air horn** on the horn key (replaces the game horn)

- **Reverse alarm** when backing up

- Machinery sounds for the turret, boom, winches, pump and outriggers

## Server-ready

- **Permissions**: everyone, ACE, or ESX / QBCore / Qbox jobs, with an optional on-duty check

- **Server-side checks** on every action: permission, distance to the truck, vehicle model

- **Fully synced** with state bags: every player sees the same boom, cables, hooks and lights

- **Collisions** on the turret, boom and wheel-lift arms

- **Optimised**: 4 levels of detail, and the script only runs every frame while something is moving or lit (10 updates per second when idle)

## Customisation

- `config.lua` and the language file stay open (asset escrow): keys, speeds, cable lengths, lights, sounds, permissions

- English and French included

- **Livery-ready**: ships in plain paint, with a livery layer and a UV guide to paint your own

## Included

- Vehicle `ms_hwywrk` (with close-up high-detail model)

- Moving parts, textures, sounds, scripts and a full README

## Requirements

- FiveM server with **OneSync**

- No framework required. ESX, QBCore or Qbox are only needed for job permissions.

## Installation

1. Put the `MS_HwyWrk` folder in your `resources` folder

2. Add `ensure MS_HwyWrk` to your `server.cfg`

3. Restart the server

4. Spawn `ms_hwywrk` from your garage or admin menu (for example `/car ms_hwywrk` on ESX)

## Controls

| Key | Action |

|---|---|

| **G** | Use a rear control panel (on foot) or the cab switches (driver) |

| **Q** | Amber lightbar and beacons on / off |

| **E** (on foot) | Take / attach / drop a winch hook |

| **E** (driver) | Air horn |

| **Left click (hold)** | Move a lever |

| **C** | Wide / close panel view |

| **Backspace** | Exit the panel |

Players can change G, Q and E in their FiveM key bindings.

**Support:** [ Discord link]