Wizard Mileage System
A comprehensive vehicle maintenance and mileage tracking system for FiveM servers that simulates realistic vehicle wear and tear, including oil life, filters, tires, and brake conditions. The system tracks vehicle mileage and component wear, requiring regular maintenance to maintain optimal vehicle performance.- Introduce more features
- Fix existing bugs
- or
- Real-time mileage tracking for owned vehicles
- Configurable distance units (kilometers or miles)
- Customizable mileage display position on screen
- Automatic mileage saving to database
- Command to reset vehicle mileage
- Oil life monitoring based on distance traveled
- Configurable oil change intervals
- Engine damage simulation when oil maintenance is neglected
- Visual warnings for low oil life
- Oil change service interaction for mechanics
- Separate tracking for oil filter life
- Independent oil filter change intervals
- Engine performance impact when filter is worn
- Service option for filter replacement
- Warning system for filter maintenance
- Air filter condition monitoring
- Performance impact on vehicle when filter is dirty:
- Reduced top speed
- Decreased acceleration
- Air filter replacement service
- Warning notifications for filter maintenance
- Tire wear tracking based on distance
- Impact on vehicle handling and grip
- Configurable tire wear rates
- Tire replacement service
- Visual wear indicators and warnings
- Progressive brake wear simulation
- Impact on braking efficiency
- Brake maintenance service
- Warning system for brake condition
- Configurable wear rates and efficiency loss
- Approach a vehicle
- Use the target system (ox_target or qb-target)
- Available maintenance options:
- Change Oil
- Replace Oil Filter
- Replace Air Filter
- Change Tires
- Service Brakes
- Real-time mileage display
- Configurable position (top-left, top-right, bottom-left, bottom-right)
- Component wear display when using /checkwear
- Warning notifications for maintenance needs
- If enabled, only players with the mechanic job can perform maintenance
- Job name configurable in config.lua
- Supports both ox_target and qb-target systems
- Target-based interaction system
- Progress bars for maintenance actions
- Cancelable maintenance procedures
- Animation support for maintenance actions
- Job-based restrictions for mechanics
- Multiple notification system support:
- QBox
- QBCore
- ESX
- Wizard Notify
- OkOk Notify
- ox_lib notify
- Configurable warning intervals
- Multi-language support
- Automatic mileage saving
- Persistent maintenance history
- Vehicle ownership verification
- Supports multiple vehicle database structures
- Download the folder and remove the -main suffix from it. The folder name should be wizard-mileage
- Copy the folder and paste it into your resources folder.
- Add the following code to your server.cfg. Make sure to place it at the top of the resources list to ensure it’s loaded before other resources:
<span>ensure</span> wizard-mileage<br>
- Import the import.sql file to your SQL Database
- Open the config.lua file in the wizard-mileage folder.
- Choose your favorite notification system from the list and set it as the default.
- Choose the preffered distance unit (km or mile).
- Choose the preffered location for mileage HUD.
- Change the Config.VehDB to your vehicle database table name.
- 'player_vehicles' for QBCore & QBox
- 'owned_vehicles' for ESX
- you can change it to your custom table name.
- Customize other settings as per your preference.
- Save the config.lua file.