Encounters

Natural lightning bolts during a thunderstorm may spawn a group of mobs
at the impact point, preceded by a short cinematic.

Options

• Enable toggle
• Trigger chance per bolt
• Group size (min / max)
• Group cohesion — the first mob acts as leader, followers regroup around it when they stray too far
• Mob pool (weighted, with per-entry SNBT and optional label)

Compatibility

• Iron’s Spells ‘n Spellbooks — adds a shockwave at the impact point
• Epic Fight — honors the vanilla generic.scale attribute so scaled mobs render at the correct size
• The default mob pool ships with entries referencing Iron’s Spells, Epic Fight and Simply Swords. Each entry is ignored automatically when the corresponding mod is missing.

Active nether portals in the overworld may suddenly disgorge several
escalating waves of nether mobs, preceded by a short buildup cinematic.

Trigger

• Periodic passive scan around each overworld player (only one invasion may run at a time globally; a configurable cooldown gates the next one)
• Portal frame analysis picks one of the two perpendicular spawn faces; the chosen face must offer a walkable foot row across the full portal width

Cinematic

• The next wave starts only when the current one is fully wiped (with a short grace period to absorb AoE wipes)
• Portal teleportation is disabled for everyone (mobs and players) while an invasion runs, with a brief grace period after it ends

Waves

• Random wave count between configurable min/max
• Linear size progression: firstWaveSize + (n-1) * step
• Rarity bias: later waves shift toward rare entries (capped at 4× base weight, so very-rare mobs never become dominant)

Mobs

• Default roster: Piglin Soldier / Marksman / Shieldbearer, Wither Skeleton, Blaze, Piglin Brute, Hoglin + Piglin Brute (Tusked Vanguard), Hoglin + crossbow Piglin (Crossbow Outrider) and a very rare Ghast
• Hoglins and piglins spawned by the event are immune to vanilla zombification so they don’t morph mid-fight
• Encounter piglins ignore gold-armor pacification — they keep fighting regardless of player gear

Army identity

• All invasion mobs share an allies tag — no friendly fire across goal-driven or brain-driven AI
• Per-wave group cohesion: the first survivor acts as leader, others regroup around it when not in active combat
• Per-wave portal leash: mobs straying too far from the portal are pulled back, unless they’re chasing the player
• One of six curated banner themes (Bloodflag, Skullbearer, Brimstone, Iron Phalanx, Cinder Banner, Hellscar) is rolled per invasion; ~30 % of eligible mobs become banner bearers, with the matching pattern stamped on any vanilla shield they carry. Two parallel invasions look like distinct armies.

Options

• Enable toggle
• Trigger chance per scan
• Scan interval (ticks)
• Portal cooldown after an invasion (ticks)
• Wave count (min / max)
• First wave size and per-wave step
• Group cohesion enable + radius
• Mob pool (weighted, with per-entry SNBT and optional label). Banner eligibility is opt-in per entry via the encounters_banner_eligible entity tag in SNBT.