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.