s4-wheeldamage

Realistic vehicle crash damage for FiveM. Wheels burst or break off, engines leak oil, radiators overheat, and fuel tanks spill — with a full toolbox repair workflow.

Features

• Crash detection — Raycast-based impact zones on every vehicle surface

• Wheel damage — Tire burst at low speed, full wheel breakage at high speed

• Part damage — Engine oil leak, radiator leak, fuel tank leak (configurable)

• Toolbox system — Place a toolbox and repair wheels, engine, radiator, and fuel tank

• 3D wheel repair — Interactive bolt-tightening minigame with wrench prop

• Land restriction — Per-surface handling and speed limits by vehicle class

• Mechanic compatibility — Auto-syncs with ESX/QBCore/jim-mechanic repair events

• Server sync — Damaged wheel state synced across all players

• Exports — FullyRepairVehicle / FullyRepairCurrentVehicle for external scripts

Dependencies

Resource	Required
ox_lib	Yes
s4-bridge	Yes
qb-target	Optional

Supported frameworks

Via s4-bridge:

• Qbox (qbx_core)

• QBCore

• ESX

Quick start

1

Install the resource

Install dependencies and place s4-wheeldamage in your resources folder.

2

Add it to server.cfg

ensure ox_lib
ensure s4-bridge
ensure s4-wheeldamage

3

Register the item

Register the repair_toolbox item in your inventory (see Items).

4

Restart the server

Restart the server.

5

Test damage behavior

Crash a vehicle at speed — wheels and parts will take realistic damage.

6

Repair with the toolbox

Use the toolbox item to repair.

See Installation for full setup and Player guide for repair workflows.