Wizard Mileage version 1.2.0 released!
Page cover

Informations

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

Main Features

  • Multi frameworks support (QBCore, Qbox, ESX, ND)

  • 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 & Qbox, ESX, ND, 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

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

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

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

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

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

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

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

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 CUSTOMIZE MENU
Mileage customizer UI
CHECK WEAR MENU
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

Last updated