> For the complete documentation index, see [llms.txt](https://docs.0resmon.org/0resmon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.0resmon.org/0resmon/0r-resources/0r-safezonecreator/faq.md).

# F.A.Q

<details>

<summary>The /safezonecreator command does nothing</summary>

Check permissions:

* Framework admin (ESX/QB/QBX admin flag), or
* ACE: default is `command.safezone` — must match `ace` in `config/main.lua` and your `server.cfg` principals.

Restart the resource after config changes.

</details>

<details>

<summary>Zones are not saving</summary>

The server writes to **`data/zones.json`**. If the file is missing, corrupt, or the folder is not writable, the resource logs repeated load errors and zones will not persist.

Fix: ensure `data/` exists, restore valid JSON (`{}` at minimum), and check file permissions on your host.

</details>

<details>

<summary>Players are not disarmed in a no-weapons zone</summary>

**Disable Firearms** uses `disarmPlayer` in `config/main.lua`. For **ox\_inventory**, the default `ox_inventory:disarm` event must work. For other inventories, extend that function to call your inventory’s disarm API.

</details>

<details>

<summary>No enter/leave notification</summary>

Check three layers:

1. `notifications.enabled = true` in config
2. Per-zone **Notification** enabled in the editor
3. `customNotifications` — `true` shows the NUI banner; `false` uses LT.Notify toasts (needs a working notify backend from `setup.notify`)

</details>

<details>

<summary>Zone borders are invisible</summary>

The zone needs **Show Zone Borders** on in the editor. You must also be within `preview.maxDistance` in `config/main.lua` (default **350** meters) for the outline to draw.

</details>

<details>

<summary>Polygon will not save or finish in point mode</summary>

You need at least **three** points placed in order along the border (no crossing edges). If the preview turns red or finish is blocked, undo points and trace the perimeter again without zig-zagging through the middle.

</details>

<details>

<summary>Job whitelist does not work</summary>

Job `name` in the whitelist must match the framework job id exactly (`police`, not `Police`). **Min Grade** is inclusive — grade `2` allows grade 2 and above if your framework uses numeric grades.

Whitelisted players are exempt from restrictions; they still physically enter the zone.

</details>

<details>

<summary>Server feels heavy with many zones or busy areas</summary>

Raise intervals in `config/main.lua` → `safezone` (`vehicleScanMs`, `pedCollisionMs`, `vehicleCollisionMs`). Disable heavy per-zone options (vehicle collision scans, ghost mode on huge areas) where you do not need them.

</details>