❔FAQ / Troubleshooting

Common issues and solutions

• Q: The script can’t detect ESX or QBCore. A: Confirm es_extended or qb-core is started before this script. If auto-detection fails, set Config.Framework to "esx" or "qb" manually.

• Q: Markers/NPCs not spawning. A: Make sure you have correct ped models (npcModel), valid coordinates, and useNPC = true. Also ensure your job matches the shop’s jobs.

• Q: Vehicle not saving to DB. A: If SaveVehicleToDatabase=true but the DB record doesn’t appear, check for MySQL or oxmysql errors in the console. Also ensure the correct DB table (owned_vehicles or player_vehicles) and columns exist.

• Q: “notAllowed” or “rankTooLow” keeps appearing. A: The script checks HasClientJobAccess and grade. Confirm your job name matches the shop’s jobs array. If using rank-based categories, ensure your job grade is within gradeRange.

• Q: Test drive dimension not working. A: The script calls SetPlayerRoutingBucket(src, dim). Confirm your server build supports dynamic routing buckets and you do not have dimension conflicts with other resources.

• Q: Plate generation issues. A: If you set useCustomPlateText=true, all purchased vehicles get the same plate. Otherwise, it uses prefix + random letters + random digits. Adjust lengths in PlateOptions.

• Q: Error: Unknown column 'type' in 'INSERT INTO' (oxmysql) A: Your database is missing the type column required by the script. Run this SQL query in your database: Then restart your server.

ALTER TABLE `player_vehicles`
    ADD COLUMN `type` VARCHAR(20) NOT NULL DEFAULT 'car' AFTER `mods`;

ALTER TABLE `owned_vehicles`
    ADD COLUMN `type` VARCHAR(20) NOT NULL DEFAULT 'car' AFTER `mods`;

Q: Error: Unknown column 'job' in 'INSERT INTO' (oxmysql) A: Your database is missing the job column required by the script. Run this SQL query in your database: Then restart your server.

ALTER TABLE player_vehicles ADD COLUMN job varchar(64) NULL;

ALTER TABLE owned_vehicles ADD COLUMN job varchar(64) NULL;

Q: Error: Unknown column 'spawnname' in 'INSERT INTO' (oxmysql) A: Your database is missing the spawnnamecolumn required by the script. Run this SQL query in your database: Then restart your server.

ALTER TABLE `owned_vehicles`
  ADD COLUMN spawnname VARCHAR(60) NULL;

ALTER TABLE `player_vehicles`
  ADD COLUMN spawnname VARCHAR(60) NULL;