====== Town Invasions ======

Town Invasions are a recurring PvM event in which a random town is overrun by hostile forces. Defenders must clear waves of Town Invaders and then defeat a Warlord Invader champion to save the town.

===== Schedule =====

Town Invasions run every two hours, daily, at every even hour:

  * 00:00, 02:00, 04:00, 06:00, 08:00, 10:00, 12:00, 14:00, 16:00, 18:00, 20:00, 22:00 (Eastern time).
  * Cadence: every two hours.
  * Event duration: one hour. If the Warlord is not defeated within that window, the event ends without rewards.
  * Only one Town Invasion is active at a time.

===== Eligible Towns =====

When an invasion begins, one of the following towns is chosen at random:

^ Town       ^ Map     ^ Top corner          ^ Bottom corner       ^ Z range   ^ Champion type ^
| Moonglow   | Trammel | (4394, 1058, 30)    | (4481, 1173, 0)     | 0 - 31    | Rikktor       |
| Minoc      | Trammel | (2443, 420, 15)     | (2520, 539, 0)      | 0 - 16    | LordOaks      |
| Delucia    | Trammel | (5171, 3980, 41)    | (5300, 4040, 39)    | 39 - 42   | Mephitis      |
| Cove       | Trammel | (2213, 1144, 0)     | (2277, 1235, 0)     | 0 - 1     | Semidar       |
| Skara Brae | Trammel | (577, 2131, -90)    | (634, 2234, -90)    | 0 - 1     | Serado        |
| Yew        | Trammel | (457, 913, 30)      | (662, 1117, 0)      | 0 - 0     | Barracoon     |
| Jhelom     | Trammel | (1315, 3681, 0)     | (1468, 3845, 0)     | 0 - 1     | Barracoon     |
| Umbra      | Malas   | (1975, 1291, -90)   | (2094, 1399, -90)   | -90 - -89 | Barracoon     |

The town champion type is recorded for the invasion but the final boss is always the Warlord Invader (see "Final stage" below).

===== Faction =====

Each invasion picks one of three invading factions at random: **Human**, **Orc**, or **Undead**. The chosen faction determines the appearance, equipment, and hue of both the trash wave and the Warlord.

===== Invasion Flow =====

==== Start ====

When the event begins:
  - Town guards in the invaded town are disabled for the duration.
  - The trash wave spawns inside the town's bounding area.
  - A server-wide announcement is broadcast: "Town Invasion: //town// is under attack! Defend it!" (orange text). The same message is pushed to Discord.

==== Wave composition ====

Every invasion, regardless of faction, spawns the same wave:

^ Faction ^ Town Invaders ^ Warlord Invaders ^
| Human   | 60            | 4                |
| Orc     | 60            | 4                |
| Undead  | 60            | 4                |

Spawn locations are picked at random inside the town's bounding rectangle. Spawned creatures cannot be tamed.

==== Mob: Town Invader ====

Stats:

  * AI: Mage, targets closest enemy, range 10.
  * Hit points: 3,000 - 3,600.
  * Stats: Str 300, Dex 380, Int 320.
  * Damage: 20 - 30, 100% physical.
  * Resistances: 30 - 50 across all types.
  * Fame 29,000 / Karma -29,000. Virtual armor 60.
  * Guard immune, bard immune, always flagged as a murderer, untamable.
  * Animal Taming and Animal Lore at 220 (cannot be controlled).

Each Town Invader is randomly either a **Mage** or a **Warrior**:

  * **Mages** carry a full "The Dynasty" spellbook plus a complete necromancer spellbook, wear hued leather armor, have Magery, Eval Int, Necromancy, Spirit Speak, Anatomy, Wrestling, Meditation, Poisoning, and Inscription all at 120. They have the **Lightning Force** special ability and cast Magic Arrow (attack) and Heal (defense).
  * **Warriors** wear hued plate, carry one randomly chosen "of Genocide" weapon set (Broadsword + Aegis, Halberd, Katana + Aegis, Bow with 2,000 arrows, or Large Battle Axe), 200 bandages, and have Swords, Fencing, Macing, Archery, Tactics, Anatomy, Healing, Chivalry, Parry, and Magic Resist at 120. They have the **Colossal Blow** special ability.

Faction look:
  * **Orc** invaders wear slime hue and an Orc Mask.
  * **Undead** invaders use hue 0.
  * **Human** invaders use a random skin hue.

==== Mob: Town Invader loot ====

Loot drops only if the invader was not converted or tamed. Base loot is one Super Boss loot pack.

  * **Mage drop**: one random scroll from a pool of 54 Cleric, Bard, Druid, Ranger, and Rogue scroll types, plus Spring Water (5), Destroying Angel (5), and Petrified Wood (5).
  * **Warrior drop**:
    * 30% chance of one dip tub: Armor Piercing, Explosive, Freeze, Lightning, or Poison.
    * 5% chance of one Advanced bow: Advanced Bow, Advanced Composite Bow, Advanced Crossbow, Advanced Elven Composite Longbow, Advanced Heavy Crossbow, Advanced Magical Shortbow, Advanced Repeating Crossbow, or Advanced Yumi.

==== Final stage: Warlord Invader ====

When the last trash-wave invader dies, any stragglers are despawned and a single **Warlord Invader** spawns, matching the chosen faction. A server-wide announcement is broadcast: "A powerful Warlord has arrived to lead the invasion of //town//!"

Warlord stats:

  * AI: Mage, targets closest enemy, range 10.
  * Hit points: 250,000 - 300,000.
  * Stats: Str 3,000, Dex 380, Int 3,200.
  * Damage: 40 - 60, split 50% physical / 25% cold / 25% energy.
  * Resistances: 40 - 60 across all types.
  * Fame 59,000 / Karma -59,000. Virtual armor 80.
  * Guard immune, bard immune, always flagged as a murderer, untamable.
  * Title: "Invader Warlord", "Orcish Invader Warlord", or "Undead Invader Warlord" by faction.
  * Always moves at running speed.

The Warlord is randomly either a **Mage** or a **Warrior**:

  * **Mages** use Mage or Necro-Mage AI. They carry "The Great Genocide" spellbook and a full necromancer spellbook, wear hued leather with a wizard's hat (or orc mask for the Orc faction). Spell attacks: Magic Arrow, Weaken, Fireball, Lightning, Mind Blast, Energy Bolt, Flame Strike. Spell defenses: Wall of Stone, Heal, Cure. Skills: Magery, Eval Int, Anatomy, Wrestling, Meditation, Poisoning, Inscription at 120; Necromancy and Spirit Speak at 220.
  * **Warriors** use Melee AI with the **Colossal Rage** special ability and the **Essence of Disease** area effect. They carry one of five "of Genocide" weapon sets (Broadsword + Aegis, Halberd, Katana + Aegis, Bow with 2,000 arrows, or Large Battle Axe), 200 bandages, and plate armor with a plate helm (or orc mask for the Orc faction). Skills: Swords, Fencing, Macing, Archery, Tactics, Anatomy, Healing, Chivalry, Parry, and Magic Resist all at 120.

Both profiles have Animal Taming and Animal Lore at 120.

The Warlord rides a Nightmare-based mount named "A Warlord's Distressed Mount". The mount's appearance is reassigned by faction:

^ Faction ^ Possible mount appearances ^
| Human   | 50% chance to be reassigned to one of: Nightmare, Tiger, Gorilla, Dreadhorn, Ophidian Mage, St Bernard, Sty Drake, Emu Bird. Otherwise standard nightmare. |
| Orc     | One of: Windrunner, War Boar, Gaman, Rune Beetle, Tarantula. |
| Undead  | One of: Tamable Ancient Hound, Bake Kitsune, Lasher. |

==== Warlord defensive behaviour ====

  * Base loot pack: one Super Boss loot pack.
  * On death, the Warlord triggers a **Hell Explode** effect at the corpse location.
  * Spell retaliation: 2% chance per incoming spell hit (within range 10) to retaliate with a **Hell Wave Attack** (49 - 80 damage) against the caster.
  * Player damage to the Warlord is tracked toward reward distribution.
  * On death, a 20% roll drops one of six custom-class spellbooks into the corpse: Cleric, Bard, Druid, Ranger, Rogue, or Archmage Spellbook.

===== Scoring and Rewards =====

==== Kill tracking ====

Each Town Invader or Warlord Invader you kill is credited to your personal kill count. After each kill you'll see "Town Invasion Kill Count: N". The current top scorer is the **Winner**; every tenth kill the leader scores triggers a town-wide announcement: "//name// is defending //town// with //N// kill(s)!"

==== Boss damage tracking ====

Once the Warlord spawns, all damage you deal to it is summed for participation rewards. Your share of total boss damage scales your boss damage bonus.

==== Reward distribution ====

After the Warlord dies, every participant earns PvM points:

^ Reward ^ PvM Points ^
| Base participation                        | 200 |
| Per Town Invader or Warlord kill          | +50 |
| Boss damage bonus (scaled by your share)  | up to +300 |
| Winner bonus (top kill count)             | +200 |

Rewarded players receive: "Town Invasion: You've received //N// PvM points for defending //town//!" The Winner is announced server-wide: "Town Invasion: //name// led the defense of //town//!"

If the one-hour duration expires before the Warlord is killed, rewards are **not** distributed.

===== End of Event =====

When the event ends (Warlord defeated or one-hour timer expires):
  - All remaining invasion mobs are removed. Controlled or bonded creatures (e.g. bio-pets) are left in place.
  - Town guards are re-enabled.
  - The town's status returns to "Everything is looking fine at the moment.  Travel safe."

==== Discord integration ====

Invasion announcements are also posted to a Discord webhook.

==== Lore NPC ====

The **Invasion Announcer** is a blessed, root-bound, Lich-based NPC titled "the Neighborhood Watch". It speaks the current invasion status to nearby players (within 3 tiles) and responds to the "news" keyword. Its message updates automatically when an invasion starts and ends.

===== See Also =====

  * [[event-schedule|Event Schedule]]
  * [[champ-bash|Champ Bash]]
  * [[hell-gate|Hell Gate]]
  * [[gameplay-rewards|Gameplay Rewards]]