What goes wrong most often, what it actually means, and what to do about it. Most of these are explained by a line in the server console — read it from the top after a restart, the suite prints clear, colour-coded messages.
Installation and Access#
The tablet is a blank page, or does not open
The resource is not the copy you downloaded. Re-download qs-police-creator from the CFX Portal and replace the folder, keeping only your config/ and custom/ changes. Also check that qs-police-props is started — the tablet prop comes from it.
/cad does nothing
Your job is not a police department yet: add it under Admin → Dispatch → Jobs. If Config.CAD.RequireItem is true, the player also needs the cad item in their inventory.
"Access Required" on /policeadmin
The screen lists your identifiers with ready-made lines. Copy one into server.cfg and restart the whole server:
add_ace identifier.license:xxxxxxxxxxxxxxxx qspoliceadmin allowUsing groups instead? Make sure add_ace comes after add_principal, and that the group is in Admin → Server Setup → Access. See Claiming Admin Access.
The boot summary says vanilla for something I have
That resource starts after Police Creator, so it was not running when detection looked. Move its ensure above ensure qs-police-creator, or set it by hand in config/shared/config.lua (for example Config.Inventory = 'ox_inventory'). See Overriding Detection.
I edited a default file and nothing changed
Correct behaviour. Everything the admin panel manages — jobs and ranks, dispatch, radio, the K9, garages, shops, lockers — is saved in your database on the first start. From then on the panel is the only place to change it.
A red "RESTART REQUIRED" message repeats in the console
Police Creator has just added its two export lines to pma-voice. Restart the server once and the message stops for good.
"qs-police-creator is not running; stopping."
Printed by the light editor. qs-police-creator must start before qs-police-veh-creator — or it failed to start; scroll up for its own error.
The Database#
"Illegal mix of collations"
Your framework's tables use a different text collation than the qs_police_ tables, so they cannot be compared. The console prints a [COLLATION FIX REQUIRED] block with the exact ALTER TABLE lines for your database. Back up first, run them, restart. The full walkthrough is in How to Fix Collation Issues.
Once fixed — or if it does not affect you — Config.DisableCollationWarnings = true hides the warning.
"Chat configuration is missing or invalid"
Normal on the very first start, while the tables are being created. Restart the server once.
A camera I placed is missing from the MDT
First, who can see it: a camera with no job rights is private to the job that placed it. If you picked a job but left every box unticked, that job gets nothing. Then look for a red Failed to save camera line — restart qs-police-creator and it adds the missing column and says so.
ESX: "owned_vehicles has no 'parking'/'garage' column"
Vehicle records cannot tell whether a car is parked. Set Config.OwnedVehiclesTableGarageColumn to the column your garage script uses.
ESX: "no grades found for job …"
That job has no rows in job_grades. Add its grades to your ESX jobs, then restart.
The MDT and Dispatch#
"You're Off Duty" on every page
Dispatch, Radio, Reports and Cameras only open on duty. Press the duty button on the tablet's Main page.
An officer cannot see a module
Their rank does not hold that permission. Open Admin → Dispatch → Jobs, check the department's permissions and the override for that exact grade — a deny in an override wins over the department's baseline.
"Only dispatchers can close calls"
Closing calls and assigning other units is for ranks at or above the department's Min Grade (3 for police by default). Lower it in Admin → Dispatch → Jobs if needed. Unattended calls close themselves after 5 minutes.
Nobody can be charged
The penal code is empty on a fresh install. Write a chapter and an article, or import the ready-made code. Also remember the charge dialog only lists players within 7 m by default.
Handcuffs do nothing
The officer must be on duty, in a police department, with the Handcuff Player permission, and within 2.5 m. Ambulance and fire do not have it by default. Searching also needs the suspect to be cuffed and the Search Player permission.
The radar does not appear
It needs the driver's seat of an emergency-class vehicle, being on duty, and a job listed in Config.RPOL.Jobs (config/shared/rpol.lua). Add sheriff and your other departments there.
The radio does not transmit
Check the boot summary's Voice line. With pma-voice, restart once after the first start (see above). If the F8 console says pma-voice is not started, start it before Police Creator. With yaca the F8 console may print an "Unsupported Config.VoiceSystem" warning; the radio still uses yaca.
An item does nothing (tablet, camera kit, dog food)
The item is not in your inventory's item list yet. Add it from Inventory Items, with its image, and restart the inventory.
Photos and Screenshots#
Mugshots, call photos or bodycam captures do not work
They need screenshot-basic running and an image host in config/server/webhooks.lua: Config.FivemanageToken (recommended) or Config.DiscordWebhook. With both empty the console says image features are disabled.
"Fivemanage rejected the request (HTTP 401)" with a correct token
Fivemanage answers 401 for every failure. Read the message after it: "You have reached the maximum storage limit" means the token is fine and the account is out of storage — delete files or upgrade the plan. A wrong token says "token does not exist".
"Config.FivemanageToken holds a URL, not a token"
A Discord webhook was pasted into the token field. Move it to Config.DiscordWebhook, or paste your Fivemanage token instead.
Society Money#
Paid fines do not reach the department's account
Press Deposit in the Connection card of Admin → Society money, or run qs-society-check police 100 in the server console. There are three outcomes:
"No banking adapter is loaded" —
Config.SocietyBankingnames a script with no file inserver/custom/society/. Fix the spelling, or delete the line to go back to auto-detection."deposit FAILED" — your banking script refused the call. On ESX this usually means the society account does not exist yet: the console prints the two SQL lines that create it — run them and restart the server.
"accepted but the balance did not change" — the money went to an account name your bank does not use. Map it in the Account names card (
police → society_lspd).
Keeping an edited copy of a framework bridge from an older version? Take the new file and re-apply your changes — older copies do not deposit fines.
Alerts, Evidence and Lights#
Shootings are not reported
Usually correct behaviour. Alerts need witnesses — with no NPCs around and no camera in range, nobody calls — and are rarer at night. Players in Config.PoliceJobs never trigger alerts, and silenced or blacklisted weapons never do. Test with Config.Debug = true in a busy street, and check that qs-police-creator starts before qs-police-alerts.
G does not send Officer Down
It only works while the player is dead. If your ambulance script keeps players in a downed state instead, change Config.IsDead in qs-police-alerts/config/config.lua to that script's check.
Officers cannot see any evidence
They must be in Config.AllowedEvidenceJobs, hold WEAPON_FLASHLIGHT and aim with it. Evidence also disappears after 45 minutes and on a restart. Collecting needs an empty_evidence_bag and room for the filled one.
There is never any blood or fingerprints
Correct behaviour. Those two are left by your own scripts through the evidence events — a robbery, a fight, an injury.
/takedna is always refused
It needs an on-duty job of type leo, which QBCore and Qbox police jobs have. ESX jobs have no type, so on ESX collect DNA from blood evidence instead.
The light editor zone does not appear
Only jobs listed in Config.Jobs of qs-police-veh-creator/config.lua see a depot — by default only police. Add your other departments with their zones. You must be seated in the vehicle inside the zone.
Placed lights are invisible
qs-police-props is not started, or starts after the light editor. It streams every light-bar model.
G does not turn the siren on
Turn a light group on first (Numpad 1–9); the siren only sounds with lights running. If the tone changes when you look behind you, rebind Change Siren Tone in Settings → Key Bindings → FiveM.
Console Messages#
Message | Means |
|---|---|
|
|
| Some lines are not translated yet; they show in English. Download the latest translation from Admin → Updates. |
| No image host is set. See Image Uploads. |
| Fivemanage is used and the webhook ignored. Clear one to silence it. |
| The banking value has no matching bridge file. See Society Money above. |
| A saved camera uses a model removed from |
| A configured prop or vehicle model is missing from the game. Check the spawn name, and that |
| Your keys script refused the call. Check its version against the bridge in |
| A newer version exists. Download it from the CFX Portal; the changelog link is printed with it. |
Still stuck? Open a ticket and include your boot summary (the
[compat]lines), your framework and inventory, the exact console message, and what you did just before it happened.



