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:

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:

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