Better Spellcasting

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.