Mechanic Creator Common Errors & Fixes | FiveM Mechanic Script Troubleshooting

Mechanic Creator Common Errors & Fixes | FiveM Mechanic Script Troubleshooting | Quasar Store

"You don't have access to any mechanic shop"

This is the single most common message, and it is working as intended. The tablet belongs to somebody attached to a shop: its owner, somebody hired into it with open_tablet, or anybody in the job or gang a job-staffed shop was set to. A player who is none of those gets nothing, wherever they stand.

So check, in order: does a shop exist and is it claimed; is this player the owner or on its roster; and if it is job-staffed, does their job name match exactly. Distance is not a factor — the tablet works from anywhere.

A job-staffed shop lets nobody in

The job name is compared exactly as typed, against the name your framework uses internally — mechanic, not Mechanic and not the label players see. Take it from your own jobs file rather than retyping it. For a gang shop the same applies to the gang name, and the player's gang is what is matched, not their job.

An employee cannot see or do something their boss can

Permissions are per shop and per employee, and the owner implicitly holds all of them, so a misconfigured grade can never lock an owner out of their own shop. Open the tablet's employee list and tick what the role is actually meant to do; an employee can never grant a permission they do not hold themselves.

At a job-staffed shop the rules are fixed instead: everybody in the job gets the day-to-day permissions, only the manager grade and above may withdraw money or change the shop's settings, and managing employees is never available, because a job shop has no roster to manage — the job is the roster.

A shop was bought and its job no longer works

Deliberate. A shop is staffed one way or the other, never both, and an owner outranks a job — otherwise selling a shop would quietly leave a whole department holding the keys. If you want the job back, clear the owner in the creator.

"Shop data not loaded yet" or "Loading player data"

The client asked before the server had answered, and asking again a second later normally works. If it never stops saying it, the shops are not reaching the client at all: look for a database error in the server console, and make sure oxmysql is ensured above this resource.

Using the tablet, kit, sponge or rope does nothing

The inventory never reached this resource. Check the item definition you added: the export name has to match, and the resource it points at has to be spelled qs-mechanic-creator exactly. An inventory calling an export that does not exist usually fails in silence rather than printing anything, which is why this looks like nothing happening.

The definitions for every supported inventory are on the Inventory Items page.

"You need an item" when the player is holding it

The name in the panel and the name in your inventory are different strings. The item names a radial action asks for live in Settings → Items, and they default to repairkit, sponge and rope. If your items are called something else, say so there rather than renaming your items.

Refuelling asks for an item that does not exist

The jerrycan is the one item whose name genuinely differs between inventories, so its default is chosen from the inventory that was detected: WEAPON_PETROLCAN on ox_inventory, weapon_petrolcan elsewhere. If your server uses a plain item instead of the weapon, put its name in Settings → Items.

A repair kit is never used up, or is used up twice

On qs-inventory an item defined with removeAfterUse = true is taken by the inventory itself. That is accounted for, so the item is only ever removed once — but it does mean the behaviour follows your item definition. If a kit survives every repair, the definition is not removing it and neither side thinks it should; set removeAfterUse or let this resource take it, not both halves of neither.

A new shop's stash or parts shop does not exist yet

Stashes and parts shops belong to the inventory, not to this resource: each one is registered with whichever inventory was detected, and that happens once, shortly after the server starts. A shop created while the server is running therefore has no stash until the resource is restarted. Place the shop, finish setting it up, and restart it once.

If no stash appears even after a restart, no inventory was detected at all, or the one you run does not support registered stashes — codem-inventory is one of those. The console with debug on says which inventory was found.

Key	Means
`no_permission`	The player is not an admin by any of the three routes above.
`not_ready`	The settings have not finished loading from the database. Retry in a moment; if it persists, the database is the place to look.
`generic`	The request did not look like a settings payload at all — normally a stale interface after an update. Reconnect and try again.

Installation and Access#

Common Errors

Common Errors

Installation and Access#

The Tablet and Who May Use It#

Items and the Inventory#

Shops, Lifts and Prompts#

The Dyno and Its Screens#

Money, Invoices and Engines#

Driving Systems#

Error Keys#