The files in config/ are open under escrow, along with locales/, bridge/, shared/lessons.lua, shared/schema.lua and install/. Most values can also be changed live in /mechanicadmin. Those edits are saved in the resource KVP and win over the files, and the reset arrow next to a field goes back to the file value.
Configuration files#
| File | What it holds |
|---|---|
config/main.lua |
Mechanic.Config (money, supplier, work timings, unlocks, XP, repairs, NPC mechanic, shop jobs, certificates, duty, paint, vehicle categories, power and speed caps, ECU tuner ranges, dyno, legal rules, resale, underglow, UI) and Mechanic.Integrations at the end |
config/shops.lua |
Shop fields, specialities, business permissions, the zone list and work vans (Mechanic.WorkVehicles). Mechanic.Shops is empty in the package. |
config/parts.lua |
Every part, supply and tool with its price, stage, level, install steps and handling values |
config/tuner.lua |
Tuner mods: nitrous bottles and flame colours, tank caps and the tuner* settings |
config/presets.lua |
DRIFT+HD handling presets |
config/paint.lua, config/sounds.lua, config/effects.lua, config/backfires.lua |
Paint colours and finishes, engine sounds, exhaust effects and backfire sounds |
config/banners.lua |
Shop artwork. Off in the package, because each entry names the textures of a specific map. |
shared/lessons.lua |
Training tab course text and quiz questions |
locales/en.lua |
Player text, the reference list for translations |
Server-local settings#
Lua files in config/local/ load after the other config files and are not part of the package, so an update never overwrites them. Use it for work vans, banner maps, extra engine sound banks or anything else that belongs to one server.
Mechanic.Config defaults#
| Setting | Default | What it does |
|---|---|---|
commission |
0.15 |
Share of a finished order paid to the mechanic who did the most lines |
staffDiscount |
0.5 |
Share of the price staff pay on their own car |
removalPrice |
500 |
Price to take an installed part off |
priceFloor / priceCeiling |
0.5 / 1.25 |
Range owners can set service prices in, as multiples of the base price |
supplierMarkupLow / supplierMarkupHigh |
0.85 / 0.85 |
Supplier price as a share of the part price, for stages 1-2 and 3-4 |
supplierMarkupSupplies |
0.7 |
Supplier price share for repair parts, panels and paint supplies |
supplierLimit |
500 |
Most of one item a single supplier order can take |
supplierQuality |
60 |
Quality of bought parts. Crafted parts roll higher. |
useDistance |
4.5 |
Metres a mechanic can be from the car or zone |
workStepTime |
4000 |
Milliseconds per install step |
workExpiry |
300 |
Seconds before an unfinished install session is dropped |
toolWear |
0.25 |
Durability the toolbox loses per job (0 = never) |
removeTime / repairTime |
12000 / 12000 |
Milliseconds to take a part off and per repair job |
engineStand |
Table | Stand and engine props, offsets, rotations and pull and refit times (10 seconds each) |
unlocks |
Table | Mechanic level needed per stage and kind of work: tier2 = 3, tier3 = 8, tier4 = 14, ecu = 5, drivetrain = 11, illegal = 13, plus paint finishes, lights and wraps |
workXP / hourlyXP |
12 / 500 |
XP per install or repair (times the part tier) and the hourly cap |
repair |
{ engine = 200, body = 130, glass = 70, tyres = 70, clean = 30 } |
Base repair prices |
repairTotalMax |
500 |
The five repair prices together can never go over this |
npcEnabled |
true |
NPC mechanic at the desk when nobody from the shop is on duty |
npcPrices |
{ engine = 300, body = 200, glass = 100, tyres = 100, clean = 50 } |
NPC repair prices ($750 for everything) |
npcRepairCap / npcTime |
1.0 / 45000 |
How far the NPC repairs engine and body, and how long it takes |
repairDrops |
{} |
Salvage from finished repairs, { item, chance, min, max }. Every item must exist in ox_inventory. |
shopJobs |
Table | NPC jobs: enabled = true, profitMin = 100, profitMax = 200, commission = 0.25, perShop = 3, refresh = 900, maxPerHour = 4, timeLimit = 1800, car models and customer names |
trainingXP |
150 |
XP for finishing the training car the first time |
certificatePrice / certificateDays |
800 / 30 |
Roadworthy certificate price and length |
dutyRange |
150.0 |
On duty and this far outside the shop area clocks you out (0 = off) |
paintDryTime |
30000 |
Milliseconds paint takes to dry |
classes / modelOverrides |
Table / {} |
GTA class to vehicle category, and single-model overrides |
caps / speedCaps |
Table | Power cap and top speed cap (km/h) per vehicle category |
tune |
Table | ECU tuner sliders (boost, final drive, shift, brake bias, drive bias, ride height, camber, launch control) and the hardware each needs |
dynoSweep / dynoCooldown |
9000 / 60 |
Milliseconds of throttle for one run, seconds before the same plate can run again |
legal |
Table | stanceLimit = -0.05, fine = 250 per illegal mod, deadlineHours = 48, repeatDays = 30, illegal tint indexes |
resale |
Table | How parts, certificates, dyno runs and damage count towards resale value |
underglowTick / underglowMaxAnimated |
33 / 8 |
Animated underglow update rate and how many cars each player animates |
carRadial |
true |
Work on vehicle, Customise and Dyno run in the radial menu while you sit in a car at a shop |
menuTheme |
'wardrobe' |
glitch-uiElements panel theme |
locale |
'en' |
Player text language, a file in locales/ |
imagePath |
'nui://ox_inventory/web/images/' |
Item images for menus. Use the same folder as your inventory, ending in /. |
Mechanic.Integrations defaults#
| Setting | Default | What it does |
|---|---|---|
banking |
'auto' |
Shop accounts. 'auto' uses the first of omes_banking and Renewed-Banking that is running. Set a table of server functions for any other bank (see Examples). |
levelWithoutXP |
20 |
Level every mechanic counts as without glitch-xpSystem (20 unlocks everything) |
minigames |
'auto' |
glitch-minigames when it runs, ox_lib skill checks otherwise. 'ox_lib' always uses ox_lib. |
menus |
'auto' |
glitch-uiElements when it runs, ox_lib menus otherwise. 'ox_lib' always uses ox_lib. |
includes |
false |
Loads the glitch-pauseMenu and glitch-poolcleaning helpers. setr mechanic_includes in server.cfg wins over this. |
vanGradeWithoutTablet |
0 |
Lowest job grade that can take out a work van without glitch-businesstablet |
bannerHosts |
{ 'i.imgur.com', 'cdn.discordapp.com', 'media.discordapp.net' } |
Hosts allowed for shop artwork links without glitch-businesstablet |
workshopParking |
'auto' |
On while qbx_vehicles runs. false turns it off. |
phoneFines |
'auto' |
Fix-it fines as sd-phone bills when sd-phone has the glitchFine export. false always uses the service desk. |
gstRate |
'gov' |
GST in order prices, in percent. 'gov' follows glitch-gov. Only booked while glitch-treasury runs. |
gstWithoutGov |
10 |
GST percent while glitch-gov is not running |
shopJobPay |
'gov' |
Shop job pay in percent of the listed price. 'gov' follows glitch-gov, 100 without it. |
Tuner settings#
These are in config/tuner.lua as Mechanic.Config fields.
| Setting | Default | What it does |
|---|---|---|
tunerNitroPower |
1.5 |
Engine power multiplier while nitrous is held |
tunerNitroDrain |
40 |
Percent of a tank used per second of boost |
tunerNitroMinSpeed / tunerNitroMinRpm |
15 / 0.40 |
Speed (km/h) and rpm (0-1) before nitrous fires |
tunerNitroCooldown |
3 |
Seconds after letting go before it fires again |
tunerNitroPurge |
true |
A short purge when the boost is let go |
tunerNitroTurbo |
false |
Nitrous only fires with a turbo fitted |
tunerMaxTanks |
2 |
Tanks per car. Mechanic.Tuner.TankCaps sets other numbers per model. |
tunerBlockedCategories |
{ cycle = true } |
Vehicle categories that cannot take Tuner mods |
tunerBlockedModels / tunerBlockedJobs |
'' |
Comma-separated models that cannot take mods, and jobs that cannot fire nitrous |
tunerOwnedOnly |
true |
Installs only on registered vehicles |
tunerExhaustCooldown / tunerExhaustRpm |
250 / 0.55 |
Milliseconds between exhaust flames, and the rpm needed for lift-off pops |
tunerPopcornMin / tunerPopcornMax |
3 / 7 |
Bangs in one anti-lag burst |
tunerSportPower |
1.12 |
Sport mode power multiplier |
tunerDriftModes |
false |
The Drift Kit's DRIFT+ and DRIFT+HD modes and drift smoke. Off in the package. |
Keys#
Players can rebind all of these in the GTA settings.
| Key | Action |
|---|---|
| Y | Work on the car (staff, in the car at the shop) |
| U | Customise the car or make a work order (at a shop) |
| O | Dyno run (driver, on the rollers) |
| F7 | Tuner tablet (in a car with Tuner mods) |
| Left Shift (hold) | Nitrous |
| G (hold) | Purge |
| Left Ctrl (hold) | DRIFT+ |
Language#
- Copy
locales/en.luatolocales/<code>.luaand change'en'in itsAddLocaleline to the same code. - Translate the right-hand side of each line. Keep each
%sand%din the same order, or use{1},{2}to reorder them. - Set
locale = '<code>'inconfig/main.luaand restart the resource.
A line you leave out stays in English. Item labels belong to ox_inventory, and the tuner laptop, tablet and dyno pages are the files in web/.