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.

Last updated 1 day ago

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.

Last updated 1 day ago