📜 Spell Atlas

The ultimate companion for Iron's Spells 'n Spellbooks! Discover spells, unlock spell mastery, execute 30+ elemental combos, battle Nemeses & Anomalies, summon familiars, and earn perks.

Transform your journey as a mage with Spell Atlas! Every time you cast a spell, it is automatically logged into a personal, interactive journal accessible right from your inventory.

Functioning as both a comprehensive guide and a deep RPG progression system, Spell Atlas automatically detects every spell and magic school from Iron's Spells 'n Spellbooks alongside any installed addon at runtime no manual setup or configuration required.

Supports Minecraft 1.21.1 (NeoForge) and 1.20.1 (Forge).

📖 The Atlas (Your In-Game Journal)

• Automatic Discovery: Spells are revealed as you cast them from spellbooks, scrolls, or weapons with a satisfying toast notification. Search filters only show discovered spells to keep your exploration spoiler-free!

• Detailed Spell Cards: View spell levels, mana costs, cooldowns, mastery ranks, one-click JEI/EMI recipes, personal notes, and a combat usage record.

• My Spellbook & Real-Time Stats: Inspect your equipped spells alongside exact stats (mana, spell power, cooldown reduction, school affinities) calculated after all equipment and effect bonuses.

• Beginner-Friendly Guide: Packed with tutorials for mechanics (Scroll Forge, Arcane Anvil, Runes), a dedicated page for every magic school, 30+ ready-made player builds, and one-time chat tips.

• Bestiary & Rumours: Track magic mobs as your server encounters them (3D models, drops, spell lists) and follow vague rumours to discover missing spells.

• Unified Settings Hub: Manage keybindings, HUD options, slot positions, and settings for Artificer's Almanac and Tempest Almanac in one centralized menu.

🎓 Mage Progression & Elemental Mastery

• Spell Mastery & Perks: Rank up spells from I to III by casting them in combat. Each rank grants a extra spell level and your choice of perk: Power, Thrift, or Haste.

• 32+ School Reactions: Hit enemies with two magic schools in quick succession to unleash devastating elemental combos! (e.g., Fire + Ice = Thermal Shock, Fire + Lightning = Overload). Fully compatible with addon magic schools.

• School Affinity & Familiars: Align with magic schools to unlock lower mana costs, shorter cooldowns, and higher spell power. At 25% affinity, summon a 3D animated Spirit Familiar that fights alongside you and evolves through four tiers!

• Mage Titles: Earn vanity titles (Apprentice, Archmage, Grandmaster, Monster Hunter, etc.) that appear before your name and provide small stat boosts.

🛍️ Arcane Points & The Perk Shop

• Earn Arcane Points: Gain points by discovering spells, completing challenges, executing school reactions, or defeating bosses and elites.

• 36 Unlockable Perks: Spend points in the Perk Shop across 5 categories (Attack, Defense, Summons, Mana, Utility) and 5 rarity tiers.

• Cosmetics: Unlock custom title colors, spellcasting particle trails, and cover color tints for your atlas—purely visual with zero combat impact.

⚔️ World Events, Bosses & Challenges

• Daily & Weekly Quests: Server-wide challenges rewarding loot, experience, and Arcane Points.

• Anomalies: Magical rifts torn in the world that trigger wave-based mob defenses guarded by powerful rift entities.

• Nemesis System: Mobs that kill you become named, ranked bosses with customized lairs that ambush you until you track them down for revenge.

• Safe Mage Duels: Challenge players to 1v1 duels right from your inventory. Duels end at 1 HP with no risk of item loss, featuring an integrated Elo ranking system.

🎒 Modpack Progression Goals

The Pack tab adds built-in achievement goals for installed adventure and structure mods:

• Defeat bosses from Twilight Forest, The Aether, L_Ender's Cataclysm, Alex's Caves, and Deeper and Darker.

• Loot dungeons from YUNG's Series, Terralith, and Repurposed Structures.

• Unlocking goals grants Arcane Points, experience, essences, and rare ink!

🔌 Requirements & Compatibility

• Required: Minecraft 1.21.1 (NeoForge 21.1.250+) OR 1.20.1 (Forge) + Iron's Spells 'n Spellbooks 3.16+. Must be installed on both client and server.

Deep Optional Integrations:

• 🪄 Iron's Addons: Native support for Cataclysm Spellbooks, T.O. Magic, Hazennstuff, Elden Ring Spells, Leylines, Pact Arcana, and more!

• 🛠️ Artificer's Almanac: Merges seamlessly into a single unified book system, sharing titles, perks, challenge goals, and staff crafting materials.

• 📜 JEI / EMI / Apotheosis / Curios / Accessories: Direct recipe lookups, affix attribution in stat sheets, and accessory slot bonuses.

• 🗺️ Xaero's & JourneyMap: Automatic waypoints generated for Nemesis Lairs and Anomalies.

• 📜 FTB Quests & Bountiful: Fully compatible advancement triggers (spell_atlas:discover, mastery, kill, nemesis_defeated).

🔧 For Server Owners & Modpack Creators

• Validation Tools: Run /spellatlas validate to check installed addons, data pack errors, and goals.

• Datapack Driven: Easily customize school reactions, gear set bonuses, custom guide pages, and loot tables (spell_atlas:rewards/*).

• KubeJS & FTB Integration: Exposes custom advancement triggers, event hooks, and public API queries for seamless modpack scripting.

📝 Notes & Permissions

• AI Disclosure: Spell Atlas was developed with the assistance of AI tools.

• Modpacks: You are free to include Spell Atlas in any free modpack hosted on CurseForge or Modrinth!
  
  Found a bug or have a suggestion? Report it on [GitHub](https://github.com/SolJodowana/mods-issues-and-suggestions/issues)