Specs: Iron's Spells 'n Spellbooks Addon turns Iron's magic into a discover-and-earn loop. Open the Spell Codex, learn spells from the world, spend XP to unlock tiers, equip them to your action bar, and cast only what you've earned — including schools from Iron's addons.

How it plays

Discover a spell (Codex Page, focus craft, or converting an old scroll/book)
Open the Codex with the Spell Actionbar key (`)
Press + to unlock tiers with XP
Equip a tier onto the action bar and cast from there

Spell Codex

Spell Codex panel: school tabs, spell grid, nine actionbar slots
Schools appear when you discover at least one spell in that school (Fire, Ice, Blood, Ender, and addon schools)
Lots of schools? Tabs stay on one scrollable row (◀ ▶ / mouse wheel)
Equipped spells show their spell icon on the bar and cursor
Creative-only Iron's spells stay hidden from the Codex

Discovering spells

Players start with an empty Codex
Codex Pages — find them in adventure chests (~12%), right-click to learn
School focus + paper — sneak + right-click a focus (e.g. Blaze Rod for Fire) while you have paper: costs 1 focus, 1 paper, and 10 levels of XP for a random page of that school
Leftover Iron's scrolls / spellbooks — right-click to absorb their spells into the Codex (then consumed)

Unlocking & casting

+ unlocks the next tier in order (1 → 2 → 3…)
Default cost: XP for 30 / 40 / 50… levels (20 + 10 × tier)
Hold a matching school focus for a 25% discount on unlock costs
Respec clears unlocks and refunds a share of invested XP (default 25%, configurable)
Casting is actionbar-only — Iron's wheel, spellbooks, inventory scrolls, and swords cannot cast for players
You can only cast tiers you have unlocked

What changed vs vanilla Iron's progression

Spellbook crafting recipes are removed; the Scroll Forge cannot be used
Scrolls and spellbooks no longer drop from loot or mobs, and cannot be tossed into the world
Actionbar scrolls created by the Codex still work for casting
Focus and ink recipes are unchanged

Pack / server tools

JSON under config/specs_irons_spellbooks/ (synced to clients on login):

spell_blacklist.json — hide/block spells by ID
school_unlock_costs.json / spell_unlock_costs.json — retune tier costs
codex_settings.json — respec refund percent
known_spells.json — reference list of spell IDs by school

Admin commands (/specs_codex): lock/unlock schools per player, discover/forget spells, give Codex Pages, list access.

Requirements

Minecraft 1.21.1 / NeoForge
Iron's Spells 'n Spellbooks (tested with 1.21.1-3.16.2) + Iron's Lib
Spell Actionbar 1.0.2+

Author: Specs · Current version: 1.4.0

Spell Codex: Iron's Spells 'n Spellbooks Addon