🌀 Unified Mana

One unified mana pool for every supported magic mod, displayed on a single vanilla-style HUD bar!

Unified Mana replaces separate mana pools with a unified system: Unified Mana Points (UMP). Spells cast from any supported mod draw from the same shared pool, regeneration fills it seamlessly, and native HUD bars are automatically hidden.

Supports Minecraft 1.21.1 (NeoForge).

⚠️ Early Release Note (v0.5.0): Features a fully functional shared pool, native HUD integration, and bridges for Ars Nouveau and Iron's Spells 'n Spellbooks. More mod bridges are currently in development!

📖 Key Features & Mechanics

• One Shared Pool (UMP): Cast an Ars Nouveau glyph spell, then an Iron's Spells spell — both draw directly from your unified UMP pool.
• Vanilla-Style Split HUD: A clean split bar aligned with the vanilla XP strip, keeping your level number perfectly visible. Features a smooth left-to-right fill animation, low-mana pulse, and full-pool flash.
• Compact Numeric Window: Displays current / max in a framed window next to the bar (configurable to LEFT or RIGHT side).
• Smart Bridge Management: Native bars are hidden only when an active bridge is detected. Unsupported mods keep their default resources untouched.
• No Double Accounting: Mana costs and regeneration rates are calculated once from the shared pool.
• Server-Authoritative Sync: Server manages balance policy and syncs data to clients for seamless multiplayer compatibility.

⚙️ How Conversion & Scaling Works

• Dynamic Capacity: Each supported mod contributes its native maximum to your UMP total via configurable conversion rates.
  • Default Rates: Ars Nouveau = 1.5 UMP per point | Iron's Spells = 2.0 UMP per point.
• Global Cap: Pool total is capped at 5,000 UMP by default (fully customizable).

🔌 Requirements & Mod Compatibility

📌 Requirements

• Minecraft 1.21.1 (Client & Server)
• NeoForge 21.1.265+ (Java 21 required)

📚 Same Author Mods & Ecosystem

• Spell's Atlas — Unified settings hub, stat integration, and spell history logging.
• Quintessence: Elemental Spellcraft & Runes — Native integration with pentagram spells and mana wells.
• Player System — Shared mana pool compatibility for System skill consumption.
• Artificer's Almanac — Power modular staffs and Manalite cells through unified UMP.

🧩 Active Mod Bridges (Tested Versions)

• Iron's Spells 'n Spellbooks (v3.16.3+)
• Ars Nouveau (v5.13.4+)

🔮 Planned Mod Bridges

• Arcanum Unbound
• Botania Revived
• Mahou Tsukai
• Dragon Survival

🔧 For Server Owners & Modpack Creators

• Flexible Configs:
  • unifiedmana-common.toml: Set global caps, conversion ratios, regeneration switches, and sync thresholds.
  • unifiedmana-client.toml: Customize HUD visibility, numbers, side offset, and native bar hiding.
• Developer API: Includes a compact server API (UnifiedManaAPI, ManaSourceProvider) allowing addon authors to register custom mana sources and spend UMP.

📝 Notes & Permissions

• AI Disclosure: Created with the assistance of AI tools.
• Modpacks: Free to include in any modpack hosted on CurseForge or Modrinth!

Found a bug or have a suggestion? Report it on GitHub.