> 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/event/tvtevent.md).

# TvTEvent

<mark style="color:green;">Configuration for the Team vs Team event (Blue Team vs Red Team). The file contains 4 blocks, each starting with the block number (</mark><mark style="color:green;">`0`</mark> <mark style="color:green;"></mark><mark style="color:green;">to</mark> <mark style="color:green;"></mark><mark style="color:green;">`3`</mark><mark style="color:green;">) on its own line and ending with</mark> <mark style="color:green;"></mark><mark style="color:green;">`end`</mark><mark style="color:green;">.</mark>

### <mark style="color:yellow;">Section 0 — general timers</mark>

| Column    | Accepted Values    | Description                                                              |
| --------- | ------------------ | ------------------------------------------------------------------------ |
| AlarmTime | Number, in minutes | How long before the event starts the countdown warning begins to appear. |
| StandTime | Number, in minutes | Duration of the waiting/entry phase before the event begins.             |
| EventTime | Number, in minutes | Duration of the event itself.                                            |
| CloseTime | Number, in minutes | Duration of the closing phase after the event ends.                      |

### <mark style="color:yellow;">Section 1 — start schedule</mark>

| Column                                            | Accepted Values | Description                                                               |
| ------------------------------------------------- | --------------- | ------------------------------------------------------------------------- |
| Year / Month / Day / DoW / Hour / Minute / Second | Number or `*`   | One scheduled start time per line. `*` = any value (cron-style schedule). |

### <mark style="color:yellow;">Section 2 — entry and map settings</mark>

<table data-search="false"><thead><tr><th>Column</th><th>Accepted Values</th><th>Description</th></tr></thead><tbody><tr><td>ReqItemIndex</td><td>Number, or <code>0</code></td><td>See the notes below — <strong>the actual order read by the server differs from the order shown in the file comment.</strong></td></tr><tr><td>ReqItemLevel</td><td>Number, or <code>0</code></td><td>See the notes below.</td></tr><tr><td>ReqItemCount</td><td>Number, or <code>0</code></td><td>See the notes below.</td></tr><tr><td>EventMap</td><td>Map number</td><td>Map where the TvT event takes place.</td></tr><tr><td>WaitingGate</td><td>Gate number (<code>Gate.txt</code>)</td><td>Gate used to send players during the waiting phase.</td></tr><tr><td>BlueTeamGate</td><td>Gate number</td><td>Entry gate for the Blue Team when the event begins.</td></tr><tr><td>RedTeamGate</td><td>Gate number</td><td>Entry gate for the Red Team when the event begins.</td></tr><tr><td>SetSkin</td><td><code>0</code> or <code>1</code></td><td>Applies a team appearance (blue/red) to participants during the event.</td></tr><tr><td>MinLevel / MaxLevel</td><td>Number or <code>*</code></td><td>Allowed level range. <code>*</code> = no limit.</td></tr><tr><td>MinReset / MaxReset</td><td>Number or <code>*</code></td><td>Allowed reset range. <code>*</code> = no limit.</td></tr><tr><td>MinMasterReset / MaxMasterReset</td><td>Number or <code>*</code></td><td>Allowed master reset range. <code>*</code> = no limit.</td></tr></tbody></table>

### <mark style="color:yellow;">Section 3 — coin reward (winning team only)</mark>

| Column | Accepted Values | Description                                                    |
| ------ | --------------- | -------------------------------------------------------------- |
| WC     | Number          | Bonus WCoinC awarded to each player on the winning team.       |
| WP     | Number          | Bonus WCoinP awarded to each player on the winning team.       |
| GP     | Number          | Bonus Goblin Point awarded to each player on the winning team. |

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

* **The first three columns of Block 2 do not follow the order shown in the file's own comment.** The comment lists them as `ReqItemIndex ReqItemLevel ReqItemCount`, but the server actually reads them as: **1st column = `ReqItemCount`, 2nd column = `ReqItemIndex`, 3rd column = `ReqItemLevel`** (confirmed in `EventTvT.cpp`). Since all three values are `0` in the default file (no required item), this usually goes unnoticed. However, if you configure an entry item, this is the actual column order that matters.
* The reward from Block 3 is granted only to players on the **team with the highest score** when the event ends. If the match ends in a tie, nobody receives the reward.
* The gates (`WaitingGate`, `BlueTeamGate`, and `RedTeamGate`) must reference valid entries in `Gate.txt`.