> 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/zone-settings-15-categories.md).

# Zone Settings — 15 Categories

Every zone carries **119 settings** grouped into 15 sections. Open a section in the panel to edit it; hover any field to see its help text. Below is what each section does.

***

### 1. Preferences

Identity & appearance.

| Setting      | Description                                                               |
| ------------ | ------------------------------------------------------------------------- |
| Zone Label   | Display name (map + notifications).                                       |
| Zone ID      | Unique id used by exports/other scripts.                                  |
| Description  | Internal admin note (not shown to players).                               |
| Category     | Groups the zone in lists/filters (Safe Zone, PvP Arena, Gang Territory…). |
| Zone Color   | Map overlay **and blip** color.                                           |
| Active State | Inactive zones stay saved but apply no rules.                             |
| Preset       | Apply a saved preset, or save this zone as one.                           |

### 2. Geometry

Shape, height and priority — see Drawing Zones. Draw Mode, Min Z / Max Z, Priority / Layer, Live Preview Style.

### 3. Weather

Per-zone weather & time override.

| Setting                                 | Description                                         |
| --------------------------------------- | --------------------------------------------------- |
| Zone Weather                            | Master toggle.                                      |
| Weather Type                            | Forced weather (EXTRASUNNY … BLIZZARD, HALLOWEEN…). |
| Blend Time                              | Seconds to fade between weathers.                   |
| Freeze Time / Frozen Hour               | Lock the clock at a set hour inside the zone.       |
| Wind Speed / Direction · Snow On Ground | Extra atmosphere controls.                          |
| Sync Mode                               | Apply to *Only Player* or *Everyone In*.            |
| Timed Cycle                             | Different weather per hour range.                   |

{% hint style="info" %}
`qb-weathersync` is paused/resumed automatically while an override is active. For other syncs, use `Config.Integrations.onWeatherOverride`.
{% endhint %}

### 4. PvP

Combat rules.

| Setting                           | Description                                                 |
| --------------------------------- | ----------------------------------------------------------- |
| PvP State                         | Enable/disable player-vs-player.                            |
| Friendly Fire                     | Allow same-group damage.                                    |
| Damage Multiplier                 | Scales all damage dealt inside.                             |
| Weapon Policy                     | *All / Whitelist / Blacklist / Melee only* (+ weapon list). |
| Bypass Groups                     | Jobs/gangs exempt from the weapon rule (e.g. police).       |
| Headshots · Auto Holster On Enter | Extra combat toggles.                                       |

### 5. NPC

Ambient peds & dispatch.

Ped Density, Scenario Peds, Ped Aggression (*Friendly/Neutral/Hostile*), Police Dispatch, Max Wanted Level, Corpse Cleanup, NPC Weapons, and **Custom Spawns** (spawn specific ped models with count + behavior).

### 6. Animals

Wildlife spawns: enable, **Species**, Density, Behavior, Flock/Herd, Day/Night variants (nocturnal species after dark).

### 7. Traffic

AI traffic control.

Empty Roads Mode, Traffic Density, Parked Vehicles, **Blocked Vehicle Classes** (+ bypass groups), Emergency Traffic, Driving Style, AI Speed Cap.

### 8. Visual & Atmosphere

The "wow" layer — applied instantly on entry.

| Setting               | Description                                                       |
| --------------------- | ----------------------------------------------------------------- |
| Timecycle Modifier    | Color grade (REDMIST, nightvision, underwater…).                  |
| Post-Process FX       | Screen effect (ChopVision, DrugsMichaelAliens…).                  |
| Enter Screen Effect   | One-shot on entry: *Fade / Flash / Pulse*.                        |
| Ambient Sound         | Looped 3D sound at the zone centre (needs `aty_3dsound` + a URL). |
| Particles / Intensity | Fog, Smoke, Embers, Radiation Dust, Fireflies, Snowfall.          |
| Fog Density / Color   | Colored fog wrapping the player.                                  |

### 9. Allow Settings

What players may do inside. Toggles for Weapon Use, Vehicle Use, **Speed Limit**, Sprinting, Jumping, Phone, Inventory, Item Use, Item Drop, Voice — plus **Bypass Groups** exempt from every restriction in this section.

### 10. Group Settings

Job/gang mechanics.

Group Access mode, affected Groups, **Per-Group Rules** (Godmode, No Damage Given, Double Damage, No Entry, Notify Admins, Auto Kick), **Territory Ownership**, Capturable + Capture Time, **Territory Income** ($/hour), Enter/Exit Notify + color, Ally / Enemy groups.

### 11. Triggers & Events

Fire your own events on zone activity — see Trigger & State Hooks. On Enter / On Exit / While-Inside (tick), **On Death / On Vehicle Enter / On Vehicle Exit / On Weapon Fire**, Enter/Exit notification, Discord Webhook, Conditions (required item/job), Cooldown, One-Time, Chain Zone.

### 12. Gameplay

Status effects.

| Setting                                          | Description                                                                                          |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| Safe Zone (Green Zone)                           | Crime disabled + invincibility inside.                                                               |
| Damage Over Time                                 | *Radiation / Gas / Fire / Electric / Cold* with a per-second value — each with real visual feedback. |
| Healing Zone                                     | Regenerate HP/armor per second.                                                                      |
| Player Speed · Gravity                           | Movement multipliers.                                                                                |
| Stamina Drain · Oxygen Drain · Drunk/Drug Effect | Physical debuffs.                                                                                    |

### 13. Economy

Money mechanics. Toll / Entry Fee, Rent / Property, **Harvest Resource** + rate (gatherable inside), Robbery Zone flag (fires an event for your robbery script).

### 14. Access & Schedule

Entry gates — see Entry Control & Access. Scheduled Zone (active days + from/to), Event-Bound, **Keycard** item, **Password** door code, Max Capacity.

### 15. Map & Blip

Player-map presence. Map Blip toggle, Blip Label, **Sprite ID**, **Scale**, Show Colored Area, Minimap Highlight.

{% hint style="success" %}
The **blip color is not chosen separately — it follows the zone color** (mapped to the nearest GTA blip palette id). Blips are shown on the **big map only**, keeping the minimap/radar clean.
{% endhint %}