Browse docs
Vehicle Systems
Mileage and persistence
Mileage is stored by normalized vehicle plate and is used by wear and vehicle-care systems. The mileage HUD can be enabled independently and its digit count and screen position are configurable.
By default, saved tuning and stance data is restricted to vehicles present in the framework ownership table. This protects world and temporary vehicles from receiving another vehicle's saved setup because of a reused plate.
Diagnostics and wear
The wear system tracks service condition for:
- Tyres
- Brake pads
- Suspension
- Spark plugs
- Engine oil and coolant
- Brake and transmission fluid
- Clutch and air filter
- Catalytic converter
- Electric traction battery and inverter
Each part can define its service distance, required item, item consumption, and repair flow. A distance of 0 is appropriate for parts whose state is controlled by another system rather than normal mileage wear.
Vehicle care
| Feature | Default item | Purpose |
|---|---|---|
| Wash | wash_sponge | Cleans a vehicle |
| Wax | vehicle_wax | Keeps a clean vehicle protected for a configured distance |
| Repair | fix_kit | Repairs configured vehicle damage and selected wear parts |
The repair kit can be limited so dedicated diagnostic repairs remain necessary for selected parts.
Realistic wheel damage
Wheel damage can be scaled by wheel type and vehicle class. Motorcycles, cycles, boats, aircraft, and trains are disabled by default. Review multipliers when using custom vehicle classes or unusual wheel setups.
The default, off-road wheel, and per-class multipliers can be changed through /jobconfig. Decimal values such as 0.1 are supported and new damage calculations use saved values immediately without requiring a client restart. Existing wheel damage must still be repaired or reset before comparing a new multiplier.
Damaged vehicle pushing
Config.VehiclePush allows players to move vehicles whose engine health is below the configured damage threshold. A vehicle does not become pushable merely because its engine was switched off.
Default controls:
| Control | Action |
|---|---|
E | Start or stop pushing from the front or rear |
W / S | Push forward or backward |
A / D | Steer |
SHIFT | Use the stamina-based speed boost |
Up to three players can push one vehicle together. Vehicle weight, slope, helper count, stamina, and configured speed values affect the result. Pushing stops automatically when a player dies, ragdolls, moves too far away, enters a vehicle, or another player takes the driver seat.
Motorcycles, cycles, boats, helicopters, planes, and trains are unsupported by default. Configure the damage threshold, movement values, stamina, HUD position, unsupported classes, and weight groups in config/adv_config.lua.
Electric vehicles
Traction battery and inverter wear apply to vehicles identified as electric. Native electric detection is available on game build 3258 and newer. Maintain Config.ElectricVehicleFallback.models on older builds or for custom models that need explicit classification.
Vehicle profiles and history
The mechanic tablet can associate vehicle profiles and service history with plates. Profiles can include images, notes, tags, and cases. History can record work performed, mechanic identity, duty state, used items, and action details.
Dyno result sharing
After a completed Dyno test, select Share Result to choose a player within 5m. The server verifies that the target is still online and nearby before opening the recipient's tablet directly in the Dyno app.
The recipient receives a read-only result view with the graph and measured values. They cannot connect another vehicle, run a new test, share the result again, or navigate into other mechanic apps from that viewer.
Safe setup checks
- Confirm framework-owned vehicle plates use a consistent format.
- Verify the mileage HUD does not overlap another HUD.
- Test every repair flow and required item.
- Confirm a zero-condition part produces the intended vehicle behavior.
- Test EV and combustion vehicles separately.
- Confirm fix kits do not bypass repairs that should remain diagnostic-only.
- Test vehicle pushing alone and with multiple players on flat ground and slopes.
- Confirm healthy switched-off vehicles cannot be pushed.
- Share a Dyno result with a nearby player and verify the read-only tablet view.