> 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/gameserver/data/event.md). # Event ## GameServerInfo - Event.dat Enables/disables and adjusts parameters for each server event (Blood Castle, Chaos Castle, Devil Square, Castle Siege, custom "PK" events, etc.). ### Blood Castle | **Key** | **What it is** | | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | BloodCastleEvent | `0`/`1` — enables the event. | | BloodCastleMaxUser | Maximum number of players allowed inside the event simultaneously. | | BloodCastleAwardParty | `1` = the final reward also considers/benefits players who are in a party with the winner. | | BloodCastleEnterType | `0` = the entry range (`ReqLevel`, etc., from the event file) is compared against the player's Level. `1` = against Resets. `2` = against Master Resets. | ### Bonus Manager | **Key** | **What it is** | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | BonusManagerSwitch | `0`/`1` — enables the server's periodic bonus system (the EXP/Drop/Zen bonus "banner" seen in the client). If disabled, the entire system remains blank/inactive. | ### Castle Deep | **Key** | **What it is** | | ------------------- | ---------------------------------- | | CastleDeepEvent | `0`/`1` — enables the event. | | CastleDeepEventTime | Duration of the event, in minutes. | ### Castle Siege | **Key** | **What it is** | | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | CastleSiegeEvent | `0`/`1` — enables Castle Siege. | | CastleSiegeCycleStartYear / Month / Day | Reference date from which the weekly Castle Siege cycle is calculated. | | CastleSiegeSpecificState | Allows forcing Castle Siege to start at a specific state in the cycle (instead of always starting from scratch). | | CastleSiegeStateStartYear / Month / Day / Hour / Minute | Reference date/time for the specific forced state mentioned above. | | CastleSiegeOffensiveWeaponDamage | Damage dealt by offensive siege weapons (catapults, etc.). | | CastleSiegeDefensiveWeaponDamage | Damage dealt by defensive siege weapons (towers, etc.). | | CastleSiegeLowerAccumulatedTimeValue | How much time (in milliseconds) is deducted from the "accumulated crown time" during each check while the player remains stationary on it. | | CastleSiegeDecayAccumulatedTimeValue | How much time (in milliseconds) is deducted from the "accumulated crown time" when the player moves away from it. | ### Chaos Castle | **Key** | **What it is** | | ----------------------- | --------------------------------------------------------------------------------------------------- | | ChaosCastleEvent | `0`/`1` — enables the event. | | ChaosCastleMinUser | Minimum number of players required for the event to start. | | ChaosCastleBlowUserRate | Chance (%) for the event's "punch"/explosion to knock the player off the map on each cycle. | | ChaosCastleEnterType | `0` Level / `1` Reset / `2` Master Reset — shares the same functionality as `BloodCastleEnterType`. | ### Crywolf | **Key** | **What it is** | | ------------------------- | ------------------------------------------------------------------------------ | | CrywolfEvent | `0`/`1` — enables the event. | | CrywolfBenefitSwitch | `0`/`1` — enables the bonuses granted when players win the Crywolf event. | | CrywolfBenefitChaosRate | Success rate bonus (%) for the Chaos Machine while the benefit is active. | | CrywolfBenefitMonsterLife | Health % of monsters on the Crywolf map while the benefit is active (reduced). | | CrywolfPenaltySwitch | `0`/`1` — enables the penalty when monsters win the Crywolf event. | | CrywolfPenaltyJewelDrop | Jewel drop rate % while the penalty is active (reduced). | | CrywolfPenaltyExperience | Experience gain % while the penalty is active (reduced). | ### Devil Square | **Key** | **What it is** | | -------------------- | --------------------------------------------------- | | DevilSquareEvent | `0`/`1` — enables the event. | | DevilSquareMaxUser | Maximum number of players allowed inside the event. | | DevilSquareEnterType | `0` Level / `1` Reset / `2` Master Reset. | ### Double Goer | **Key** | **What it is** | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DoubleGoerEvent | `0`/`1` — enables the event. | | DoubleGoerDifficultRate | % applied on top of the internally calculated difficulty (monster health/damage/defense, which scales based on the highest level in the party and the number of players). `100` = no change. | ### Illusion Temple | **Key** | **What it is** | | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | IllusionTempleEvent | `0`/`1` — enables the event. | | IllusionTempleMinUser | Minimum number of players required for the event to start. | | IllusionTempleRewardFenrirRate | Chance for the winning team to receive a Fenrir as a reward — note: the check is based on 10000, not 100 (e.g., `20` = 0.2% chance, not 20%). | ### Imperial Guardian | **Key** | **What it is** | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ImperialGuardianEvent | `0`/`1` — enables the event. | | ImperialGuardianDifficultRate | % applied on top of the internally calculated difficulty (health/damage/defense/rates of the guardian(s), which scales based on the highest level present). `100` = no change. | ### Invasion Manager | **Key** | **What it is** | | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | | InvasionManagerSwitch | `0`/`1` — enables scheduled invasions (`InvasionManager.dat`). | | FlyingDragonsSwitch | `0`/`1` — enables the flying dragons invasion. | | FlyingDragonsOnlyBossMapSpawn | `1` = flying dragons only spawn on the maps where the current invasion boss resides (instead of all maps featuring the invasion). | | FlyingDragonsKillBossDisappear | `1` = flying dragons disappear as soon as the invasion boss is defeated. | | InvasionManagerLogType | `0` = no log. `1` = writes to the log file. `2` = writes to the log file and displays it on the GameServer console screen. | ### Kanturu | **Key** | **What it is** | | ------------ | ----------------------------------------------------- | | KanturuEvent | `0`/`1` — enables the event (see also `Kanturu.dat`). | ### Moss Merchant | **Key** | **What it is** | | --------------------- | ---------------------------------- | | MossMerchantEvent | `0`/`1` — enables the event. | | MossMerchantEventTime | Duration of the event, in minutes. | ### Raklion | **Key** | **What it is** | | ------------ | --------------------------------------------- | | RaklionEvent | `0`/`1` — enables the event (Kundun/Raklion). | ### Quickly | **Key** | **What it is** | | ------------------------------- | -------------------------------------------------------------------- | | QuicklyEvent | `0`/`1` — enables the event. | | QuicklyEventAutoReward1 / 2 / 3 | WCoinC / WCoinP / Goblin Points awarded automatically to the winner. | ### Event Start | **Key** | **What it is** | | ---------------- | -------------------------------------------------------------------------------- | | EventStartSwitch | `0`/`1` — enables the "Event Start" custom event (triggered via NPC or command). | | EventStartTime | Duration of the event, in seconds. | ### Event Hide and Seek | **Key** | **What it is** | | ----------------------------------- | ------------------------------------------------------ | | EventHideAndSeekSwitch | `0`/`1` — enables the event. | | EventHideAndSeekMaxTime | Maximum duration, in minutes. | | EventHideAndSeekAutoReward1 / 2 / 3 | WCoinC / WCoinP / Goblin Points awarded to the winner. | ### Event Run and Catch | **Key** | **What it is** | | ----------------------------------- | -------------------------------------------------------------- | | EventRunAndCatchSwitch | `0`/`1` — enables the event. | | EventRunAndCatchTimeToEnter | Registration/waiting time before the event begins, in seconds. | | EventRunAndCatchMaxTime | Maximum duration of the event, in minutes. | | EventRunAndCatchAutoReward1 / 2 / 3 | WCoinC / WCoinP / Goblin Points awarded to the winner. | ### Event Russian Roulette | **Key** | **What it is** | | ------------------------------- | ---------------------------------------- | | EventRussianRouletteSwitch | `0`/`1` — enables the event. | | EventRussianRouletteTimeToEnter | Registration time, in seconds. | | EventRussianRouletteMaxTime | Maximum duration, in minutes. | | EventRussianRouletteMaxPlayer | Maximum number of participating players. | ### Event PvP (1x1) | **Key** | **What it is** | | --------------------------- | -------------------------------------------------------------------- | | EventPvPSwitch | `0`/`1` — enables the event. | | EventPvPMaxScore | Points required to win the match. | | EventPvPMaxTime | Maximum duration of each fight, in minutes. | | EventPvPAutoReward1 / 2 / 3 | WCoinC / WCoinP / Goblin Points awarded to the winner of each fight. | ### Event Kill All | **Key** | **What it is** | | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | EventKillAllSwitch | `0`/`1` — enables the event. | | EventKillAllTimeToEnter | Registration time, in seconds. | | EventKillAllDeadDecrease | Points lost upon dying. | | EventKillAllKillIncrease | Points gained upon killing another player. | | EventKillAllMaxScore | Score that ends the event (whoever reaches it first wins). | | EventKillAllMinPlayers / MaxPlayers | Minimum/maximum number of players allowed in the event. | | EventKillAllMaxTime | Maximum duration, in minutes. | | EventKillAllAutoReward1Rank1/2/3, AutoReward2Rank1/2/3, AutoReward3Rank1/2/3 | WCoinC / WCoinP / Goblin Points (Reward1/2/3) awarded to 1st, 2nd, and 3rd place finishers (Rank1/2/3). | ### Event Team vs Team | **Key** | **What it is** | | ---------------------------- | ---------------------------------------------- | | EventTvtSwitch | `0`/`1` — enables the event. | | EventTvtNpc | Class of the NPC used for player registration. | | EventTvtNpcMap / NpcX / NpcY | Exact position of that registration NPC. | | EventTvtMinUsers / MaxUsers | Minimum/maximum number of players. | ### King of the MU (Rei do MU) | **Key** | **What it is** | | -------------------------- | -------------------------------------------------------------------------------------------------- | | ReiDoMUEvent | `0`/`1` — enables the event. | | ReiDoMUMap / CordX / CordY | Map and exact position where the player must stand stationary to claim the title. | | ReiDoMUGuildMinMembers | Minimum number of members the player's guild must have for them to be eligible to claim the title. | ### Create Next Kalima Gate | **Key** | **What it is** | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Illusion\_of\_Kundun\_161, \_181, \_189, \_197, \_267, \_338 | `1` = killing a monster of this class (inside a Kalima map) automatically opens the gateway to the next Kalima level. `0` = this class does not open the next gate. | ### Notes * `IllusionTempleRewardFenrirRate` evaluates against a randomized range from 0 to 9999, rather than 0 to 99 — a value of `20` here equates to a 0.2% chance, not 20%. Exercise caution when adjusting this parameter. * `DoubleGoerDifficultRate` and `ImperialGuardianDifficultRate` do not dictate base difficulty on their own — instead, they act as a percentage multiplier applied on top of a dynamic difficulty that the event already calculates relative to the highest player level present and the total participant count. Setting it to `100` preserves the event's native difficulty calculation. * The "Create Next Kalima Gate" list contains exactly 6 classes — class `275` (which is present in the `Monster_XXX_Summon` parameters of `Skill.dat`) has no corresponding configuration key here. * `CastleSiegeLowerAccumulatedTimeValue` and `CastleSiegeDecayAccumulatedTimeValue` are measured in milliseconds, not seconds (the default value of `60000` is equivalent to 60 seconds). * Unlike `Lua.dat` or `Skill.dat`, actual operational values for this configuration file typically differ between the `GameServer\` directory and the `GameServerCS\` directory — for instance, it is standard practice for `CastleSiegeEvent` to be enabled exclusively on the sub-instance dedicated to Castle Siege execution. The layout structure and technical definition of each key remain consistent across both folders; only the tailored values are distinct.