> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/event.md).

# Event

One `.dat` file per scheduled event. Each file defines its own schedule, rewards, monster spawns, and stage progression. High-level enable flags live in [GameServerInfo - Event.dat](/docs/gameserver/event-dat.md); this folder holds the detailed content each event needs to run.

## File Location

```
Data/Event/
```

Every file loaded once at GameServer startup. Changes require a restart.

## File Format

All event files use the same section-based text format:

```
<section_id>
//<column comments>
<row data>
<row data>
end

<next_section_id>
//<column comments>
<row data>
end
```

* Sections are numbered starting from 0 (or sometimes comment-labeled)
* Each section begins with its ID on its own line
* Column header lines start with `//`
* Data rows follow, whitespace-delimited (tabs or spaces both fine)
* Each section ends with `end` on its own line

A wildcard `*` in a time column means "any". For example, `* * * * 0 0 0` means every year, month, day, and weekday, at `00:00:00`.

## Event Index

| Event                                                     | File                                      | Enable flag                                                   |
| --------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------- |
| [Blood Castle](/docs/data/event/bloodcastle.md)           | `BloodCastle.dat`                         | Event.dat `BloodCastleEvent`                                  |
| [Bonus Manager](/docs/data/event/bonusmanager.md)         | `BonusManager.dat`                        | Event.dat `BonusManagerSwitch`                                |
| [Castle Deep](/docs/data/event/castledeep.md)             | `CastleDeepEvent.dat`                     | Event.dat `CastleDeepEvent`                                   |
| [Castle Siege](/docs/data/event/mucastledata.md)          | `MuCastleData.dat`                        | Common.dat `EnableCastleSiege` + Event.dat `CastleSiegeEvent` |
| [Chaos Castle](/docs/data/event/chaoscastle.md)           | `ChaosCastle.dat`                         | Event.dat `ChaosCastleEvent`                                  |
| [Crywolf](/docs/data/event/crywolf.md)                    | `Crywolf.dat`                             | Event.dat `CrywolfEvent`                                      |
| [Devil Square](/docs/data/event/devilsquare.md)           | `DevilSquare.dat`                         | Event.dat `DevilSquareEvent`                                  |
| [Double Goer](/docs/data/event/doublegoer.md)             | `DoubleGoer.dat`                          | Event.dat `DoubleGoerEvent`                                   |
| [Illusion Temple](/docs/data/event/illusiontemple.md)     | `IllusionTemple.dat`                      | Event.dat `IllusionTempleEvent`                               |
| [Imperial Guardian](/docs/data/event/imperialguardian.md) | `ImperialGuardian.dat`                    | Event.dat `ImperialGuardianEvent`                             |
| [Invasions](/docs/data/event/invasionmanager.md)          | `Invasions/*.xml` (one file per invasion) | Event.dat `InvasionManagerSwitch`                             |
| [Kanturu](/docs/data/event/kanturu.md)                    | `Kanturu.dat`                             | Event.dat `KanturuEvent`                                      |
| [Moss Merchant](/docs/data/event/mossmerchant.md)         | `MossMerchant.dat`                        | Event.dat `MossMerchantEvent`                                 |
| [Raklion](/docs/data/event/raklion.md)                    | `Raklion.dat`                             | Event.dat `RaklionEvent`                                      |
| [Rei do MU](/docs/data/event/reidomu.md)                  | `ReiDoMu.dat`                             | Event.dat `ReiDoMUEvent`                                      |

{% hint style="warning" %}
The high-level enable flag in Event.dat only gates whether the event runs. Schedule and content come from this file. Setting `BloodCastleEvent = 1` with an empty `BloodCastle.dat` makes the event run but spawn nothing.
{% endhint %}

## Common Sections Across Events

* **Time block** - sections using the 7-column year/month/day/DoW/hour/minute/second format for scheduling
* **WarningTime / NotifyTime / EventTime / CloseTime** - how long the pre-event warning, entry window, main run, and cleanup last (minutes)
* **Level / Reward tables** - per-tier experience, zen, item rewards indexed by event level
* **Monster spawn blocks** - per-stage monster class, count, and coordinates

Individual event pages below document each file's full section layout.