Subscribe to download
Mileage Expansion

Introducing the "Mileage Expansion" mod, a game-changer for all vehicle enthusiasts! Get ready to embark on a journey of realism and immersion as this mod brings a whole new level of authenticity to your favorite game.

With the "Mileage Expansion" mod, every vehicle in the game now has its own unique mileage system.
As you hit the road, every mile you traverse will be recorded and accounted for.

The mod introduces a comprehensive mileage tracking system that keeps tabs on the distance you've traveled in each vehicle.
Whether you're cruising down the highways, off-roading through rugged terrains, or soaring through the skies, every adventure will leave its mark on your vehicle's odometer.

Random Starting Mileage
Every existing and new car will have a unique starting mileage based on its initial engine condition.

Mileage Counter Options
Clicking the mileage counter opens a menu with options to switch between metric and imperial units and access the trip odometer.

Resettable Trip Odometer
The trip odometer can be reset to zero, allowing you to track distances for specific trips or periods.

Admin Mileage Cheat
The admin has the ability to modify the vehicle's mileage using the mechanic overlay for testing or administrative purposes.

Engine-Based Mileage
Mileage data is stored on the vehicle's engine rather than on the vehicle itself.

One Meter Equals One Tile Square
The in-game measurement system equates one meter to one tile square.

Kilometer to Mile Conversion
Mileage is saved in kilometers but displayed in miles on the counter when the imperial unit is enabled.

Persistent Metric/Imperial Setting
The chosen metric/imperial unit setting is saved on the vehicle, ensuring that other players see the mileage in the last set unit.

Action-Based Operations
Switching between metric/imperial units, showing/hiding the trip odometer, and resetting the trip odometer are actual actions that require time to complete.


Default Unit
Default Unit newly created vehicle starts with. (Miles | Kilometers)

Meter per Kilometer
Set the amount of meter is in a kilometer.
Lower value mean 1 kilometer take less time to travel.
Higher value means 1 kilometer takes more time to travel.

Kilometer Short Name
Set a custom short name for Kilometers. Default: km

Miles Short Name
Set a custom short name for Miles. Default: mi

Minimum Starting Odometer
This is the minimum amount of kilometers used to randomize a vehicle starting odometer value.
The engine condition will affect the final value only.

Maximum Starting Odometer
This is the maximum amount of kilometers used to randomize a vehicle starting odometer value.
The engine condition will affect the final value only.


Creating a translation mod:
When you create a translation mod, make sure to only include the .txt for the language you are translating to.
Never distribute any of lua files from this mod into your own translation mod.

Modify this mod:
About everything is global, designed similarly to the base game.
You can create a mod that requires, extend or patch this mod.
There is an API in shared/ and a global client object to set the odometer.

Mod created by Konijima
Commissioned by Blubbazz

[discord.gg]


Workshop ID: 2980294462
Mod ID: mileage-expansion