Requirements#
These resources must be installed and started before s4-wheeldamage:
- ox_lib
- s4-bridge (included with S4 Scripts packages)
Optional:
- qb-target — Enables hood/trunk target interactions on vehicles when repairing
Steps#
Extract the resource#
Extract s4-wheeldamage into your resources folder.
Add the startup order#
Open server.cfg and add:
ensure ox_lib
ensure s4-bridge
ensure s4-wheeldamage
Start the server#
Start or restart your server.
Resource name#
The folder name must be exactly:
s4-wheeldamage
The script enforces this at startup. Renaming the folder will cause the resource to halt with a warning.
First test#
Join and spawn a car#
Join the server and spawn a car.
Crash into a wall#
Drive into a wall at moderate speed (10+ m/s).
Check the damage#
Check that tires burst or wheels break off.
Use the repair item#
Use the repair_toolbox item from inventory.
Repair the vehicle#
Place the toolbox near the vehicle and select a repair tool.
Land restriction data#
On first start, the server auto-generates landData.json with default surface settings for all vehicle classes. Use the /editLandRes command (admin) to customize per-surface handling and speed limits in-game.
Target system#
If qb-target is present, vehicle hood/trunk interactions are registered automatically. The script converts onSelect callbacks to action format for qb-target compatibility in fm.lua.