Mechanic

A full mechanic shop — real-performance tuning, servicing with parts that actually wear out, breakdowns, a customer customs kiosk with a live 3D preview, nitrous, stance, a dyno, work orders, invoices, crafting and shop management.

Requirements

Resource	Required	Notes
ox_lib	Yes	Callbacks, menus, vehicle properties
oxmysql	Yes	Ten tables — shops, vehicles, servicing, orders, invoices
A framework	Yes	QBCore, Qbox or ESX
An inventory	Yes	For parts, kits and crafting materials

Framework and inventory are auto-detected. Only ox_lib and oxmysql are hard dependencies.

Install

1. Drop jj-mechanic into your resources folder.
2. Import install/mechanic.sql.
3. Add the items from install/items.lua (ox_inventory) or install/qb-items.lua (qb-inventory), and copy install/images/ into your inventory's image folder.
4. Add to server.cfg, after your framework, inventory, ox_lib and oxmysql:

ensure jj-mechanic

5. Restart, then run /mechanicadmin in-game to place your first shop.

Database

Ten tables are created by the SQL import:

Table	Holds
jj_mechanic_shops	Shop definitions, placed in-game
jj_mechanic_employees	Staff, grades and duty state
jj_mechanic_vehicledata	Per-plate tuning and cosmetics
jj_mechanic_mileage	Odometer per plate — drives part wear
jj_mechanic_servicing	Current condition of the 10 wear parts
jj_mechanic_servicing_history	Past services
jj_mechanic_orders	Work orders from the customs kiosk
jj_mechanic_invoices	Itemised bills
jj_mechanic_invoice_templates	Saved invoice presets
jj_mechanic_prefs	Per-player interface preferences

Placing a shop

Shops are created in-game, not in a config file. Run /mechanicadmin to place the shop zone, the customs kiosk, crafting benches and lockers, and to set mechanic commission — all without a restart.

Each shop binds to its own job, so several independent garages can run side by side.

First run

1. /mechanicadmin — place a shop and a customs kiosk.
2. Hire yourself into the shop's job and go on duty.
3. Give yourself a mechanic_tablet item — that is what opens the tuning tablet. There is no command for it.
4. Drive a car into the shop and use the tablet.
5. Run the dyno, service a worn part, or fit a turbo and feel the difference.
6. Sit in a car at the kiosk and press E as a customer to build a cart.

Next: Configuration.