Please make sure that your Iron's Spellbooks version is up to date!

Better Spellcasting

Bind spells to your weapon attacks!

This mod allows you to attach spells from Iron's Spells 'n Spellbooks to individual weapon attacks in a combo chain.

Features

Spell-Infused Combos: Attach different spells to each attack in a weapon's combo chain
Flexible Targeting: Spells can target enemies or yourself (for buffs/heals)
Customizable Per-Weapon: Define spell combinations in JSON for any weapon
Mana-Free Casting: Weapon spells don't consume mana by default
Combo Tracking: The mod accurately tracks your attack combo, even when swinging in the air

How It Works

Define spells in your weapon's Better Combat JSON file:

diamond_sword.json

{ "attributes": { "attack_range": 2.5, "category": "sword", "attacks": [ { "hitbox": "HORIZONTAL_PLANE", "damage_multiplier": 1, "angle": 120, "upswing": 0.5, "animation": "bettercombat:one_handed_slash_horizontal_right", "swing_sound": { "id": "bettercombat:sword_slash" }, "spell": "irons_spellbooks:firebolt", "level": 1, "target": "TARGET"
"trigger": "on_attack" }, { "hitbox": "HORIZONTAL_PLANE", "damage_multiplier": 1, "angle": 120, "upswing": 0.5, "animation": "bettercombat:one_handed_slash_horizontal_left", "swing_sound": { "id": "bettercombat:sword_slash" }, "spell": "irons_spellbooks:blood_slash", "level": 4, "target": "TARGET"
"trigger": "on_attack" }, { "hitbox": "FORWARD_BOX", "damage_multiplier": 1, "angle": 0, "upswing": 0.5, "animation": "bettercombat:one_handed_stab", "swing_sound": { "id": "bettercombat:sword_slash", "pitch": 1.2 }, "spell": "irons_spellbooks:heal", "level": 1, "target": "SELF"
"trigger": "on_hit" } ] } }

In this example, a diamond sword would cast Firebolt on the first attack, Blood Slash on the second, and Heal (on yourself) on the third!

Spell Properties

spell: The spell ID (e.g., "irons_spellbooks:firebolt")
level: Spell level (1-...)
target: Either "TARGET" (hits enemy) or "SELF" (casts on you)
trigger: Either "on_attack" (casts spell everytime) or "on_hit" (casts spell only after enemy is hit)

Limitations

Continuous cast spells are not supported (spells that channel over time won't work with instant weapon attacks)
You can only attach 1 spell to an attack
Requires both Better Combat and Iron's Spells 'n Spellbooks

🚀 Need a server? Use code Kayn at checkout for 25% off your first month with BisectHosting.