Studios
Mechanic Menuhouse-3.jpg

Troubleshooting

SoonMechanic MenuQbox
PAGE 05 OF 07  ·  EXAMPLES → TROUBLESHOOTING → COMMANDS & EXPORTSdocs.glitchstudios.dev
Browse docs

"No permission" when saving or loading presets#

The player is missing the command.glitchmechanic ACE. Put them in the Config.Restricted group (group.admin by default) or grant the ACE yourself.

"Not an owned vehicle" on save#

qbx_vehicles could not find the car in player_vehicles by its vehicleid state bag or its plate. The changes stay on the car until it despawns. Extras rows are still fitted.

"You need to be the driver"#

Config.DriverOnly is true. Move to the driver's seat, or set it to false.

The menu closes by itself#

It closes when the car no longer exists, the player dies or walks further than Config.MaxDistance, or the server refuses the session. The notification gives the reason: the car is gone, the player is too far away, could not take control of the car, or is not sitting in it (order mode). Raise Config.MaxDistance if your workshop bays are large.

"This menu cannot be opened here"#

Config.RequireSessionGrant is on and the opening resource did not call AllowSession(source, netId, mode, parts) on the server first, or the grant is older than 30 seconds. Add the call or turn the option off.

A paid workshop job loses its parts after paying#

Config.RequirePaidConfirm is on (the default) and the pay callback does not call exports['glitch-mechanicMenu']:ConfirmSessionPaid(source) after taking the money. Add the call. Until you can, add the callback name to Config.LegacyPayCallbacks.

The workshop charges for a part I did not change#

The bill is what the server sees changed since the menu opened, plus what the client reports. Another script that changes the car's colours, livery or tint while the menu is open shows up as a change. Close the menu, let the other script finish and open it again.

Rim or part photos show as numbered tiles#

Rim photos need Config.PhotoCdn to point at a host with vehiclewheels/<type>/<index>.webp. Part photos need the photos integration. Without either, the menu shows numbered tiles.

Chameleon paints show as plain colours#

The gen9 paint files load when the server starts. If the resource was started later, do a full server restart and have players reconnect. If another resource also streams the paints, keep only one copy.

Presets are not available#

The presets integration (glitch-admin by default) is not running, or Config.Integrations.presets is false.

Known limits#

  • The server cannot read body mods, wheels or neon, so its restore check after an order preview covers colours, livery and window tint. A modified client in order mode could keep the other preview parts on a car it already controls.
  • If the menu reopens on the same car within 2.5 seconds of closing, the new session keeps the earlier original look.

Getting help#

Include the resource version, your qbx_core, qbx_vehicles and ox_lib versions, which integrations are on, reproduction steps and any server or F8 errors (turn on Config.Debug) in a support ticket.