Studios
Mechanic Jobhouse-3.jpg

Configuration

SoonMechanic JobQbox
PAGE 03 OF 07  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

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#

  1. Copy locales/en.lua to locales/<code>.lua and change 'en' in its AddLocale line to the same code.
  2. Translate the right-hand side of each line. Keep each %s and %d in the same order, or use {1}, {2} to reorder them.
  3. Set locale = '<code>' in config/main.lua and 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/.