Event.dat

Master on/off and light-tuning for the server's events. Schedules, reward pools, monster waves, and map-specific behavior live in the shared Data/Event/*.dat files; this file only decides whether each event is active and how its headline numbers are tuned.

File Location#

GameServer/Data/GameServerInfo - Event.dat

All keys under [GameServerInfo]. Changes require a GameServer restart.

Standard Events#

Most standard events ship enabled by default. Exceptions noted per section (Castle Siege and Crywolf ship off).

Blood Castle#

See BloodCastle.dat for schedule, rewards, and per-stage monster lists.

Bonus Manager#

See BonusManager.dat for the shared bonus windows.

Castle Deep#

See CastleDeepEvent.dat for schedule and monster data.

Castle Siege#

Gated by Common.dat EnableCastleSiege. Schedule anchors are zero by default, meaning the next cycle is computed from the current date.

Chaos Castle#

Crywolf#

Devil Square#

Double Goer#

Illusion Temple#

Kalima#

Kalima has no Event switch. These keys gate both the Lost Map +N and the Kalima Ticket with one table, so the two can never disagree.

Untouched (all -1 and KalimaMasterAnyTier = 0) = vanilla level brackets (MG/DL/RF: 20/111/161/211/261/311/350, others: 40/131/181/231/281/331/350) and any Kalima at or below your bracket is open.

Configured: a Lost Map +N opens only if the char passes every bound of tier N. The Kalima Ticket sends you to the highest tier you pass (a master with KalimaMasterAnyTier = 1 goes to Kalima 7). Leave Max* at -1 if higher chars should still be able to enter lower Kalimas. No per-IP cap (Kalima is an open map).

Imperial Guardian#

Invasion Manager#

Each invasion is its own XML file under Data/Event/Invasions/. The legacy InvasionManager.dat is no longer read.

Kanturu#

Moss Merchant#

Raklion#

Rei do MU (King of MU)#

Removed Custom Events#

Guild vs Guild, Team vs Team, Kill All, PvP 1x1, Run and Catch, Russian Roulette, Hide and Seek, the Quickly event and the EventStartSwitch / EventStartTime scheduler were removed. Their keys are no longer read, TvTEvent.dat and GvGEvent.dat are gone, and their commands (/veloz, /abrirevento, /participar, /pegapega, /queroir, /escesc, /roletarussa, /offpvp, /pvp, /matamata, /starttvt, /startgvg) were removed from Command.xml. Old keys left in Event.dat are ignored.

For class-vs-class fights use the Custom Arena (Plugins/Events/CustomArena.xml); players join from the Move window while an arena is open.

Bracket Entry Gates#

Devil Square, Blood Castle, Chaos Castle, Illusion Temple, and Kalima each support server-authoritative tier gating. Every tier (1-8 for BC, 1-7 for DS/CC/Kalima, 1-6 for IT) has eight optional bounds:

Key format: <Event>Tier<N><Min|Max><Level|Reset|GrandReset|MasterReset>. Example: BloodCastleTier3MaxReset = 50.

Sentinel rules#

• -1 on either side of a min/max pair disables that bound. Both at -1 disables the gate entirely (any value passes).
• 0 is a real bound, distinct from -1. MinReset = 0 means "must have at least 0 resets" (always passes); MinReset = -1 means "reset is not checked".
• "Untouched config" = MasterAnyTier = 0 AND every tier of that event has all eight bounds at -1. In that state the engine falls back to vanilla hardcoded brackets, preserving out-of-the-box behavior.

Master class override#

<Event>MasterAnyTier = 1 lets master characters (3rd class, ChangeUp >= 2) bypass all tier bounds for that event and pick whichever tier they want. Use to keep low brackets relevant on high-rate servers where masters would otherwise be locked to the top tier only.

Turning it on also turns off the vanilla brackets for that event (the config is no longer "untouched"). Set the tier bounds as well, or every character can pick any tier.

Per-IP cap#

<Event>PerIpCharCap caps the number of characters from one IP simultaneously inside any tier of that event (the cap is event-wide, not per-tier). 0 disables. Counted by the source IP address of each logged-in character within the event's map range.

Client UI#

When any tier on an event has been touched, the configured bracket table is synced to the client via Game Data Sync opcode 0xEC and used by:

• The Devil Square / Blood Castle entry dialogs (tier list reflects live config, not hardcoded brackets)
• Entry-item tooltips (DS Invitation of the Devil Square, BC Scroll of Archangel, CC Armor of Guardsman, IT Ticket/Cloaks, Kalima Lost Map / Kalima Ticket) - the configured bracket table renders inline in the item tooltip (the same style as the Armor of Guardsman tier table), with the player's qualifying tier highlighted and the required Zen cost shown. This table is synced GameServer to Client; an admin who only edits Event.dat sees the change reflected in-game after the server restarts and clients reconnect

If the event is untouched, the client falls back to its legacy hardcoded brackets.

When an entry is rejected, the client rejection popup states the precise reason - not enough resets, not enough grand resets, not enough master resets, or level out of range - rather than a generic "cannot enter" message. The reason shown is the specific bound the character failed for the tier it attempted.

Example: gate DS Tier 1 to fresh chars under 100 resets#

DevilSquareTier1MinLevel       = 1
DevilSquareTier1MaxLevel       = 199
DevilSquareTier1MinReset       = 0
DevilSquareTier1MaxReset       = 99
DevilSquareTier1MinGrandReset  = -1
DevilSquareTier1MaxGrandReset  = -1
DevilSquareTier1MinMasterReset = -1
DevilSquareTier1MaxMasterReset = -1

Reset bound applies; GR/MR bounds are inactive on this tier.

Cross-File Dependencies#

Common Issues#

• Event enabled but nothing spawns at the scheduled time - the switch here only toggles the feature; schedule and spawn data live in the shared Data/Event/<EventName>.dat file
• Castle Siege never starts - either Common.dat EnableCastleSiege = 0 or CastleSiegeSpecificState set to a non-zero value is pinning the state
• Crywolf penalty punishes everyone after a loss - intended behavior; set CrywolfPenaltySwitch = 0 to disable