Invasions

Scheduled monster invasions across the world. Each invasion is its own self-contained XML file under Data/Event/Invasions/. Up to 30 invasions are supported.

The legacy InvasionManager.dat file is no longer read. Every invasion now has its own schedule, message strings, spawn map groups, and monster table inside one XML.

File Location#

Data/Event/Invasions/<NNN> - <Name>.xml

The 3-digit NNN prefix is the stable numeric index used by ForceStart, the /invasion console command, and EventTimerSlot binding. Anything after - is decorative and ignored by the loader. Inside the XML, <General Name="..."/> is the human-readable label.

Loaded once at GameServer startup. Gated by Event.dat InvasionManagerSwitch. Use the in-server GUI Reload action (or restart) to re-scan the folder after edits.

Default invasions shipped#

Add a new invasion by dropping in <NNN> - <whatever>.xml with a free NNN (0-29).

XML Layout#

<?xml version="1.0" encoding="utf-8"?>
<Invasion>
  <General .../>
  <Messages>...</Messages>
  <Schedule>...</Schedule>
  <MapGroups>...</MapGroups>
  <Monsters>...</Monsters>
</Invasion>

<General> attributes#

<Messages>#

Optional chat / center-screen strings. Empty children are silent.

<Schedule>#

Each <Entry> is one calendar firing time. Multiple entries = multiple firings per day. Wildcard * matches any value.

<Entry Year="*" Month="*" Day="*" DoW="*" Hour="0"  Min="50" Sec="0" />
<Entry Year="*" Month="*" Day="*" DoW="*" Hour="12" Min="50" Sec="0" />

Attributes: Year, Month, Day, DoW (day of week, 0-6), Hour, Min, Sec. All accept * for "any".

<MapGroups>#

Spawn-anchor rectangles. The runtime picks one <Group> row per matching Index/SubIndex pair when the invasion fires and uses that rectangle to position monsters.

<Group Index="0" SubIndex="0" Map="0" X1="10" Y1="10" X2="240" Y2="240"/>
<Group Index="0" SubIndex="1" Map="2" X1="10" Y1="10" X2="240" Y2="240"/>
<Group Index="0" SubIndex="2" Map="3" X1="10" Y1="10" X2="240" Y2="240"/>

<Monsters>#

Per-group spawn definitions. Every matching <Monster> row spawns Count instances of MonsterClass.

<Monster GroupIndex="0" SubIndex="0" MonsterClass="135" Range="30" Count="1"
         Boss="1" RegenType="0" RegenTimeSec="0" ItemBag="27" MinUsersToSpawn="-1"/>

Runtime hooks#

• GUI: GameServer's invasion panel exposes Start / Reload / state inspection per invasion.
• GS console: /invasion start <NNN> and /invasion start <name> force-fire bypass schedule + online gate.
• EventTimerInfo: invasions with EventTimerSlot >= 0 broadcast remaining time / state to the client tooltip system. See EventTimerInfo.xml.
• HUD: active invasion state is mirrored to a dedicated client HUD. The HUD lists up to 16 concurrent event rows per page; with more than 16 active at once the extra rows are not shown.

Cross-File Dependencies#

Common Issues#

• Invasion never triggers - InvasionManagerSwitch = 0 in Event.dat; or all <Schedule> entries have past times for the day; or MinOnlineUsers not met
• Monsters do not spawn - <Monster> SubIndex does not match the <Group SubIndex> randomly chosen this cycle; or MapGroups rectangle lands on non-walkable tiles
• Boss spawns but no announcement - <BossKilled> element empty, or EventTimerSlot not configured for HUD readback
• Invasion ends too early on a boss kill - BossEndPolicy="First" ends on any boss death. "All" ends on the last boss death - with only one boss spawned it behaves identically to "First" (the only kill is the last kill). Use "Never" to let the event run until the timer or all monsters (trash + bosses) are dead, regardless of boss kills
• Monsters keep respawning mid-invasion - RegenType != 0; set to 0 for single-wave behavior
• Two invasions at the same time - intended when distinct files have overlapping schedule entries. Use different <Schedule> times to sequence
• Edits ignored after Reload - file lacks <Invasion> root, or NNN prefix collides with another file (loader keeps first, logs the rest)