Troubleshooting & FAQ
Common issues
| Symptom | Likely cause | Fix |
|---|---|---|
| Using a paper / form / cone does nothing | The item is missing consume = 0 or its client.export | Fix the ox_inventory definition, see Items |
Creator won't open (/dmvcreator) | You are not an admin | Add your identifier to Config.CreatorIds, or use the ACE / a framework admin group. DevOpenAdmin should stay false |
| School reads $0 next to "activity +$150" | SchoolBank points at a bank with no society account | Use 'internal', or create the school's society account in your bank |
| Staff can't serve candidates | Empty school stash, or the reception terminal isn't placed | Stock supplies from the tablet; place the terminal in the Creator |
| A license category is greyed out at the desk | No recorded route, not accredited, or no suitable owned vehicle | Record the route, earn accreditation, and buy a fleet vehicle |
| License record granted but no card issued | driver_license isn't defined in ox_inventory | Add the driver_license item |
| Exam or reception dialogue broken | vs-npc-dialogue out of date | Update it in lockstep with the script |
| License A cone circuit judges nothing / everything | Track boundary shape | The boundary is an outer limit; use gate cones (Q/E) to punish cutting a slalom, see How It Works |
FAQ
Which frameworks are supported?
ESX, QBCore, and Qbox, auto-detected. Qbox is read through qbx_core natively, so it works with or without the qb-core bridge.
Does it need a map? No. Schools are placed in-game with the Creator. It pairs with the Driving School MLO, sold together as a bundle.
NPC school or player-run business? Both, and it is a per-school choice. A jobless school runs automatically with NPC staff; a job school is owned and staffed by players.
What license types are there? Motorcycle (A), car (B), and heavy vehicle (C, with a reverse-bay), each with per-category expiry.
Can other scripts read a player's license?
Yes, through server exports like IsLicensedToDrive. Police can revoke one. See Developers.
Where is everything configured?
config.lua is bootstrap only (framework, target, admin gate, item names, bank). Prices, exam parameters, hours, and the course flow are edited in-game in the Creator and stored in dmv_settings.
Can I ship my routes with a map?
Yes. Record them, run /dmvexportroutes, and bundle the generated seed_routes.sql.
How to report a bug
Open a ticket on Discord with your framework, your config.lua, the F8 client console and server console output around the error, and the exact steps to reproduce.