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.
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.
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.