installation

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

1

Extract the resource

Extract s4-wheeldamage into your resources folder.

2

Add the startup order

Open server.cfg and add:

ensure ox_lib
ensure s4-bridge
ensure s4-wheeldamage

3

Register inventory items

Register inventory items — see Items.

4

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

1

Join and spawn a car

Join the server and spawn a car.

2

Crash into a wall

Drive into a wall at moderate speed (10+ m/s).

3

Check the damage

Check that tires burst or wheels break off.

4

Use the repair item

Use the repair_toolbox item from inventory.

5

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.