Skip to content
⌘ K

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 – 20Tire 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#

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

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)

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

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

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

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

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:

OptionRequirement
Open / Close HoodVehicle unlocked
Repair RadiatorHood open
Repair EngineHood open
Open / Close TrunkVehicle unlocked
Repair Fuel TankTrunk 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.