Tri Mana Bridge (Forge 1.20.1)

Tri Mana Bridge unifies mana across multiple magic mods so your mana behaves like a shared pool.

Supported (as installed):

• Mahou Tsukai
• Mana and Artifice
• Primal Magick

Optional (if installed) to form a larger “mana network”:

• Ars Nouveau
• Iron’s Spells ’n Spellbooks
• Plays nicely with Ars ↔ Iron Mana Bridge (avoids double-writing)

---

✨ What it does

When you spend or gain mana in one mod, this mod automatically syncs the other active mana pools to match.

Examples:

• Cast a Mahou spell → MNA + Primal (and optionally Ars/Iron) update to reflect the same pool state.
• Recharge in MNA → Mahou + Primal (and optionally Ars/Iron) refill accordingly.
• Carry a Primal Magick mana container (wand/staff/battery) → it rises/falls with your unified mana.

No items. No commands. No UI changes. Just automatic synchronization.

---

🔧 Sync Behavior

syncMode = PERCENT (default, recommended)

All active pools are kept at the same % full of their own max.

This preserves each mod’s progression/max-mana scaling while still feeling like “one pool”.

syncMode = ABSOLUTE

All active pools are forced to the same raw amount (clamped to each pool’s max).

---

🧩 Mod-specific notes

Mahou Tsukai

• Syncs your player Mahou mana capability.

Mana and Artifice

• Syncs your current casting resource.
• Optionally only participates when the casting resource is Mana or Council Mana (config).

Primal Magick

• Syncs mana stored on an item that exposes Primal Magick mana storage (wand/staff/battery/etc).
• By default only participates when you’re holding a valid mana-storage item.
• Can optionally scan your inventory.
• You can choose which Primal Sources are included (earth/sea/sky/sun/moon/etc).
• When writing back, it can preserve your per-source ratios (default) or distribute evenly.

Ars ↔ Iron Bridge compatibility

If Ars ↔ Iron Mana Bridge is installed and both Ars + Iron are present, Tri Mana Bridge will sync to only the authoritative side (Ars or Iron) to prevent tug-of-war.

---

⚙️ Configuration

Server config file: config/tri_mana_bridge-server.toml

Notable options:

• enabled
• syncMode = PERCENT or ABSOLUTE
• Enable/disable per-mod integration
• MNA “only if casting resource is mana”
• Primal “only if holding mana container”
• Primal Sources list + ratio behavior
• Debug logging

---

✅ Requirements

• Minecraft 1.20.1
• Forge 47.x
• Any combination of the supported mods:
  • Mahou Tsukai
  • Mana and Artifice
  • Primal Magick
  • (Optional) Ars Nouveau
  • (Optional) Iron’s Spells ’n Spellbooks

---

🐛 Troubleshooting

If you see odd behavior (bars not matching, Primal mana not syncing, etc.), include:

• Your tri_mana_bridge-server.toml
• Mod list + versions
• Which mana pools you expected to sync (Mahou/MNA/Primal/Ars/Iron)
• Logs (enable debug logging if needed)

---

📜 License

All Rights Reserved