A complete vehicle customization system designed for FiveM roleplay servers. It gives server owners a powerful, zone-based tuning platform with a modern in-game UI where players can fully customize their vehicles, from performance upgrades to paint jobs, wheels, neon lights, stance adjustments, and more. Mechanics can manage tuning orders, earn commissions, and operate professional workshops. Server admins can create and configure unlimited tuning zones entirely in-game, with no restarts needed.
🔧 Vehicle Customization
Full modification system covering every aspect of vehicle tuning:
Performance upgrades: Engine, Brakes, Transmission, Suspension, Armor, and Turbo toggle
30+ cosmetic part categories: Spoiler, Front Bumper, Rear Bumper, Side Skirts, Exhaust, Roll Cage, Grille, Hood, Fenders, Roof, Seats, Steering Wheel, and many more
Paint system with Classic, Matte, Metal, and Chrome color palettes, plus full custom RGB support for primary and secondary colors
13 wheel types: Sport, Muscle, Lowrider, SUV, Offroad, Tuner, Bike, High End, Benny's Original, Benny's Bespoke, Open Wheel, Street, and Track
Neon lights with position and color customization
Xenon headlights with color selection
Window tint with multiple levels
Tyre smoke with custom colors
License plate style and text editing (configurable)
Horn selection from all available horn types
Extras toggle and livery application
Bulletproof tires toggle
Wheel color, pearlescent, interior color, and dashboard color
🏗️ Stance System
Full vehicle stance adjustment system (configurable via Config.AllowStance):
Ride height adjustment
Front and rear camber control
Individual wheel offset for all four wheels
Stance data saved per vehicle plate in the database
Stance persists across sessions and server restarts
🏪 Zone System
Create and manage unlimited tuning zones across the map, all configurable in-game:
Custom zone name, position, and radius
Configurable map blip: sprite, color, scale, and enable/disable
Job restrictions to lock zones to specific jobs
Vehicle blacklist and whitelist per zone
Player identifier whitelist for private zones
Free jobs, allow certain jobs to tune for free
Individual pricing per zone for every mod category
Enable or disable zones without deleting them
Zones are stored in the database and sync automatically to all clients
🔩 Mechanic & Society System
Built-in mechanic workflow with society fund integration:
Society pay: tuning income goes directly to the job's society funds
Mechanic commission: configurable percentage of each transaction goes to the mechanic as personal income
Vehicle repair command restricted to jobs associated with tuning zones
Vehicle stats command for quick diagnostic information
Compatible with qb-banking, Renewed-Banking, fd-banking, RxBanking, tgg-banking, wasabi-banking, and esx_addonaccount
📋 Pending Orders System
Full order queue system for mechanic workshops:
Players submit tuning orders specifying the mods they want
Orders are queued per zone and visible to mechanics with the right job
Mechanics can review, apply, or cancel pending orders
Each order tracks: player name, vehicle model, vehicle label, plate, mods requested, total cost, and creation date
Order status management: pending, completed, or cancelled
Discord webhook logging for order lifecycle events
🎯 Item Requirements
Flexible item requirement system for immersive roleplay:
Require specific inventory items per mod category (e.g., spray_can for colors, wheel_kit for wheels, neon_kit for neon)
Require items per individual performance or cosmetic mod entry
Players need both the item and the money to apply modifications
Items are consumed on successful application
Fully optional, set any category to nil for money-only tuning
💰 Payment System
Intelligent payment handling with multi-source support:
Seven banking system integrations plus custom bridge support
Society fund deposits with configurable mechanic commission split
Free tuning support for whitelisted jobs
⚙️ Admin Panel
Complete in-game zone management without server restarts:
Create, edit, duplicate, and delete tuning zones
Raycast positioning: pick zone and pending target coordinates by pointing at the ground
Configure all zone settings live: name, radius, blip, jobs, prices, blacklist, whitelist, identifiers, society pay, commission, and pending target
Manage pending order pickup points with job restrictions
Permission system based on player identifiers (steam, license, fivem and citizenid)
📡 Discord Webhooks
Automatic Discord logging for server administration:
Tuning logs: every vehicle modification and repair transaction with player details, cost, and zone
Pending logs: order creation, application, and cancellation events
Admin logs: zone creation, updates, deletion, and duplication actions
Each log is timestamped and formatted with Discord embeds
🌐 Bridge System
Fully abstracted framework detection with automatic setup:
Framework support: ESX, QBCore, and QBox
Target system: ox_target and qb-target auto-detected, with custom bridge fallback
Inventory system: ox_inventory and qb-inventory auto-detected, with custom bridge fallback
Banking system: seven systems auto-detected, with custom bridge fallback
Console prints on startup showing exactly what was detected (framework, vehicles table, banking, inventory, target)
Custom bridge files for banking, inventory, and target, server owners can integrate any unsupported system by editing the custom.lua files
