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/FullyRepairCurrentVehiclefor 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#
Install the resource#
Install dependencies and place s4-wheeldamage in your resources folder.
Add it to server.cfg#
ensure ox_lib
ensure s4-bridge
ensure s4-wheeldamage
Restart the server#
Restart the server.
Test damage behavior#
Crash a vehicle at speed — wheels and parts will take realistic damage.
Repair with the toolbox#
Use the toolbox item to repair.
See Installation for full setup and Player guide for repair workflows.