The Siege Overhaul

Faction Raids v2.30.0 — Bridge Sieges

When another Recruits faction begins sieging a Recruits claim owned by

your Faction Raids team, a full Faction Raids raid now spawns at the

same claim. The Recruits siege continues to run its own health and

timer system in parallel — you get the wave-based combat scenario,

war camp, siege engines, faction banners, and victory rewards on top

of the Recruits army that is already at your gates.

Narrative: "The Recruits army is already at your walls. Now their

reinforcements pour in from the woods."

NEW

- RecruitsSiegeBridge: reflection-only subscriber to Recruits'

  SiegeEvent.Start. Zero compile-time dependency on Recruits —

  Faction Raids still loads clean without it. Subscription is deferred

  to ServerStartedEvent so Recruits' classes are fully loaded before

  we probe.

- Public raid trigger API: RaidEvents.tryTriggerRaidForTeam(level,

  teamKey, center). Idempotent — dedupes on active raid, requires an

  FR anchor whose teamKey matches the Recruits owner faction id,

  requires online defenders, and places the raid at the anchor

  defense point closest to the claim center so the FR raid

  materializes right where the Recruits army already is.

- New config: bridgeSiegesEnabled (default true). Also gated by

  Recruits presence, so disabling Recruits automatically no-ops the

  bridge with a single info log.

BEHAVIOR

- Both systems run in parallel by design. Faction Raids does NOT

  cancel the Recruits siege.

- Faction Raids does NOT modify Recruits' siege damage tick.

- Faction Raids does NOT subscribe to SiegeEvent.Success — Recruits'

  claim ownership swap is Recruits' business.

FAIL-SAFE

- Bootstrap failure (missing class, method rename) disables the

  bridge silently with an info log.

- Runtime failure disables the bridge for the session with a single

  warn log. No cascading errors.

COMPATIBILITY

- Fully backward compatible with 2.29.0 saves.

- No-op when Recruits is not installed.

- Requires Minecraft 1.20.1, Forge 47.2+.

- GPL-3.0-only. Faction Raids is a trademarked name. Participates in

  the CurseForge Rewards Program. Tips welcome on Ko-fi.