⚔️ MoxWars — Epic Towny Siege & Warfare

Summary for Modrinth:

Dynamic siege wars for Towny: assault TNT, territory capture flags, sieges & spoils of war!

---

⚔️ MoxWars — Dynamic Towny Siege Warfare

MoxWars is an action-packed, balanced, and competitive town siege & war system designed for Towny servers on Paper / Purpur 1.21+. Say goodbye to boring immortal claims — decide the fate of nations through explosive sieges, tactical flag captures, territory annexations, and war reparations!

---

💥 Key Features

⏳ 1. Three-Phase War Lifecycle

1. Preparation Phase (30 min / 15 min for Total War):
   • Global animated BossBar countdown for all players on the server.
   • On-screen titles, combat sound effects, and chat war declarations.
   • Time to gather munitions, fortify walls, and organize squad defense.
2. Active War Phase (60 min):
   • PvP enabled between belligerent towns/nations.
   • Assault TNT ignores Towny claim protections to breach fortifications.
   • Plant Capture Flags on enemy territory to claim land in real-time.
3. Outcome Selection Phase (/war end):
   • The victorious mayor opens an interactive GUI to dictate the terms of peace!

---

👑 2. Strategic War Outcomes & Spoils (Outcome System)

• 🗡️ If the Attacker Wins:

  • Full Annexation: Seize 100% of all enemy town chunks into your own town.
  • Partition (50% Land & 50% Bank): Annex half of the enemy territory and drain half their treasury.
  • War Reparations: Plunder 100% of the enemy town treasury while leaving their land borders intact.

• 🛡️ If the Defenders Repel the Invasion:

  • White Peace: Grants a mutual 12-hour immunity shield and non-aggression pact.
  • Counter-Offensive: Immediately declares an instant retaliation war with the defender as the new attacker.
  • Total War (Revenge Mode): High-stakes revenge war with reduced prep time and double-or-nothing consequences!

---

🧨 3. Custom Siege Arsenal (/warfare)

• 🧨 Assault TNT:
  • Engineered specifically for wall breaching.
  • Auto-primes upon placement during active war.
  • Instant 2-second detonation fuse.
  • Bypasses Towny claim protection to blast through defensive gates and ramparts.
• 🚩 Territory Capture Flag:
  • Plant on enemy chunks to begin annexation.
  • Features a dynamic 3D countdown hologram (Capture in: {time}s).
  • Defenders can dismantle the flag with a simple click to thwart the capture.
  • Capital Conquest: Planting and securing the flag on the enemy Home Block instantly conquers the entire town!

---

💰 4. Scalable War Economy & Era Scaling

• Dynamic War Declaration Formula: $$\text{War Cost} = \text{Base Price} + (1000 \times \text{Town Chunks} \times \text{Era})$$
• MoxCenturies Integration: War costs and siege scales dynamically adjust based on historical ages and technological progression.
• 🕊️ Neutrality Pacts: Towns can purchase 24-hour non-aggression treaties through Vault economy.

---

📋 Commands & Permissions

Command	Aliases	Description	Permission
/war	/town war, /t war	Main war management & target selection GUI	moxwars.use
/warfare	/town warfare, /t warfare	Military arms dealer GUI (Assault TNT, Flags)	moxwars.use
/war end	—	Open victorious spoils & outcome selection menu	moxwars.use

---

📦 Requirements & Installation

1. Place MoxWars.jar into your server's plugins/ directory.
2. Required plugins:
   • Paper / Purpur 1.21+ (Java 21)
   • Towny Advanced
   • Vault + Economy plugin (EssentialsX, etc.)
3. (Optional) MoxCenturies for era-based price multipliers.
4. Restart your server. Configure timers and pricing in plugins/MoxWars/config.yml.