Ability: Iron's Spells 'n Spellbooks

By
AshuraNoYami

Wear an Iron's Spells spellbook in Curios and cast its spells from a cycleable Ability Hotbar bar - spell icons, per-spell cooldown and mana overlays. For the Tensura RPG pack.

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

	Mod	Why
Required	Minecraft	-
Required	NeoForge	-
Required	Curios	The `spellbook` slot the book wears in
Required	Iron's Spells 'n Spellbooks	Spellbook contents (`ISpellContainer`) and the cast itself (`serverSideInitiateQuickCast`) - the addon delegates, it never reimplements
Required	Ability Hotbar	The bar: registration, the content-provider cells, seeded verbs, and the icon/overlay hooks the cells draw through
Required	Ability Core	The activation seam: slot gate, request/result vocabulary, availability tuple

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

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.