Mechanic | Tuning and Engine Swaps
Diagnose worn parts, repair vehicles and fit performance upgrades, engine swaps, stance and nitrous, with workshop rules you can configure.












Overview
Give mechanics parts to diagnose, service and replace as vehicles cover miles and take damage. Drivers can face overheating, stalls and weaker brakes when they leave worn components untreated.
What to expect
- Part wear from mileage and collisions
- Diagnostics with configurable access to detailed readings
- Repair kits and configurable workshop requirements
- Performance upgrades, drivetrain conversions and six engine swap presets
- Engine audio previews using GTA vehicle sounds
- Ride height, camber and track width adjustment
- Nitrous kits with boost, purge and refillable bottles
- Cosmetic upgrades, paint finishes and colour selection
- Saved maintenance, mileage and supported modifications
- Combustion and electric part restrictions with vehicle-specific exclusions
- Optional time-based wear for configured service and wear parts
- A configurable workshop bench for bases through ML Base Building
- Shared UI theme presets and configurable colours
Choose detailed part items or one kit per category. You control job permissions, required tools and which actions need a workshop. Fluids, filters and wear parts need regular service; overdue service can damage linked components. Time-based wear is optional and disabled by default.
Enable the optional ML Skills integration for skill requirements, unlocks and experience rewards using an existing category. With ML Base Building, the configurable workshop bench uses its construction, materials, upkeep and access systems.
Engine swaps use GTA audio by default; custom sound packs require a separate installation. The optional donation credit system supports engine swaps and wheel geometry through staff grants or the separate ml_tebex integration. It starts enabled alongside normal item use, and you can disable it.
Supports ESX, QBCore, Qbox and Standalone through ml_bridge. Requires ml_bridge, ox_lib and oxmysql. ML Skills, ML Base Building and ml_tebex are separate optional integrations; check inventory and integration setup in the dependencies guide.
Key Features
Part Wear
Mileage and collisions reduce part condition according to your vehicle class settings. Worn components can cause overheating, stalls and reduced braking.
Roadside or Workshop
Set workshop requirements per action. Basic and advanced repair kits, patch kits and tyre kits cover roadside work, subject to your access and item settings.

Diagnostic Panel
Inspect part condition, engine temperature, fuel, body and engine health, and mileage. Access settings control who gets detailed percentage readings, with mechanic access enabled by default.

Performance Tiers
Install supported engine, brake, transmission, suspension and turbo upgrades with items. Removing configured parts with the required tool can return materials.

Engine Swaps
Choose from six engine swap presets, from a four-cylinder to a V12. Preview their GTA engine sounds before installing a swap, then apply its power, speed and transmission settings. Custom audio packs require a separate installation.

Stancer
Adjust ride height, camber and track width within configured limits. Save the supported stance and synchronize wheel settings with nearby players.

Nitrous
Install a kit, refill bottles, and fire off boost or purge with screen shake, taillight trails, steam and exhaust backfire.
Cosmetics and Paint
Fit body and cosmetic upgrades, choose paint finishes and edit colour sets for supported paint slots.

Staff Panel
Manage tuning, maintenance, repairs, resprays, nitrous and mileage through permission-controlled admin modes. Configure Discord action logs and use predefined vehicle conditions to test wear and diagnostics.

Optional Donation Credits
Grant uses for engine swaps and wheel geometry through staff commands or configured packages with the separate ml_tebex integration. Set per-player credit caps and choose whether normal items remain available. Donation credits and item use start enabled.

Part Warning Sounds
Play warning sounds when configured engine, brake or electrical parts reach or fall below their condition thresholds.
Mechanic Skill Progression
Install ML Skills and enable the integration to award experience for configured work and require skill levels or unlocks for selected parts and actions. The integration is disabled by default and uses an existing skill category.
One Kit Per Category
Choose simple mode to use one item per upgrade category. Set the kit names to match your inventory, or keep advanced mode for tier-specific items.
Script Integrations
Use exports to read vehicle snapshots, parts, mileage and nitrous, or to apply configured wear and damage. Open hooks let other resources respond to completed work such as resprays.
Workshop Bench for Bases
With ML Base Building, add a workshop bench to player bases using its building, material, upkeep and access systems. The bench model, cost, maintenance and interaction range are configurable.
Consumables & Optional Time Wear
Service fluids, filters and wear parts as vehicles cover distance. Overdue service can damage linked components. Optional time-based wear applies to parts with a configured lifespan in days and is disabled by default.
Drivetrain, Drift & Tyre Kits
Use configured kits for AWD, RWD or FWD conversions, drift handling, tyre setups, upgraded brake discs and transmission behaviour. Each setup applies its configured handling changes.

Electric & Vehicle-Specific Parts
Use separate combustion and electric part restrictions, including an EV battery. Configure part exclusions by model or vehicle class and adjust lifespans by class.
Saved Vehicle State
Keep vehicle maintenance and mileage in the database using configurable persistence rules, and save supported modifications and wheel settings. Integrations can read vehicle snapshots and last service records.
Configurable UI Themes
Choose a shared interface preset and customize its primary, accent, background, surface and text colours through configuration. Local settings can override the shared global theme.





