Informations

Wizard Mileage System Script, comprehensive vehicle maintenance and mileage tracking system for FiveM servers

Main Features

• Customizable mileage display position on screen

• Option to track only player-owned vehicles

• Command to reset vehicle mileage

• Support for multiple vehicle database tables (QBCore, ESX, custom)

• Real-time mileage tracking for owned vehicles

• Version checker for the script

• Logging system for events and functions

Vehicle Mileage Database UI

• Interactive vehicle mileage database panel accessible in-game

• Displays a list of vehicles with plate numbers and current mileage

• Allows editing of vehicle data including:

  • Mileage

  • Last oil change

  • Last oil filter change

  • Last air filter change

  • Last tire change

  • Last brakes change and brake wear

  • Last clutch change and clutch wear

  • Last suspension change

  • Last spark plug change

• Validation to ensure data consistency (e.g., last change values not exceeding mileage)

• Supports deleting vehicles with user confirmation

• Real-time updates and notifications for successful or failed operations

• Custom confirmation modal for user actions

Mileage UI Customizer

• Allows players to toggle visibility of mileage and wear displays

• Provides sliders to adjust size of mileage meter and wear bars

• Allows precise positioning of UI elements via X and Y coordinates inputs

• Supports dragging UI elements to reposition them interactively

• Saves player customization settings persistently

• Enhances user experience with customizable and flexible UI layout

Spark Plug System

• Spark plug wear tracking based on distance

• Maintenance interval configuration

• Engine misfire simulation when spark plugs are worn

• Spark plug replacement service with progress bar and animation

• Warning notifications for spark plug maintenance

• Cancelable maintenance procedures

Config.SparkPlugChangeDistance = 50   -- Distance in km/miles before spark plug change is needed
Config.MaxSparkPlugWear = 0.02        -- Maximum spark plug wear value

Oil System

• 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 with progress bar and animation

• Cancelable maintenance procedures

Config.OilChangeDistance = 50         -- Distance in km/miles before oil change is needed
Config.EngineDamageRate = 0.5         -- How quickly engine takes damage from poor maintenance (0.0 to 1.0)

Oil Filter System

• 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

• Service option for filter replacement with progress bar and animation

• Cancelable maintenance procedures

Config.OilFilterDistance = 40         -- Distance in km/miles before oil filter change is needed
Config.EngineDamageRate = 0.5         -- How quickly engine takes damage from poor maintenance (0.0 to 1.0)

Air Filter System

• 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

• Air filter replacement service with progress bar and animation

• Cancelable maintenance procedures

Config.AirFilterDistance = 100        -- Distance in km/miles before air filter change is needed
Config.MaxSpeedReduction = 0.2        -- Maximum speed reduction when air filter is worn (20%)
Config.AccelerationReduction = 0.3    -- Maximum acceleration reduction when air filter is worn (30%)

Tire System

• Tire wear tracking based on distance

• Impact on vehicle handling and grip

• Configurable tire wear rates and grip values

• Tire replacement service with progress bar and animation

• Visual wear indicators and warnings

• Cancelable maintenance procedures

Config.TireWearDistance = 250         -- Distance in km/miles before tires need replacement
Config.BaseTireGrip = 2.5             -- Maximum tire grip when new
Config.MinTireGrip = 0.5              -- Minimum tire grip when completely worn

Brake System

• Progressive brake wear simulation

• Impact on braking efficiency

• Brake maintenance service with progress bar and animation

• Warning system for brake condition

• Configurable wear rates and efficiency loss

• Cancelable maintenance procedures

Config.BrakeWearRate = 0.08           -- How quickly brakes wear out
Config.MaxBrakeWear = 100.0           -- Maximum brake wear value
Config.BrakeEfficiencyLoss = 1.0      -- How much braking power is lost when worn
Config.BaseBrakeForce = 1.0           -- Base brake force multiplier

Suspension System

• Suspension wear tracking and replacement service

• Configurable wear rates and maximum wear values

• Progress bar and animation for suspension service

• Cancelable maintenance procedures

Config.SuspensionChangeDistance = 300 -- Distance in km/miles before suspension needs replacement
Config.MaxSuspensionWear = 1.0        -- Maximum suspension wear value

Clutch System

• Clutch wear tracking based on gear changes

• Impact on vehicle performance

• Engine stalls chance when clutch is worn out

• Clutch replacement service with progress bar and animation

• Warning system for clutch condition

• Configurable wear rates and performance loss

• Cancelable maintenance procedures

Config.ClutchWearRate = 0.1           -- How quickly clutch wears out during gear shifts
Config.MaxClutchWear = 100.0          -- Maximum clutch wear value
Config.ClutchEfficiencyLoss = 0.8     -- How much power is lost when clutch is worn (80%)
Config.BaseClutchForce = 1.0          -- Base clutch force multiplier
Config.StallChance = 0.4              -- Chance of engine stalling when clutch is worn (40%)

Mechanic Interactions

1. Approach a vehicle

2. Use the target system (ox_target or qb-target)

3. Available maintenance options:

   • Replace Spark Plugs

   • Change Oil

   • Replace Oil Filter

   • Replace Air Filter

   • Change Tires

   • Service Brakes

   • Service Suspension

4. Each interaction requires appropriate inventory items

5. Progress bars and animations for maintenance actions

6. Cancelable maintenance procedures

HUD Features

• 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

• Customizable UI size/position for players, saves in DB

Mileage customizer UI

Checkwear UI

Disabled Vehicle Classes

• Option to disable mileage tracking and maintenance for specific vehicle classes such as:

  • Cycles

  • Boats

  • Helicopters

  • Planes

  • Trains

  • Military vehicles

  • Commercial vehicles

Inventory System

• Integrated inventory support for:

  • Spark Plugs

  • Engine Oil

  • Oil Filter

  • Air Filter

  • Tires

  • Brake Parts

  • Suspension Parts

  • Clutch Parts

• Supports multiple inventory systems:

  • ox_inventory

  • qb-inventory

  • Quasar inventory

  • CodeM inventory

  • ESX inventory

• Configurable item weights and descriptions

• Items can be used directly from inventory

• Automatic item removal after use

Notification System

• Multiple notification system support:

  • QBox

  • QBCore

  • ESX

  • Wizard Notify

  • OkOk Notify

  • ox_lib notify

• Configurable warning intervals

• Multi-language support

Multiple Menu Support

• Supports multiple menu systems:

  • ox_lib

  • QBCore/QBox menu