What goes wrong most often, what it actually means, and what to do about it. Most of these are load order or configuration, not faults. Keep Config.Debug on while you investigate — the server console and the F8 console then report every zone loaded, created, edited, entered and left.
Installation and Access#
The resource stops at start with an error about custom.none
No framework was found, so there is no bridge to load. Make sure es_extended, qb-core or qbx_core is ensured above qs-safezone-creator. A framework running under another name must be added to the frameworks table in config/main.lua — see Integrations.
"You do not have permission to do this." on /safezonecreator
The player is neither a framework admin nor in a job of Config.CreatorJobs with an allowed grade. On ESX the group must be admin or superadmin; on QBCore and Qbox, the admin or god permission or the command ace. An ace added to server.cfg only applies after a restart, and only to the identifier it names.
Table 'qs_safezones' doesn't exist
The database file was never imported. Import database/database.sql once and restart the resource — see Installation.
Every zone disappeared after an update
database.sql begins with DROP TABLE, so importing it again deletes every zone. Restore qs_safezones from a backup. Updates never need the database file — only a first install does.
The creator does not open, or the console says "No data returned from server"
The server refused or failed to send the creator's data — the jobs, gangs and weapons it needs. Scroll the server console up to the first error after start: it is usually the database or the inventory. If nothing at all appears and there is no error, the interface files are missing or half-copied — re-copy the whole resource from the download.
I edited a zone in the database and nothing changed
Zones are read once, when the resource starts. Restart the resource after editing the table by hand — or, better, edit the zone in the creator, which updates everybody at once.
Drawing and Saving Zones#
The Zone Points field is still empty after drawing
The shape had fewer than four corners, so it was thrown away. Press the field again and left-click at least four corners before pressing ENTER.
The zone stays red while I draw it
Red means fewer than four corners, or a perimeter still under Config.MinPointLength (70 m by default). It is a guide, not a rule: a small room with four corners still saves. Lower the value if most of your zones are small.
"The point you selected is not within the zone area"
The blip must sit inside the zone you drew. Move until the red marker is on the ground inside the walls and click again. After redrawing a zone, the blip is checked against the new shape.
"You haven't selected any points" when placing the blip
Draw the zone first. The blip is placed inside it, so it cannot be set before the area exists.
"Please fill in all the fields"
A required field is empty: the zone's label, its points, or — with the blip switched on — the blip's name, sprite, colour, scale or position. The empty field is outlined in red. Switch the blip off if the zone should not have one.
The zone does not cover the floor above or below
Zones are flat and centred on the height you were standing at when you started drawing. Redraw it from the right floor, or make it taller with Z while drawing. Turn on Show Area on World to see exactly what it covers.
Inside the Zone#
Some players can still shoot inside a zone
They are exempt: their job and grade, or their gang and grade, are in the zone's Access Control, or the weapon they are holding is in its Bypass Items. Remove them from the zone if that was not intended. Also check that no other safe zone or anticheat script is changing the same controls.
Exempt players are still disarmed
Exemption is per grade. For a job, check that the player's grade is among the selected ones — open the job with the pencil to see them. For a gang, at least one grade must be selected; a gang with none exempts nobody.
The bypass weapon list is empty
The creator lists your inventory's items whose name begins with weapon_ in lower case. A repeating standalone inventory warning in the console means no supported inventory was detected — start it above qs-safezone-creator. An inventory that names its weapons another way needs its bridge adjusted in server/custom/inventory/.
Players do not heal
Heal on Enter is off on that zone, or Config.Regeneration.health is false, which switches healing off on every zone. Healing adds 5 health every half second, up to the player's maximum — a player who is down still needs to be revived by your ambulance job.
Cars are not slowed down
The limit applies only to the driver, and not to drivers with access-control rights. A value of 0 means no limit.
No message when entering or leaving
Enable Notifications is off on that zone. If it is on and still nothing shows, check whether you replaced Notification in custom/client.lua with a resource that is not running.
The blip is missing from the map
The blip switch is off in that zone's Blip Settings, or it has no position. Blips are short-range: they show on the minimap only when you are nearby, and always on the pause-menu map.
Discord Logs#
Nothing is posted to Discord
creator in server/webhooks.lua is empty or not a valid webhook — it is the only entry Safezone Creator uses. Restart the resource after changing it. Logs are queued, so after a burst of changes the last ones can take a minute to arrive.
Console Messages#
What the messages printed by Safezone Creator mean:
Message | Means |
|---|---|
| The framework bridge loaded. The name after it is the one in use. |
| No supported inventory was found. Repeats every few seconds; bypass weapons have nothing to list. |
|
|
| A translation lacks that string; English is shown in its place. |
| The creator could not load its data. Look for an earlier server error. |
| A save or delete was refused because the player lost access while the creator was open — a job change, for example. |
| An update is out. Download it from the CFX Portal and replace the folder — without importing the database again. |
| The update check could not be answered, or the folder was renamed. The script runs normally. |
Still stuck? Open a ticket and include the server console from the start of the resource, your framework and inventory with their versions, and a screenshot of the F8 console if the problem is in game.



