FiveM Mechanic Script — Vehicle Repair & Tuning Setup (ESX & QBCore)

What Is a Mechanic Script?

A mechanic script in FiveM provides vehicle repair, customization, and maintenance gameplay. It is one of the most important civilian job scripts because every player uses vehicles, making mechanics a consistently in-demand profession on roleplay servers.

A quality mechanic script goes far beyond pressing E to repair a car. In 2026, players expect:

• Part-by-part repair systems (engine, body, tires, suspension independently)
• Visual customization and tuning
• Diagnostic tools to inspect vehicle condition
• Job integration with grades, pay, and management
• Player-to-player interactions (customer brings car, mechanic repairs it)

---

How Vehicle Repair Works in FiveM

GTA V Vehicle Health System

Every vehicle in GTA V has several health values accessible via natives:

Property	Native Function	Range	Controls
Engine health	GetVehicleEngineHealth	-4000 to 1000	Engine performance and smoking
Body health	GetVehicleBodyHealth	0 to 1000	Visual deformation
Fuel (custom)	Script-managed	0 to 100	Fuel consumption
Tire status	IsVehicleTyreBurst	Per tire	Individual tire blowouts
Window status	IsVehicleWindowIntact	Per window	Individual window breaks

A mechanic script reads these values, displays them to the mechanic player, and provides tools to restore them.

Repair Mechanics

The standard repair flow:

1. Customer drives to the mechanic shop
2. Mechanic inspects the vehicle (uses a diagnostic command or target interaction)
3. Vehicle health values are displayed in a UI
4. Mechanic selects which parts to repair
5. A progress bar or minigame plays (representing the repair work)
6. Vehicle health values are restored
7. Customer pays the mechanic (manual payment or automated billing)

Part-by-Part vs Full Repair

Basic scripts offer a single "repair all" option. Better scripts provide granular control:

• Engine repair — Restores engine health (fixes smoking, stalling)
• Body repair — Removes dents and visual deformation
• Tire replacement — Fixes burst tires individually
• Window repair — Restores broken windows
• Wash / Clean — Removes dirt using the SetVehicleDirtLevel native

This granularity creates more interesting RP because the mechanic can diagnose specific issues and quote prices accordingly.

---

Vehicle Customization / Tuning

Beyond repair, mechanic scripts provide vehicle modification:

Visual Modifications

GTA V natively supports extensive vehicle customization via mod indices:

Category	Examples
Spoilers	Stock, lip, big, factory
Front bumper	Stock, custom variants
Rear bumper	Stock, custom variants
Exhaust	Standard, dual, performance
Roll cage	None, basic, competition
Hood	Stock, carbon, scoop
Livery	Various paint schemes

The script reads available mod indices using GetNumVehicleMods and presents them in a menu. When the mechanic selects a mod, SetVehicleMod applies it.

Performance Modifications

Performance tuning affects vehicle handling:

• Engine tuning — Levels 0-4, increasing top speed and acceleration
• Brakes — Levels 0-3, improving stopping distance
• Transmission — Levels 0-3, improving gear shifting speed
• Suspension — Levels 0-4, adjusting ride height and handling
• Turbo — Toggle, adds a turbocharger

Paint and Colors

Vehicle paint uses GTA V's color system: primary and secondary colors (standard palette or custom RGB), pearlescent color, wheel color, neon lights (under-glow) with custom colors, tire smoke color, and window tint level.

---

Job Integration

Framework Setup

For QBCore: Job name is typically "mechanic" in qb-core/shared/jobs.lua with grades (Apprentice, Mechanic, Senior Mechanic, Manager, Owner). On-duty mechanics can access shop tools.

For ESX: Job registered in the jobs database table with the same grade structure and a society account for business funds.

Boss Menu

The mechanic shop should have a boss menu allowing the shop owner/manager to hire and fire employees, set grades, manage the society/business bank account, and withdraw funds for shop expenses.

---

Common Setup Issues

Issue	Cause	Fix
Repairs do not persist after restart	Vehicle health not saved to database	Ensure your vehicle persistence script saves health values
Mods do not save	Vehicle mod data not stored	Use a vehicle management script that saves mod data
Only one person can access the shop	Interaction zone too small	Expand the interaction zone in config
Performance mods have no effect	Handling files not loaded	Ensure custom handling files are streamed
Players can repair without being on duty	Missing job check	Verify the script checks player job before allowing repairs

---

Multiple Shops and Specializations

For larger servers, consider multiple mechanic locations with specializations:

Shop	Location	Specialization
Benny's Motorworks	Strawberry	Full customization + performance
LSC San Andreas	Downtown	Standard repair + paint
Harmony Repair	Harmony	Off-road and truck specialists
Airport Mechanics	LSIA	Aircraft maintenance

Each shop can use the same mechanic script but with different configuration (available mods, pricing tiers, accessible vehicle types).

---

Performance Impact

Mechanic scripts are generally lightweight:

• Idle: 0.00ms — No loops when no vehicle is being serviced
• Active repair: 0.01-0.03ms — Progress bar and health modification
• Customization menu open: 0.01-0.02ms — NUI overlay active
• Vehicle preview: 0.02-0.05ms — Applying and reverting mods in real-time

Combined with our Jobs Creator, you can create additional mechanic-style jobs (tire shop, car wash, tow service) without installing separate scripts for each.

→ Browse All Scripts | → Multi-Job QBCore Guide