Guide · Mod compatibility

SlashBlade Animations Guide

Starting 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.

Understanding SlashBlade Locator Groups

To animate the sword and scabbard separately during combat, you must add specific locator groups to your model rig. While the older LeftWaistLocator is still used to render a complete, sheathed sword (both blade and scabbard combined), the new system introduces BladeLocator and SheathLocator to render the blade and the scabbard as two independent parts.

Every single one of these required locator groups must exist in your model for the SlashBlade animations to trigger. If even one locator is missing, YSM will fall back to the old default animation, which simply plays a basic normal attack swing repeatedly.

Always double-check the spelling and capitalization of your locator bone names in Blockbench, as a single typo will disable the custom SlashBlade animation system.

Positioning the Locator Groups

Proper hierarchy and pivot placement ensure that the blade and scabbard follow your character's hands naturally during complex sword skills. When setting up your skeleton, follow the recommended placement rules for each locator group.

  1. Place BladeLocator inside the right hand group, at the exact same position and pivot point as RightHandLocator.
  2. Place SheathLocator inside the left hand group, at the exact same position and pivot point as LeftHandLocator.
  3. Place LeftWaistLocator inside the left hand group as well, sharing the same position and pivot point as LeftHandLocator.
  4. Keep RightWaistLocator unchanged in its standard position under the UpperBody group.

Registering the Animation File in ysm.json

After preparing the model rig, you must declare the SlashBlade animation file inside your model's ysm.json configuration. You do this by adding the slashblade key under the animation object and pointing it to your animation file path.

Once registered, you can create your custom animations by referencing the slashblade.animation.json file found in the default YSM models.

"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"
}
If you edit your SlashBlade animations and notice your changes have no effect in-game, first verify that the slashblade path is explicitly declared in ysm.json.

Finding Active Sword Skill Animation Names

Although the SlashBlade system has many entries, only around twenty animations are commonly used in gameplay; the rest are either unimplemented or very difficult to trigger. Rather than guessing which animation corresponds to which attack, you can use YSM's built-in Molang watcher to see the exact animation name in real time as you play.

  1. Run the watch command in the in-game chat to track the SlashBlade animation controller variable.
  2. Press the Alt + B shortcut key to open the YSM debug overlay on your screen.
  3. Perform any sword skill with a SlashBlade equipped, and read the active animation name displayed on the debug screen.
/ysmclient molang watch add post "Current SlashBlade Animation" ctrl.slashblade_animation

Questions

Why does my character only do a basic swing instead of custom SlashBlade animations?

This happens for two main reasons: either you are missing one of the required locator groups (BladeLocator, SheathLocator, LeftWaistLocator, or RightWaistLocator) in your model, or you forgot to declare the "slashblade" animation file path inside the "animation" block of your ysm.json file.

Which versions of YSM and the SlashBlade mod are supported?

You need YSM version 2.3.0 or newer. This system supports both the legacy SlashBlade mod and the newer SlashBlade: Resharped.

Where should LeftWaistLocator be placed for SlashBlade animations?

Unlike traditional setups where a waist locator sits on the torso, for the SlashBlade animation system it is recommended to place LeftWaistLocator in the left hand, sharing the exact same position and pivot point as LeftHandLocator and SheathLocator.

Do I need to animate every single entry in slashblade.animation.json?

No. Only about twenty sword skill animations are regularly used in actual gameplay; many others are either not implemented by the mod or rarely triggered. Use the ctrl.slashblade_animation watch command to identify and prioritize the skills you actually use.

Next: Touhou Little Maid 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
Iron's Spells 'n Spellbooks AnimationsSince 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.
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.