# Limited Zones

{% hint style="danger" %}
⭐ This plugin is private! Can be purchased on our [Discord Marketplace](https://discord.com/invite/Tzmq98gwqF).
{% endhint %}

{% hint style="info" %}

> With this addon you can create limited zones for a specified number of players. For example, if there are only a few players on the server, you can configure the game to take place in a specific part of the map. Exits from these zones can be **blocked** using entities via the editor.

> The plugin includes a built-in editor that allows you to create and modify zones for a specific number of players. 

 **What does the editor offer?**

1. `Max Players`
   * Allows you to set the maximum number of players required for the zone to activate.
2. `Spawn Enemies Distance`
   * Enables you to configure a unique spawn distance from enemies for each zone.
3. `Boxes`
   * These boxes define the playable zones where players can spawn (you can create multiple boxes per zone). Any spawns located outside the defined boxes will be deactivated.
4. `Props (Entities)`
   * Used to block the exits of individual zones, reducing the playable area and ensuring smoother, more focused gameplay.<br>

> When creating zones, have the language set to **"en"** in `configs/core.json` in `ServerLanguage`
> {% endhint %}

### Zones Preview

{% embed url="<https://www.youtube.com/watch?v=kZQhcFh2BS0>" %}

### Editor Preview

{% embed url="<https://www.youtube.com/watch?ab_channel=Nocky&v=jPmZ2N6Gj_c>" %}

### Config

<table><thead><tr><th></th><th width="308">What it does</th><th>Available Values</th></tr></thead><tbody><tr><td><strong>Respawn All Players</strong></td><td>Determines whether all players will be respawned when a zone is activated</td><td><mark style="color:green;"><code>true</code></mark> / <mark style="color:red;"><code>false</code></mark></td></tr><tr><td><strong>Count Bots As Players</strong></td><td>Specifies whether bots should be counted as regular players</td><td><mark style="color:green;"><code>true</code></mark> / <mark style="color:red;"><code>false</code></mark></td></tr><tr><td><strong>Zone Change Cooldown</strong></td><td>The time it takes to switch zones after a zone change is triggered</td><td><mark style="color:blue;"><code>seconds</code></mark></td></tr><tr><td><strong>Map Start Cooldown</strong></td><td>The time during which zone changes are disabled at the start of a map</td><td><mark style="color:blue;"><code>seconds</code></mark></td></tr><tr><td><strong>Check Spawn Points Under/Above Box</strong></td><td>Determines whether spawn points can be located above or below boxes, or must be inside them</td><td><mark style="color:green;"><code>true</code></mark> / <mark style="color:red;"><code>false</code></mark></td></tr><tr><td><strong>Entity Props</strong></td><td>List of all entities that will be displayed in the menu editor (Props)</td><td></td></tr></tbody></table>

### Admin Commands (Permission: @dm/zones)

1. **`css_dm_zones`**\
   \- Opens a menu with the zone editor
2. **`css_dm_setzone <player_count>`**\
   \- Activates a zone for the number of players you select


---

# 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://docs.sourcefactory.eu/deathmatch/modules/limited-zones.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.