# Zone System

## 🗺️ Zone System

The zone system creates a classic **battle royale-style shrinking circle** inside your arena.

***

### How It Works

There are two rings:

```
🔴 Outer Ring  →  Red zone   →  players here take damage every tick
🟢 Inner Ring  →  Safe zone  →  no damage
```

As the zone shrinks, the **safe inner ring gets smaller** until it reaches the minimum radius, at which point the entire area becomes red and players take constant damage.

***

### Zone Behaviour

* Players outside the **safe zone** but inside the **red zone** take periodic damage
* Damage amount and tick speed are set in `config.lua`
* Players see a **HUD warning** when they are in the danger zone
* **Map blips** show both rings on the minimap
* An optional **vertical marker column** shows the zone edge visually in the world

***

### Auto-Shrink

When auto-shrink is enabled from the admin panel:

1. Admin sets the duration *(in minutes)*
2. A timer starts automatically
3. The safe zone **gradually moves and shrinks**
4. A **live countdown** is visible in the admin panel
5. Once minimum radius is reached → **full red zone**
6. Admin can stop it at any time from the Zone tab

***

### Manual Shrink

Admins can also shrink the zone **instantly by a percentage** using the slider in the **Zone tab** of the admin panel.

***

### Configuration Reference

```lua
Config.Zone = {
    radius        = 150.0,  -- Starting outer radius (meters)
    safeRatio     = 0.6,    -- Safe zone ratio (0.6 = 60% of outer radius)
    damage        = 5,      -- Damage per tick outside safe zone
    interval      = 5000,   -- Tick interval in ms (5000 = every 5 seconds)
    minSafeRadius = 20.0,   -- Minimum safe radius before full red
}
```


---

# Agent Instructions: 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://mohssins.gitbook.io/mohscriptsdocs/moh-gangwar/zone-system.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.