> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/data/custom/customarena.md).

# CustomArena

<mark style="color:green;">Configures up to 30 automatic PvP arenas (class-specific or unrestricted), with scheduled times, entry requirements, and entry/exit gates.</mark>

### <mark style="color:yellow;">Block 0 — Arena Schedule</mark>

| Column                           | Accepted Values         | Description                                                                                          |
| -------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------- |
| AI                               | Number from `0` to `29` | The arena this schedule entry belongs to. Multiple rows may use the same `AI`.                       |
| YR / MT / DY / DW / HR / MN / SC | Number, or `*`          | Year/Month/Day/Day of the Week/Hour/Minute/Second when the arena opens. `*` = any value is accepted. |

### <mark style="color:yellow;">Block 1 — General Arena Settings</mark>

<table data-search="false"><thead><tr><th>Column</th><th>Accepted Values</th><th>Description</th></tr></thead><tbody><tr><td>AI</td><td>Number from <code>0</code> to <code>29</code></td><td>The arena this row belongs to (one row per arena).</td></tr><tr><td>AN</td><td>Quoted text</td><td>Name of the arena.</td></tr><tr><td>AT</td><td>Number (minutes)</td><td>Announcement period before the arena opens.</td></tr><tr><td>ST</td><td>Number (minutes)</td><td>Waiting time (entry queue phase) before the battle begins.</td></tr><tr><td>ET</td><td>Number (minutes)</td><td>Duration of the battle.</td></tr><tr><td>CT</td><td>Number (minutes)</td><td>Cleanup/closing period after the battle ends, before the next cycle.</td></tr><tr><td>SG</td><td>An <code>Index</code> value from <code>Gate.txt</code></td><td>Entry gate for the arena.</td></tr><tr><td>FG</td><td>An <code>Index</code> value from <code>Gate.txt</code></td><td>Exit gate (where players are sent when the event ends).</td></tr><tr><td>MnU</td><td>Number</td><td>Minimum number of players required for the battle to start.</td></tr><tr><td>MxU</td><td>Number, or <code>*</code></td><td>Maximum number of players. <code>*</code> = no limit.</td></tr><tr><td>MD</td><td>Number</td><td>Maximum number of deaths a player may accumulate inside the arena (reaching the limit removes the player).</td></tr><tr><td>MnL / MxL</td><td>Number, or <code>*</code></td><td>Minimum/maximum character level required to enter. <code>*</code> = no limit.</td></tr><tr><td>MnM / MxM</td><td>Number, or <code>*</code></td><td>Minimum/maximum Master Level required. <code>*</code> = no limit.</td></tr><tr><td>MnR / MxR</td><td>Number, or <code>*</code></td><td>Minimum/maximum Reset count required. <code>*</code> = no limit.</td></tr><tr><td>MRn / MRx</td><td>Number, or <code>*</code></td><td>Minimum/maximum Master Reset count required. <code>*</code> = no limit.</td></tr><tr><td>DW / DK / FE / MG / DL / SU / RF</td><td><code>0</code> or <code>1</code></td><td><code>1</code> = this class may enter the arena. <code>0</code> = this class is not allowed.</td></tr></tbody></table>

### <mark style="color:yellow;">Notes</mark>

* Each arena progresses through four phases in sequence: announcement (`AT`) → entry queue (`ST`) → battle (`ET`) → cleanup (`CT`). All time values are specified in minutes.
* The class columns (`DW` through `RF`) allow the creation of class-exclusive arenas (such as the default `GM X GM` and `BM X BM` examples, each permitting only a single class) or unrestricted arenas for all classes (such as `SURVIVOR`, where all class flags are set to `1`).
* `SG` and `FG` reference entries in `Gate.txt` — arenas do not define their own coordinates and instead reuse existing gate definitions from that file.