| Error / symptom | Cause | Fix |
|---|---|---|
Could not find dependency ox_lib for resource rd_vehicleshop (or ox_target / oxmysql) | Dependency missing or started later | Install it and keep the ensure order from step 4 |
No such export ... in resource oxmysql | oxmysql "Source code" downloaded, or it starts too late | Download the release oxmysql.zip, and start it first (oxmysql docs) |
| oxmysql cannot connect to the database | Wrong connection string, or reserved characters (@ / : #) in the password | Check mysql_connection_string; try the user=...;password=...;host=...;port=...;database=... format (oxmysql docs) |
| UI does not open / ox_lib errors right after start | ox_lib "Source code" downloaded instead of the release | Download the release ox_lib.zip (releases bundle extra files the source does not) |
[rd_vehicleshop] Insert into owned_vehicles failed (...) | Your garage table needs a column with no default value | Add the column with a value to Config.ExtraColumnsSingle / Config.ExtraColumnsCart (it is created automatically) |
"You don't have permission" on /vehicleshopadmin | Group not in Config.AdminGroups and no ACE | Add the group, or the add_ace / add_principal lines from step 6 |
Shop "pdm": no desk for the tablet was found in front of the vendor | No table in front of the vendor | Place Tablet on the desk in the admin panel. Until then the shop opens via the vendor / zone |
WARNING: Config.Locale = "xx", but no locales/xx.lua was loaded | Wrong locale file name | The file name and Locales['xx'] must match. Falls back to English |
The 3D tablet could not start (...) - using the flat view. | DUI not available on the client | Update the server artifacts. The shop keeps working in the flat (2D) view |
Invalid ped model "..." - the ped will not be created. | Typo in the vendor ped model | Fix the model in the shop form |
| Plate shows Taken | That plate already exists in the vehicles table | Choose another text |
| Car is not in the QB garage | QB garages read player_vehicles | See the Framework note |
| Vehicle images missing | No file nui/img/vehicles/<model>.png | See Vehicle images |
| Preview floor missing / car falls in the preview | Preview spot far from the player and not streamed yet | Normally handled (Config.PreviewFocusDistance). Place the preview spot inside or near the shop |
Turn on Debug in Admin → Settings to print detailed loading information to the server console ([rd_vehicleshop DEBUG] ...).
Still stuck? Ask in our Discord.