Magic Vehicle History
Magic Vehicle History is a complete vehicle records and history system designed for modern FiveM roleplay servers. Give players, mechanics, dealerships, police departments and administrators access to comprehensive vehicle records through a clean, responsive interface.
Instead of adding interaction targets to every vehicle, players simply use a configurable Vehicle History Scanner while standing near a vehicle. The scanner securely retrieves the vehicle's stored records and displays a complete history report.
Features
- Vehicle History Scanner item
- Persistent vehicle records
- VIN generation
- Ownership history
- Service history
- Inspection records
- Vehicle grading system
- Finance tracking
- Police and impound records
- Vehicle status flags
- Staff management tools
- Automatic vehicle registration
- SQL persistence
- Discord webhook logging
- Secure server-side validation
Vehicle History Reports
Every vehicle can maintain a complete history throughout its lifetime.
Reports include:
- Unique VIN number
- Vehicle model
- Registration plate
- Current mileage
- Mileage history
- Vehicle condition grade
- Current owner
- Previous owners
- Ownership transfers
- Service history
- Repair history
- Inspection records
- Finance information
- Police records
- Impound history
- Vehicle flags
- Complete activity timeline
Information is organised into dedicated tabs, making reports quick and easy to navigate.
Vehicle History Scanner
Vehicle information is accessed using a usable inventory item.
Scanner features include:
- Configurable scanner item
- Non-consumable support
- Automatic nearest vehicle detection
- Configurable scan distance
- Cancellable scan progress
- Vehicle highlighting during scanning
- Optional scanner sounds
- Clear feedback when no vehicle is nearby
- Optional command fallback
This approach keeps interactions clean without adding unnecessary target options to every vehicle.
Vehicle Grading
Vehicles receive an automatic condition grade based on configurable factors.
Grade calculations can include:
- Vehicle age
- Mileage
- Service history
- Inspection results
- Active vehicle flags
- Accident history
- Write-off status
- Rebuilt status
- Finance status
- Police seizures
- Mileage discrepancies
Administrators can view a complete grading breakdown explaining every adjustment.
Ownership History
Track every ownership change throughout a vehicle's lifetime.
Ownership records include:
- Current owner
- Previous owners
- Dealership sales
- Private sales
- Administrative transfers
- Finance repossessions
- Transfer notes
- Transfer timestamps
- Complete audit history
Owner identities can be hidden on public reports if preferred.
Service Records
Mechanics and supported resources can add detailed maintenance records.
Service entries may include:
- Service type
- Mechanic
- Business
- Mileage
- Labour cost
- Parts cost
- Service notes
- Service date
- Verified system entries
All services automatically appear within the vehicle timeline.
Inspection System
Authorised users can complete professional vehicle inspections.
Inspection records include:
- Inspection type
- Inspection score
- Pass or fail result
- Inspection notes
- Inspector details
- Vehicle mileage
- Inspection history
- Grade impact
Vehicle Flags
Vehicles can be marked with configurable status indicators.
Supported flags include:
- Stolen
- Recovered
- Salvage
- Rebuilt
- Written off
- Finance outstanding
- Finance default
- Police seizure
- Impounded
- Mileage discrepancy
- Inspection overdue
- Custom warnings
Flags can include timestamps, reasons and staff information.
Finance Records
Store finance information directly against each vehicle.
Finance records support:
- Finance status
- Original agreement value
- Remaining balance
- Finance provider
- Agreement reference
- Payment status
- Default history
- Repossession records
Sensitive finance information can remain hidden from public reports.
Public & Staff Reports
Different users can receive different levels of information.
Permission-based visibility supports:
- Vehicle owners
- Mechanics
- Police
- Dealerships
- Administrators
- Public players
Individual sections such as owner details, finance, police notes and service costs can all be configured independently.
Staff Management
Authorised staff receive additional management tools.
Available functions include:
- Add service records
- Add timeline notes
- Manage vehicle flags
- Transfer ownership
- Update finance information
- Complete inspections
- Correct mileage
- View grading calculations
- Import existing vehicles
- Rebuild vehicle grades
Management features remain hidden from regular players.
Automatic Registration
Vehicle history can be created automatically.
Supported registration methods include:
- Existing vehicle import
- Resource startup import
- Scheduled synchronisation
- New vehicle purchases
- First vehicle scan
- Manual synchronisation exports
Integrations
Magic Vehicle History has been designed for easy integration with other resources.
Compatible systems include:
- Vehicle dealerships
- Garage systems
- Mechanic resources
- Finance resources
- Police systems
- Impound systems
- Mileage resources
- Vehicle purchase systems
- Vehicle repossession systems
- Custom server resources
Individual integrations can be enabled or disabled through the configuration.
Interface
The modern interface includes:
- Responsive layout
- Transparent game background
- Overview tab
- History timeline
- Ownership tab
- Searchable records
- Event filters
- Vehicle grade summary
- Finance summary
- Service summary
- Custom dropdown menus
- Styled scrollbars
- Loading states
- Confirmation dialogs
- Built-in notifications
Designed for both standard and ultrawide displays.
Security
Important actions are fully validated by the server.
Security includes:
- Server-side permission validation
- Input validation
- Rate limiting
- Job and grade restrictions
- ACE permission support
- Secure ownership transfers
- Secure mileage updates
- Secure finance updates
- Complete audit logging
- Change history tracking
- Staff action logging
- Timestamped records
Compatibility
Frameworks
- ✅ Qbox
- ✅ QBCore
- ✅ ESX
- ✅ Standalone
Automatic framework detection is supported.
Inventory
- ✅ ox_inventory
- ✅ qb-inventory
- ✅ ESX Inventory
- ✅ Custom inventory bridge support
Requirements
Required
- oxmysql
- ox_lib
Supported Frameworks
- Qbox
- QBCore
- ESX
- Standalone
Perfect For
- Serious roleplay servers
- Police departments
- Vehicle dealerships
- Mechanic businesses
- Impound systems
- Economy servers
- Used vehicle markets
- Vehicle inspection roleplay
- Finance and repossession systems
Support
Need help?
Join our Discord community for support, updates and announcements.