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.
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.
- Place BladeLocator inside the right hand group, at the exact same position and pivot point as RightHandLocator.
- Place SheathLocator inside the left hand group, at the exact same position and pivot point as LeftHandLocator.
- Place LeftWaistLocator inside the left hand group as well, sharing the same position and pivot point as LeftHandLocator.
- 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"
}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.
- Run the watch command in the in-game chat to track the SlashBlade animation controller variable.
- Press the Alt + B shortcut key to open the YSM debug overlay on your screen.
- 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_animationQuestions
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.