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.
- Open your model pack's ysm.json file.
- Locate the "animation" object block.
- Add the "irons_spell_books" key and point it to "animations/iss.animation.json".
- 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"
}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: StompContinuous 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)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 HolePaired 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: ShockwaveQuestions
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.