> For the complete documentation index, see [llms.txt](https://atiysus-organization.gitbook.io/aty-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atiysus-organization.gitbook.io/aty-scripts/zone-creator/guide/troubleshooting.md).

# Troubleshooting

### `/zonemanager` does nothing / "no permission"

* Confirm you have access — see Permissions & Roles. Quick test: `add_ace group.admin command.zonecreator allow`.
* Make sure `aty_lib` started **before** `aty_zonecreator` in `server.cfg`.

### Blips leak onto the minimap / radar

FiveM's area/radius blips can bleed onto the minimap (an engine limitation — short-range doesn't work on them). If you see them there, set:

```lua
Config.MapAreaFill = false
```

Only the labelled **point** blip stays on the big map; the shape is still visible up close via the in-world preview.

### Zone weather keeps snapping back / clock jumps to a fixed hour

An external weather-sync is overwriting the override. `qb-weathersync` is handled automatically; for others, hook `Config.Integrations.onWeatherOverride`:

```lua
onWeatherOverride = function(taking) exports['my-weather']:PauseSync(taking) end
```

### Ambient sound doesn't play

Ambient sound needs **`aty_3dsound`** started **and** a source URL for that sound name in `Config.AmbientSounds`. Empty URLs are skipped silently (no audio ships with the resource).

### The map is a blank dark grid

The remote map tiles are unreachable. Zones remain fully editable — this is only the background tileset. Check outbound connectivity or use it as-is.

### Restriction (weapons/inventory/phone) not applying

* The relevant integration must be one of the auto-detected scripts. For a custom phone, wire `Config.Integrations.onPhoneLock`.
* Restrictions **stack** across overlapping zones (strictest wins) — check whether another zone is granting a bypass via **Bypass Groups**.

### A "no-entry" zone can still be entered

* Entry gates are per-zone: confirm the right gate is enabled (Group *No Entry*, Keycard, Password, Capacity, Toll/Rent).
* **Bypass Groups** and higher admin roles may be exempt by design.
* The player must actually be **detected inside** — very thin zones or extreme Min/Max Z limits can miss; widen them.

### Diagnostic mode

Set `Config.Debug = true` to print the decision/apply steps of each system to the server console and F8. Turn it **off** in production.

### Still stuck?

Join the community: <https://discord.gg/dvPMYsRFNx>