Ability: Iron's Spells 'n Spellbooks

Ability ISS

A provider addon for Ability Hotbar that gives Iron's Spells 'n Spellbooks a second hotbar: wear a spellbook in the Curios spellbook slot and its spells appear as a cycleable, non-assignable bar - spell icons, per-spell cooldowns and mana - cast through ISS's own pipeline, so the bar and ISS's own wheel, keybinds and UI coexist instead of competing. Built for the Tensura RPG pack.

What it does

• The bar (ability_iss:spellbook): one cell per slot of the equipped book, the cell count taken from the book's own capacity and clamped to [1, 18]. The bar never appears in the assignment menu, the wheel cycles to it like any other bar, and one selection frame marks the cell a press acts on. Without a worn book the bar counts as empty and the wheel skips it.
• Cells draw the spells themselves: each cell shows the spell's own icon texture (spells have no item form), plus a per-spell cooldown sweep and a dim for a locked spell or mana below its cost - all read from ISS's own client-synced state, so the bar can never disagree with ISS's HUD. No cost badge is drawn over spell icons (the badge is an unannotated strip; REQ-HOT-08 prefers no overlay to noise).
• Casting dispatches through Ability Core with the cell index as the activation's slot context, then delegates to ISS's own quick-cast: mana, cooldown, cast-in-progress and every refusal message stay ISS's pipeline, and the bar only carries the outcome (hotbar fires intents only). Slot dispatch runs fail-closed through Ability Core's slot gate - a stale cell, a missing context or an empty book refuses instead of guessing.
• The bar tracks the book: content re-seeds on login, whenever the book's spells change (inscription), and whenever the spellbook is equipped or unequipped - per slot, so a removed spell clears its own cell and never a prefix of them.
• Coexistence is deliberate: ISS's spell wheel, cast keybinds and screens are untouched - the bar is additive. If this bar should be the only spell display, turn ISS's own spell bar off in its client config (config/irons_spellbooks-client.toml, [UI.SpellBar], spellBarDisplay = "Never").
• Books larger than nine slots render as nine-slot segments with one selector, like every other bar (hotbar#86).

Dependencies

Ability Core and Ability Hotbar resolve from this org's GitHub Packages maven (they are not published to CurseForge or Modrinth), so CI needs the workflow token (already wired in ci.yml) and a local build needs gpr.user / gpr.key in ~/.gradle/gradle.properties.

Credits

• Built on NeoForge.
• Derived from neoforge-mod-template.

License

GNU Lesser General Public License v2.1 - see LICENSE. Copyright (c) 2026 Bitwise Madness.

AI disclosure

Parts of this project were written with the assistance of AI coding tools. AI-assisted code, data and documentation ship only after human review by the maintainers.