Ars ↔ Iron Mana Bridge (Forge 1.20.1 + NeoForge 1.21.1)

Bridge Ars Nouveau mana and Iron's Spells 'n Spellbooks mana so they behave like a shared pool.

This is a lightweight compatibility mod designed for modpacks and servers that want one mana economy across both spell systems.

---

✨ Features

• Shared mana pool behavior between Ars Nouveau and Iron’s Spells
• Server config to pick how syncing works and how regen is handled
• Designed to be pack-friendly: avoids invasive patches and sticks to official events/attributes

---

🔧 How it Works (High-Level)

• Mirrors Iron → Ars using Iron’s mana change event
• Mirrors Ars → Iron on a server-side player tick (configurable interval)
• Uses Ars Nouveau’s Max Mana and Mana Regen calc events to handle max/regen policy without patching either mod

---

🧠 Sync Modes

Config file: config/ars_iron_mana_bridge-server.toml

mode = FRACTION (default, recommended)

Shares mana percentage between systems:

• Spending or gaining mana in either mod updates the other to the same % full of its own max.
• No max-mana overrides needed.

mode = ABSOLUTE_USE_ARS

Ars mana becomes the “source of truth”:

• Iron mana is forced to match Ars mana 1:1
• Optional: align_max_mana can temporarily adjust Iron’s MAX_MANA attribute so Iron max ≈ Ars max

mode = ABSOLUTE_USE_IRON

Iron mana becomes the “source of truth”:

• Ars mana is forced to match Iron mana 1:1
• Ars max mana is overridden via Ars Nouveau’s max-mana calc event to match Iron’s max mana attribute

---

♻️ Regen Policy

regen_policy = BOTH (default)

Both mods’ regen systems remain active (effects may stack).

regen_policy = ARS_ONLY

• Ars regen stays active
• Iron mana regen attribute is neutralized via a transient attribute modifier

regen_policy = IRON_ONLY

• Iron regen stays active
• Ars mana regen calc event is set to 0

regen_policy = NONE

Disables both regen systems (not recommended unless you provide regen elsewhere).

---

⚙️ Configuration Options

All options are in config/ars_iron_mana_bridge-server.toml:

• enabled (boolean) — Master toggle
• mode (enum) — FRACTION, ABSOLUTE_USE_ARS, ABSOLUTE_USE_IRON
• regen_policy (enum) — BOTH, ARS_ONLY, IRON_ONLY, NONE
• align_max_mana (boolean) — Align max mana in ABSOLUTE modes (see notes in config)
• sync_interval_ticks (int, 1–20) — How often to sync Ars → Iron (1 = every tick)
• epsilon (double) — Minimum difference before writing values (reduces tiny oscillations)
• debug_log (boolean) — Enables extra logging (spammy)

---

✅ Requirements

• Minecraft 1.20.1 or 1.21.1
• Forge 47.1.0+ or NeoForge 21..1.210+
• Ars Nouveau 4.12.7+ or 5.11.2+
• Iron’s Spells ’n Spellbooks 3.15.3+

---

🧩 Compatibility Notes

• Intended to be safe alongside most addons for Ars and Iron’s Spells.
• If another mod heavily rewrites mana behavior, you may want to use mode = FRACTION for the least-invasive option.

---

🐛 Issues / Feature Requests

If you hit a desync, weird regen stacking, or max-mana mismatch, please include:

• Your ars_iron_mana_bridge-server.toml
• Mod versions
• Steps to reproduce
• Logs (especially if debug_log = true)

---

📜 License

All Rights Reserved

---

❤️ Credits

• Ars Nouveau
• Iron’s Spells ’n Spellbooks