Model Selection Screen Animations (gui, hover, focus)
Since version 2.2.2, Yes Steve Model supports custom preview animations inside the in-game model selection menu. You can make your character pose, react to mouse hover events, or celebrate when selected by adding specific animations to your model files. This adds a polished, interactive feel before a player even equips your model.
Overview and File Location
When players open the YSM model selection GUI, models play a preview animation. Starting from YSM version 2.2.2, creators can customize this default pose and add interactive mouse-triggered reactions.
All selection screen animations must be saved inside your model's main animation file: main.animation.json. If you want to see a complete working example, inspect the main.animation.json file inside the built-in wine_fox_jk model included with the mod.
Setting the Default Preview Animation
The default idle animation played in the selection screen does not require a strict, hardcoded name. You can give your default preview animation any name you like (such as gui), as long as you declare it in your ysm.json file.
To link your animation, open ysm.json and set the preview_animation key inside the properties object to match the exact name of your animation.
- Create a new animation in main.animation.json (for example, name it gui).
- Open your model's ysm.json configuration file.
- Under properties, set preview_animation to your animation's name.
{
"properties": {
"preview_animation": "gui"
}
}Interactive Mouse Animations (hover and focus)
Beyond the default idle loop, YSM recognizes three reserved animation names in main.animation.json that trigger automatically when the player interacts with the model's button in the selection menu.
hover plays when the player moves their mouse cursor over the model button.
hover_fadeout plays when the mouse cursor leaves the model button. This is ideal for creating a smooth transition back to the idle pose.
focus plays when the player clicks and selects the model button. Note that the focus animation only works in Minecraft 1.20 and above.
Fixing Preview Camera Rotation (2.3.0+)
By default, the YSM selection menu renders models at an angled rotation. In YSM 2.2.2 and earlier, creators had to animate their character at an awkward counter-angle if they wanted the model to face the camera directly.
Starting from YSM version 2.3.0, you can disable this built-in menu tilt. Adding disable_preview_rotation: true to your ysm.json properties aligns the in-game GUI view directly with your front view in Blockbench.
{
"properties": {
"preview_animation": "gui",
"disable_preview_rotation": true
}
}Questions
Do I have to name my default preview animation 'gui'?
No. The default animation can have any name you choose, as long as you specify that exact name in the preview_animation field inside ysm.json. However, the interactive animations (hover, hover_fadeout, and focus) must use their exact reserved names.
Why isn't my 'focus' animation playing when I click the model?
First, make sure the animation is inside main.animation.json and named exactly 'focus'. Second, verify your Minecraft version—the focus animation is only supported on Minecraft 1.20 and newer.
Why is my model facing sideways in the selection menu compared to Blockbench?
The selection GUI applies a default rotation to preview models. If you are using YSM 2.3.0 or newer, add "disable_preview_rotation": true under "properties" in your ysm.json file to make the GUI match Blockbench's front view.
Is there an official example I can study?
Yes. Look at the main.animation.json file inside the default wine_fox_jk model that comes pre-installed with the mod.