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

# DevilSquare

<mark style="color:green;">Complete configuration for the Devil Square event. The file contains 6 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;">`5`</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                                                              |
| ----------- | ------------------ | ------------------------------------------------------------------------ |
| WarningTime | Number, in minutes | How long before the event starts the countdown warning begins to appear. |
| NotifyTime  | Number, in minutes | Duration of the waiting/entry phase before the event starts.             |
| 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 — experience rewards by ranking (per event level)</mark>

| Column                                 | Accepted Values    | Description                                                                                                            |
| -------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Level                                  | Number from 0 to 6 | Devil Square level.                                                                                                    |
| RewardExperience1 – RewardExperience10 | Number             | Experience awarded to players finishing from 1st to 10th place in the event ranking (`RewardExperience1` = 1st place). |

### <mark style="color:yellow;">Section 3 — Zen rewards by ranking (per event level)</mark>

| Column                       | Accepted Values    | Description                                                                                          |
| ---------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------- |
| Level                        | Number from 0 to 6 | Event level.                                                                                         |
| RewardMoney1 – RewardMoney10 | Number             | Zen awarded to players finishing from 1st to 10th place in the ranking (`RewardMoney1` = 1st place). |

### <mark style="color:yellow;">Section 4 — coin rewards (1st place only)</mark>

| Column | Accepted Values    | Description                                          |
| ------ | ------------------ | ---------------------------------------------------- |
| Level  | Number from 0 to 6 | Event level.                                         |
| WC     | Number             | Bonus WCoinC awarded to the 1st-place player.        |
| WP     | Number             | Bonus WCoinP awarded to the 1st-place player.        |
| GP     | Number             | Bonus Goblin Points awarded to the 1st-place player. |

### <mark style="color:yellow;">Section 5 — minimum and maximum level/reset requirements</mark>

| Column                  | Accepted Values    | Description                                                                               |
| ----------------------- | ------------------ | ----------------------------------------------------------------------------------------- |
| Level                   | Number from 0 to 5 | Event level.                                                                              |
| NormalMin / NormalMax   | Number             | Allowed range for first-class characters (Dark Wizard, Dark Knight, Fairy Elf, Summoner). |
| SpecialMin / SpecialMax | Number             | Allowed range for special classes (Magic Gladiator, Dark Lord, Rage Fighter).             |

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

* Unlike Blood Castle and Chaos Castle (which reward only the winner), Devil Square rewards players based on their **final ranking** (1st through 10th place). Both experience and Zen are awarded according to each participant's final position.
* The coin rewards in Block 4 are exclusive to the **1st-place** player. Players finishing from 2nd place onward do not receive any WC/WP/GP rewards.
* All timers in Block 0 are measured in **minutes**.
* The requirement used to allow entry—**Level**, **Reset**, or **Master Reset**—is defined by the `DevilSquareEnterType` option in `Event.dat`, not in this file.