> 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.0resmon.org/0resmon/0r-resources/0r-safezonecreator/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.