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

❤️ Credits

Ars Nouveau
Iron’s Spells ’n Spellbooks

Ars ↔ Iron Mana Bridge