Spell Codex

Changelog

Every CurseForge file, newest first.

1. 1.6.6

   Sep 17, 2026

   MC 1.21.1

   [Changelog - v1.6.6]

   Requires Spell Actionbar 1.1.5+.

   Fixed

   • Compatibility with Apprentice's Codex block-targeting spells — looking at a block while casting from the actionbar or imbued keybind no longer fails with "Target a block."
   • known_spells.json now groups spells by each spell's real school (no longer dumps everything under Evocation)

   Changed

   • Config JSON files are plain data only — guides and examples live in config/specs_irons_spellbooks/CONFIG_GUIDE.md

   File on CurseForge

2. 1.6.5

   Aug 22, 2026

   MC 1.21.1

   [Changelog - v1.6.5]

   Added

   • allowImbuedWeaponCasting in codex_settings.json (default true) — cast spells imbued on held weapons
   • Dedicated Cast Imbued Spell keybind (default R)
   • HUD slot left of the actionbar for the imbued spell (moves/scales with the actionbar; included in Edit HUD drag bounds)
   • Imbued casts do not require Codex discovery or tier unlock (spell blacklist still applies)

   Fixed

   • Server crash on startup when another mod's recipe returns a null result (e.g. packs with Stellaris) while Specs strips Iron's scroll crafts

   File on CurseForge

3. 1.6.4

   Aug 13, 2026

   MC 1.21.1

   [Changelog - v1.6.4]

   Added

   • Spell inspector on the left of the Codex — empty portrait until you click a spell, then icon plus name, tier, school, rarity, mana, cast time, cooldown, unique stats, and guide text

   Changed

   • Edit HUD scale controls are a compact top-left column (label above each − / value / + row) instead of three wide bottom bars

   File on CurseForge

4. 1.6.3

   Aug 8, 2026

   MC 1.21.1

   [Changelog - v1.6.3]

   Requires Spell Actionbar 1.1.4+.

   Added

   • Independent HUD editing — actionbar, mana bar, and cast bar each drag separately in Edit HUD
   • Per-element scale controls (− / +) for actionbar, mana, and cast bar (0.75–1.25)
   • Cast bar scale in Specs client config (castBarScale)

   Changed

   • Requires Spell Actionbar 1.1.4+ (independent mana offsets/scales + mana display modes)

   File on CurseForge

5. 1.6.2

   Aug 4, 2026

   MC 1.21.1

   [Changelog - v1.6.2]

   In-Codex Guide, discovery progress bars, and UI polish.

   Added

   • Discovery progress bars under the Codex (selected school left, overall right), with tooltips for counts and unlocked tiers
   • In-Codex Guide (? outside the frame)
   • Guide covers open / discover / unlock / equip / cast / spellbooks / progress & HUD

   Fixed

   • Corrupted UTF-8 punctuation in lang strings (discovery announcements and related tooltips)
   • Guide body line breaks (literal \n / {br} handling)

   File on CurseForge

6. 1.6.1b

   Aug 3, 2026

   MC 1.21.1

   Changelog - v1.6.1b
   
   Changed:
   - updated HUD

   File on CurseForge

7. 1.6.1

   Jul 30, 2026

   MC 1.21.1

   [Changelog - v1.6.1]

   Spellbooks follow Iron's again; scrolls become Codex pages in the world and in the Alchemist Cauldron.

   Changed

   • Spellbooks drop, craft, and can be tossed as Iron's intends
   • Iron's scroll loot/drops (and leftover scroll item entities) convert into Codex pages for the same spell
   • Alchemist Cauldron recycles Codex pages into ink fluid (same water cost and recycle chance as Iron's scrolls)
   • Only Iron's scroll crafting recipes remain removed

   File on CurseForge

8. 1.6.0

   Jul 29, 2026

   MC 1.21.1

   Changelog - v1.6.0

   Added

   • HUD edit mode — Codex Edit HUD button; drag the linked actionbar+mana group and a separate cast/charge bar
   • Specs-owned cast/charge bar with client offsets (specs_irons_spellbooks-client.toml)
   • Empty spellbooks expand the actionbar — equip an empty Curios spellbook for that book’s slot capacity (default 3 with no book)
   • Shift + right-click a filled spellbook to discover its spells in the Codex and clear them from the book (book kept)
   • Codex actionbar scrolls horizontally (◀ ▶ / mouse wheel) when the row is wider than the panel
   • Dynamic actionbar tray — no fixed painted wells; tray and slots scale to the live slot count
   • school_blacklist.json — blocked schools stay out of the Codex/casting/imprint; /specs_codex school cannot lock or unlock them

   Changed

   • Requires Spell Actionbar 1.1.2+
   • Filled spellbooks cannot be equipped until emptied
   • Codex actionbar uses dynamic visible slot count; syncs while editing
   • Inaccessible scrolls are voided when the bar shrinks
   • Cast unlock checks use inscribed base level, so affinity/book bonuses (e.g. Necronomicon +2) no longer block unlocked tiers
   • Codex ink slots stay visible while choosing a spell tier
   • Iron's cast/charge bar is drawn by Specs so it can be repositioned

   Fixed

   • HUD edit screen uses a flat dim (no vanilla blur) so labels and HUD stay sharp
   • Edit HUD sits below the Codex frame (right), so it no longer overlaps tier buttons
   • Codex equip-slot spell icons are inset 1px right/down to sit in the slot wells

   Removed

   • Right-click no longer destroys the entire spellbook to discover its spells

   File on CurseForge

9. 1.5.1

   Jul 29, 2026

   MC 1.21.1

   Changelog - v1.5.1

   Optional Codex inclusion for Iron's creative-only spells.

   Added

   • includeCreativeSpells in codex_settings.json — when true, Iron's creative-only spells (AllowCrafting = false, e.g. Fang Swirl / Raise Hell) can appear in the Codex (default false)

   File on CurseForge

10. 1.5.0

    Jul 27, 2026

    MC 1.21.1

    Changelog - v1.5.0

    Empty Codex Pages and Scroll Forge imprint; rarity-gated discovery.

    Added

    • Empty Codex Page — combine paper + any Iron's ink in an Arcane Anvil; stores that ink rarity
    • Scroll Forge imprint — hold a school focus and Empty Codex Page, use the forge (costs 10 XP levels)
    • Imprints only undiscovered school spells whose tier-1 ink rarity is at or below the blank’s attunement
    • Per-rarity Empty Codex textures (band color by ink) and a new Codex Page scroll icon

    Changed

    • Removed sneak-use focus + paper craft-anywhere; Scroll Forge is the imprint station (Iron’s scroll crafting stays disabled)
    • Empty Codex Pages are made at the Arcane Anvil

    Fixed

    • Usable school focuses no longer activate when imprinting at the Scroll Forge

    File on CurseForge

11. 1.4.10

    Jul 27, 2026

    MC 1.21.1

    Changelog - v1.4.10

    Tier unlocks require matching Iron's ink; Codex ink slots under the frame.

    Added

    • Ink-gated tier unlocks — next Codex tier costs full XP and one matching rarity ink
    • Codex ink slots under the frame — select a rarity to enable eligible + unlocks and dim mismatched spells
    • Focus 25% XP discount still applies to the level cost only; creative mode skips ink

    Fixed

    • Ink counts in the Codex update immediately after an unlock

    File on CurseForge

12. 1.4.4

    Jul 26, 2026

    MC 1.21.1

    Changelog - v1.4.4

    Clearer config examples using // comments; auto-fix quoted cost strings.

    Changed

    • Codex config files now use // comment headers with real nested JSON examples (no escaped quotes)
    • Cost entries mistakenly saved as quoted JSON strings are auto-converted to nested objects on load

    File on CurseForge

13. 1.4.3

    Jul 25, 2026

    MC 1.21.1

    Changelog - v1.4.3

    Changed

    • New Codex Page item icon

    File on CurseForge

14. 1.4.2

    Jul 25, 2026

    MC 1.21.1

    Changelog - v1.4.2

    Config file readme help for XP costs and related settings.

    Added

    • In-file _readme help text in generated Codex configs explaining XP cost units, defaults, priority, and how to edit them
    • Existing configs without _readme get the help text injected on the next server load

    File on CurseForge

15. 1.4.1

    Jul 25, 2026

    MC 1.21.1

    Changelog - v1.4.1

    Dedicated server load crash fix for Codex Page tooltips.

    Fixed

    • Dedicated server crash on load: Codex Page tooltips no longer reference client-only classes (LocalPlayer / Minecraft)

    File on CurseForge

16. 1.4.0

    Jul 25, 2026

    MC 1.21.1

    Changelog - v1.4.0

    Retires Iron's scrolls and spellbooks as alternate progression; reuses school foci for Codex Pages and cheaper unlocks.

    Added

    • Focus → Codex Page — sneak + right-click a school focus with paper (consumes 1 focus, 1 paper, and 10 levels of XP)
    • Focus XP discount — holding a matching school focus cuts tier unlock costs by 25%

    Changed

    • Iron's scrolls and spellbooks retired as progression: crafting recipes removed, Scroll Forge blocked, loot/mob drops stripped, tosses voided
    • Leftover scrolls/spellbooks right-click to discover inscribed spell(s) into the Codex
    • Codex actionbar scrolls still work for casting; focus and ink crafting unchanged

    File on CurseForge

17. 1.3.0

    Jul 24, 2026

    MC 1.21.1

    Changelog v1.3.0

    School access controls, Codex equip UX polish, and related fixes.

    Added

    • school_access.json — per-school locked/unlocked flags; all detected schools are auto-merged on server start (default unlocked)
    • Op commands to manage school visibility:
      • /specs_codex school lock <id>
      • /specs_codex school unlock <id>
      • /specs_codex school list
    • Locked schools hide their Codex tab and spells, clear invalid actionbar scrolls, and cannot be cast
    • School access is synced to clients with the rest of the Codex config

    Changed

    • Equipped / carried Codex scrolls show the spell icon instead of the scroll item texture (slots and cursor)
    • Spell resource IDs in Codex hover tooltips are shown in creative mode only

    Fixed

    • Spell icons in the Codex grid were 1px too far right; aligned with the panel wells
    • Dragging a spell no longer shows the scroll texture underneath the spell icon
    • Codex scrolls are voided when dropped outside the menu, thrown with Q, or left on the cursor when the menu closes (no world item dumps)

    File on CurseForge

18. 1.2.0

    Jul 24, 2026

    MC 1.21.1

    Changelog v1.2.0

    Configurable Codex progression settings via JSON under config/specs_irons_spellbooks/.

    Added

    • spell_blacklist.json — hide/block specific spells by ID (e.g. irons_spellbooks:fireball)
    • school_unlock_costs.json — per-school explicit level costs by tier; missing tiers use 20 + 10 × tier; new schools are auto-merged on server start
    • spell_unlock_costs.json — optional per-spell cost overrides (spell → school → default)
    • codex_settings.json — configurable respec refund percent (default 25)
    • known_spells.json — regenerated reference listing spell IDs by school
    • Codex hover tooltip shows the spell's resource ID
    • Config syncs to clients on login

    File on CurseForge

19. 1.1.0

    Jul 24, 2026

    MC 1.21.1

    [1.1.0] - 2026-07-24

    Spell Codex UI polish and overcrowding fixes for packs that add many schools/spells.

    Changed
    
    

    Spell Codex HUD

    - Arcane Grimoire panel texture (leather/bronze frame, recessed actionbar + spell wells, footer band)
    - Panel size 256×256 with clearer spacing between title, actionbar, school tabs, spell grid, and tier picker
    - Title centered in the title band as Spell Codex
    - Lv and Respec use grimoire-styled textured buttons (bronze bezel, gold label, hover/disabled states)

     

    School tabs

    - Tabs stay on a single scrollable row with ◀ ▶ and mouse-wheel scrolling over the tab strip
    - No longer wrap onto extra rows (avoids overlapping the spell grid when many schools are present)
    - Free scrolling is allowed even if the selected school is off-screen

     

    Fixed

    - Creative-only spells (AllowCrafting = false) are hidden from the Codex
    - School tabs with no listable spells are omitted

    File on CurseForge

20. 1.0.0

    Jul 24, 2026

    MC 1.21.1

    v1.0.0 - Initial Build

    File on CurseForge