> 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/restaurant-creator/zone-creator.md).

# Zone Creator

## 🗺️ ATY Zone Creator

**ATY Zone Creator** lets admins draw any area on a live map and bind **119 gameplay rules across 15 categories** to it — weather, atmosphere, PvP, NPCs, access gates, economy, triggers and more — without touching a single config file. Everything is **server-authoritative**: the client only applies what the server decides, so no rule can be bypassed by a modified client.

{% hint style="info" %}
This documentation has two tracks:

* **User Guide** — for server owners: installing, drawing zones and using every panel.
* **Developer** — for scripters: exports, events, trigger hooks and the data schema.
  {% endhint %}

### What can you build?

| Example                    | Combines                                                                        |
| -------------------------- | ------------------------------------------------------------------------------- |
| ☢ Radiation / fallout zone | Weather + REDMIST timecycle + radiation DOT (screen warp) + fog + keycard entry |
| 🛡️ Safe / green zone      | PvP off + weapon holster + invincibility + healing + calm NPCs                  |
| 💀 PvP arena               | PvP on + damage multiplier + no police + empty roads + red atmosphere           |
| 🏴 Gang territory          | Group access + capture mechanic + passive income + enter notifications          |
| 🔒 VIP / gated area        | Keycard **or** password door + capacity limit + entry toll/rent + schedule      |
| 🎣 Job / harvest zone      | Resource harvesting + robbery flag + custom trigger events                      |

### Highlights

* **Fully in-game builder** — circle, box and polygon zones drawn on a Leaflet map (or walked out in-world).
* **15 rule categories / 119 settings** per zone.
* **Real DOT feedback** — fire actually burns you, radiation warps the screen, gas makes you cough, electricity shocks, cold makes you shiver.
* **3-layer entry control** — invisible barrier → countdown eject panel → server enforcement.
* **Deep hooks** — On Enter/Exit, While-Inside tick, On Death, On Vehicle Enter/Exit, On Weapon Fire + fired events & exports.
* **Debounced auto-save** — every change persists automatically, no Save button.
* **TR / EN localization** — one config key drives both the panel and in-game notifications.
* **QBCore / ESX / Qbox** via the `aty_lib` bridge.

### Quick links

* Installation
* Zone Settings — all 15 categories
* Developer: Exports · Events · Trigger & State Hooks
* Full config.lua reference

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