usage

How crash damage works

When your vehicle collides with something, the script:

1. Measures your speed at impact

2. Raycasts from the vehicle center to each damage indicator point (wheels, front, rear, roof, etc.)

3. Applies damage only to zones that actually hit something

Wheel damage levels

Speed (m/s)	Effect
10 – 20	Tire burst (flat tire)
21+	Wheel breaks off completely

After a wheel-impact crash, the engine may stop for a short period (configurable).

Part damage

When the front center zone is hit:

• Radiator — Coolant leak, engine overheats, engine dies after 60 seconds if not repaired

• Engine — Oil leak, engine dies after 60 seconds if not repaired

When the rear center zone is hit:

• Fuel tank — Fuel leak, fuel level drains over time

Each part has a minimum speed threshold (default: 5.0 m/s). Enable/disable individually in Config.PartSettings.

Repairing with the toolbox

1

Place the toolbox

1. Use the repair_toolbox item from inventory

2. A ghost preview appears in front of you

3. Press E to place, X to cancel

2

Select a repair tool

Target the placed toolbox and choose a tool:

• Wheel's Repair Tool — Fixes burst or missing wheels

• Wheel Torque Wrench — Interactive bolt minigame for wheel removal/installation

• Fuel Tank Repair Kit — Repairs fuel tank (requires trunk open)

• Radiator Repair Kit — Repairs radiator (requires hood open)

• Engine Overhaul Kit — Repairs engine (requires hood open + welder placement)

3

Wheel repair

Quick repair (Wheel's Repair Tool):

1. Select the tool from toolbox

2. Carry the spare tire to the damaged vehicle

3. Stand near the closest damaged wheel

4. Press E to repair all wheels, or target the specific wheel

Detailed repair (Wheel Torque Wrench):

1. Select the torque wrench from toolbox

2. Approach the vehicle wheel

3. Press E to remove the wheel

4. Complete the bolt-tightening minigame to reattach

4

Engine repair

1. Select Engine Overhaul Kit from toolbox

2. Place the engine welder near the vehicle (press E)

3. Open the hood (target the vehicle bonnet, or use toolbox vehicle options)

4. Target the engine and select Repair Engine

5. Complete the repair animation

5

Radiator repair

1. Select Radiator Repair Kit from toolbox

2. Place the radiator lift (rotate with arrow keys, place with E)

3. Open the hood

4. Target the radiator area and repair

6

Fuel tank repair

1. Select Fuel Tank Repair Kit from toolbox

2. Place the repair kit near the vehicle

3. Open the trunk

4. Target the fuel tank area and repair

7

Pick up toolbox

Target the toolbox and select Pick Up Toolbox to return it to your inventory.

Vehicle target options

When a toolbox is placed nearby, you can also target the vehicle directly:

Option	Requirement
Open / Close Hood	Vehicle unlocked
Repair Radiator	Hood open
Repair Engine	Hood open
Open / Close Trunk	Vehicle unlocked
Repair Fuel Tank	Trunk open

Land restriction

When enabled, driving on certain surfaces changes vehicle handling and may enforce speed limits. Settings are per vehicle class and per surface material (concrete, sand, ice, mud, etc.).

Administrators can edit these values in-game with /editLandRes while sitting in a vehicle.

Leak warnings

If a leak is not repaired within 60 seconds:

• Radiator leak → Engine breaks

• Engine oil leak → Engine breaks

• Fuel tank leak → Leak stops (fuel already drained)

Notifications are shown via ox_lib notify.