Mechanic — Troubleshooting

The problems that actually come up, and what causes them.

Nothing happens anywhere

Shops are placed in-game, not in a config file. A fresh install has none.

Run /mechanicadmin, place a shop zone and a customs kiosk, then reload. If that command does nothing, your account is not resolving as an admin through the framework.

/mechanic does nothing

The tablet is for on-duty staff. Check that the character is hired into that shop's job and actually on duty — each shop binds to its own job, so being a mechanic at one shop does not grant access at another.

Tuning doesn't stick

Tuning is stored per plate in jj_mechanic_vehicledata and re-applied on entry. If it reverts:

• The plate changed — a re-spawned or replaced vehicle with a new plate is a different car as far as the database is concerned.
• Another resource is writing vehicle properties after this one. Garage scripts that re-apply saved mods on spawn are the usual culprit.

Players complain cars keep breaking

That is the breakdown system, and on an established server every existing car already has mileage — so enabling it at defaults can fail a lot of vehicles at once.

Ease the thresholds in config.breakdown.lua, or switch the system off entirely, then reintroduce it gradually.

A car won't restart at all

Working as intended at 0% part health. A repair kit gets it to a limp-home state; only a full service at a shop restores it.

If you would rather that never happens, raise the failure floor in config.breakdown.lua.

Mechanics say there's no work

Wear is driven by mileage, so on a quiet server parts degrade slowly. Shorten the service intervals in config.servicing.lua rather than raising prices — more frequent small jobs beat rare expensive ones.

Kiosk charges a different price than shown

The server re-prices the entire cart before charging and never trusts the client's figures. A mismatch means the catalogue in config.customs.lua was edited while a cart was open — the server price is the correct one.

Self-service repair isn't offered

It only appears when no mechanic is on duty. If someone is clocked on, customers are expected to use them. Check config.repairs.lua has it enabled.

Commission or society cut isn't paying

Both are set per shop from /mechanicadmin, not from a config file. Check the shop's own settings, and that the society account exists in your banking resource.

Crafting says materials are missing

Every material in config.crafting.lua must exist in your inventory. Items added to a recipe without a definition silently fail the check.

Confirm you imported install/items.lua or install/qb-items.lua and copied install/images/.