Iron's Spells: Incantation

Say a spell's name. Cast it.

Incantation listens to your Simple Voice Chat mic, runs the audio through an offline speech recognizer (Vosk), and casts whichever Iron's Spells 'n Spellbooks spell you just said. No voice training, no extra keybind, no setup beyond unzipping a model into the config folder.

How it works

When Simple Voice Chat is transmitting your audio, Incantation feeds the frames to a Vosk recognizer whose grammar is restricted to the names of spells you actually have equipped (spellbook in your Curios slot, spellbook in hand, or an imbued weapon you're holding). That means the recognizer literally cannot mis-hear you and accidentally fire a spell you don't have - background chatter just doesn't match anything in the grammar.

The whole pipeline runs locally. No network calls. No accounts. Your voice never leaves your PC.

Features

• Speak any indexed spell - works with Iron's Spells, all its addons, and any mod that registers spells through Iron's API.
• Owned-spell restriction (default ON) - Vosk's grammar dynamically narrows to the spells in your Curios slot, hands, and hotbar.
• Imbued weapons supported - hold an imbued sword or staff, say the spell it carries, it casts via the same mechanism as right-clicking.
• HUD chip showing last cast, queued spells, miss toast, alias suggestions, and a live audio meter.
• Themes - accent presets (Arcane, Blossom, Ocean, Mint, Gold, plus Phoenix / Frost / Verdant / Necrotic unlocked by cast milestones) and base palettes (Dark, Midnight, Slate).
• Vanilla advancements for voice-cast milestones and combo casts.
• Spell List screen browsing every indexed spell with its exact phrase.
• Voice Codex - personal stats (top-cast spell, daily streak, median latency).
• Test Arena - safe practice mode.
• Welcome wizard on first launch.
• Aliases & custom phrases - bind words the model can pronounce to any spell id.
• Loadout shortcuts - say one word, cast the first castable spell from a list.
• Macros - record a cast sequence, replay with one keybind.
• Voice commands - spell one through spell nine for slot select; yes/no for queue control.
• Server-side controls - whitelist, blocklist, rate limit, broadcast-nearby, cast logging.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.x
• Simple Voice Chat (henkelmax, 2.5.x+)
• Iron's Spells 'n Spellbooks (iron431, 3.x+)
• A small Vosk English model (~40 MB)
• Curios API recommended

Setup

1. Drop incantation-0.9.0.jar in your mods/ folder alongside SVC and Iron's Spells.
2. Grab a Vosk model from https://alphacephei.com/vosk/models - vosk-model-small-en-us-0.15.zip is enough for vanilla spell names.
3. Unzip and copy the contents into config/voicespells/model/ so the layout is config/voicespells/model/am/, config/voicespells/model/conf/, etc.
4. Launch the game, join a world, trigger SVC, and say a spell you have equipped.

For tricky spell names, either switch to the medium model (vosk-model-en-us-0.22-lgraph, ~128 MB) or map an alias in config/voicespells-client.toml.

License

MIT.

Credits

• Vosk - Alpha Cephei (Apache 2.0)
• Simple Voice Chat API - Maximilian Henkel (MIT)
• Iron's Spells 'n Spellbooks - iron431