Guide · Mod compatibility

Iron's Spells 'n Spellbooks Animations

Since version 2.6.0, Yes Steve Model (YSM) supports custom spellcasting animations for the Iron's Spells 'n Spellbooks mod. By linking a dedicated animation file in your model configuration, your character can perform unique movements for projectiles, slashes, and long chants. This guide covers how to register the animation file and lists every available spell animation trigger.

Registering the Animation File

To enable spellcasting animations, you must register the irons_spell_books animation key inside your model's ysm.json file. This tells YSM where to look when a player casts a spell from Iron's Spells 'n Spellbooks. Without this entry, your custom model will not play dedicated magic animations.

You can use the default model's iss.animation.json file as a template to build your own spell movements. Simply point the configuration key to your new animation file path inside the animations folder.

  1. Open your model pack's ysm.json file.
  2. Locate the "animation" object block.
  3. Add the "irons_spell_books" key and point it to "animations/iss.animation.json".
  4. Create or copy iss.animation.json into your model's animations folder.
"animation": {
    "main": "animations/main.animation.json",
    "arm": "animations/arm.animation.json",
    "extra": "animations/extra.animation.json",
    "tac": "animations/tac.animation.json",
    "carryon": "animations/carryon.animation.json",
    "parcool": "animations/parcool.animation.json",
    "swem": "animations/swem.animation.json",
    "slashblade": "animations/slashblade.animation.json",
    "tlm": "animations/tlm.animation.json",
    "immersive_melodies": "animations/im.animation.json",
    "irons_spell_books": "animations/iss.animation.json",
    "fp_arm": "animations/fp.arm.animation.json"
}
Always make sure your YSM mod is updated to at least version 2.6.0, as older versions will ignore the irons_spell_books key.

Instant and Melee Spell Animations

Instant and melee spells trigger quick, single-action animations without a charging phase. These are used for fast combat magic like firing instant bolts, swinging magical blades, or applying immediate self-buffs.

Make sure these animations are snappy and return smoothly to the idle pose. Because these spells cast immediately, long wind-ups in your animation will feel out of sync with the actual magic effect.

iss:instant_projectile
- Type: Instant projectile magic
- Examples: Magic Missile, Firebolt, Icicle, Lightning Bolt, Firecracker, Blood Needles, Acupuncture, Devour, Frost Step, Creeper Mortar, Wither Skull, Counterspell, Sacrifice

iss:instant_slash
- Type: Quick slashing magic
- Examples: Blood Slash

iss:horizontal_slash_one_handed
- Type: Wide one-handed sweeping slash
- Examples: Flaming Strike

iss:overhead_two_handed_swing
- Type: Two-handed overhead weapon swing
- Examples: Hellrazor, Divine Smite

iss:instant_self
- Type: Self-buffing and enhancement magic
- Examples: Charge, Oakskin

iss:stomp
- Type: Foot-stomping magic cast
- Examples: Stomp

Continuous Channeled Spell Animations

Continuous spells loop while the player holds down the cast button to channel an ongoing effect. These are divided into forward-thrusting sprays (like breath attacks) and overhead channeling (like calling projectiles down from the sky).

iss:continuous_thrust
- Type: Continuous forward spray or beam magic
- Examples: Dragon Breath, Cone of Cold, Fire Breath, Ray of Siphoning

iss:continuous_overhead
- Type: Continuous falling magic or overhead wind-up
- Examples: Starfall, Blessing of Life (wind-up)
Design continuous animations as seamless loops so the character does not twitch while holding a breath or beam spell.

Chanted and Charged Spell Animations

Charged spells play a wind-up or chanting animation while the player prepares a powerful spell before release. Depending on the spell type, the character might draw a magical bow, hold a spear ready to throw, or raise a hand to gather energy.

iss:charge_arrow
- Type: Bow and arrow magic charging
- Examples: Magic Arrow, Poison Arrow

iss:charged_throw
- Type: Thrown projectile chanting
- Examples: Lightning Lance, Magma Bomb

iss:long_cast
- Type: Standard long spell chanting
- Examples: Frostbite, Fireball, Root, Creeper Ring, Greater Heal, Raise Dead, Summon Steed, Summon Vex

iss:charge_wavy
- Type: Surging wave-like magic chanting
- Examples: Gust

iss:charge_raised_hand
- Type: Chanting with a raised hand
- Examples: Arrow Volley

iss:charge_black_hole
- Type: Black hole magic chanting
- Examples: Black Hole

Paired Wind-up and Release Animations

Some charged spells use a two-part animation sequence: a charging pose followed by a distinct release finisher. When the chanting completes, YSM transitions directly from the charge animation into the corresponding finish animation.

Ensure the ending pose of the charge animation aligns closely with the starting pose of the finish animation. This prevents jarring visual snaps when the spell finally goes off.

iss:long_cast_finish
- Type: Finisher for long chanting actions
- Connects from: Various long chant animations (such as iss:long_cast)

iss:touch_ground
- Type: Ground-stomping or ground-touching burst finisher
- Connects from: iss:charge_raised_hand (e.g., finishing animation for Heat Surge)

iss:charge_spit -> iss:charge_spit_finish
- Type: Brewing a spit attack, followed by spitting it out
- Examples: Acid Orb

iss:cross_arms -> iss:cast_t_pose
- Type: Crossing arms to charge a burst, followed by throwing arms out (T-pose) to release
- Examples: Shockwave

Questions

Which version of YSM is required for Iron's Spells 'n Spellbooks animations?

You need Yes Steve Model version 2.6.0 or newer. Earlier versions do not recognize the irons_spell_books animation entry.

Where can I find a working example of iss.animation.json?

You can extract or view the iss.animation.json file included in YSM's built-in default model to see how all 20 spell animations are structured and timed.

Why does my character freeze when finishing a charged spell?

Check if you created the matching finisher animation (such as iss:long_cast_finish, iss:touch_ground, iss:charge_spit_finish, or iss:cast_t_pose). Many charged spells require a separate release animation after the chant completes.

Next: ParCool Parkour Animations →

More in Mod compatibility

C
Better Combat Animations in Yes Steve ModelStarting from version 2.6.0, Yes Steve Model (YSM) features improved compatibility with the Better Combat mod. Weapon swings now properly trigger YSM animations without first-person head clipping issues, and creators can use new Molang variables to build custom, dynamic combat animation controllers.
C
Carry On Mod Compatibility AnimationsYes Steve Model (YSM) includes built-in animation support for the popular Carry On mod, which lets players pick up blocks, mobs, and other players by holding Shift and right-clicking. By adding a dedicated animation file to your model pack, you can create custom poses for both the carrier and the player being carried.
C
Gun animations for TaCZ and Superb WarfareYes Steve Model includes built-in animation support for popular firearm mods, allowing your custom character models to hold, aim, reload, and fire weapons naturally. All gun animations are stored in a dedicated tac.animation.json file and use a split upper-body and lower-body system to save you animation work.
C
Immersive Melodies Instrument AnimationsSince version 2.6.0, Yes Steve Model (YSM) includes deep integration with the Immersive Melodies mod. This feature allows your custom character models to react dynamically to live performance data, such as note pitch, volume, and timing. By setting up these animations, your model can realistically strum, blow, or strike instruments in sync with the music.
C
ParCool Parkour AnimationsYes Steve Model (YSM) includes built-in compatibility for the ParCool mod starting since version 2.2.2, allowing custom models to display dynamic parkour movements. By linking a dedicated animation file in your configuration, you can customize wall runs, vaults, rolls, and flips to fit your character's unique proportions.
C
SlashBlade Animations GuideStarting from version 2.3.0, Yes Steve Model (YSM) includes native animation compatibility for the SlashBlade mod, supporting both the legacy SlashBlade and SlashBlade: Resharped. This guide covers how to set up the required bone locators in your model, register the animation file in your configuration, and use in-game debugging tools to identify specific sword skill animation names.