Guide · Animation

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.

  1. Create a new animation in main.animation.json (for example, name it gui).
  2. Open your model's ysm.json configuration file.
  3. Under properties, set preview_animation to your animation's name.
{
    "properties": {
        "preview_animation": "gui"
    }
}
If you use the YSM Blockbench plugin, you do not need to edit ysm.json manually—simply type the animation name into the Preview Animation field in the plugin settings.

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.

Unlike the default preview animation, hover, hover_fadeout, and focus must use these exact names in main.animation.json to work.

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.

Next: Parallel animations (blinking, ears, hair physics) →

More in Animation

A
Armor AnimationsArmor animations allow your custom Yes Steve Model (YSM) character to visually display gear or change its appearance whenever the player equips armor. By controlling bone scaling through specific animation names, you can dynamically show or hide custom 3D armor pieces for specific items, item tags, or any equipped armor in general.
A
Arrow and projectile animationsCustomizing projectiles allows your character model to fire unique arrows, tridents, snowballs, or even modded projectiles with their own 3D geometry and animations. Starting from YSM version 2.5.0, the legacy arrow system was expanded into a universal projectile system that supports almost any thrown or shot entity in Minecraft. This guide covers how to set up projectile files in your model configuration, use animation controllers, and support older YSM versions.
A
Extra Animations in the Animation WheelExtra animations allow players to trigger custom emotes, dances, or poses on demand using the in-game animation wheel. All wheel animations must be stored in a dedicated file named extra.animation.json to be recognized by the Yes Steve Model mod.
A
First-Person Arm Animations and Mod CompatibilityYes Steve Model (YSM) lets you bring your custom character's hands to life in the default first-person view. Since version 2.5.0, you can add dedicated first-person arm animations and configure your model to work smoothly with third-party first-person camera mods. This guide covers how to register these animations, understand bone limitations, and prevent your model's head from blocking the player's view.
A
Hand Condition Animations (Items in Hand)Condition animations in Yes Steve Model (YSM) are specially named animations that play automatically when certain in-game triggers occur, allowing you to create responsive actions without touching complex animation controllers. Hand condition animations specifically control how your character's arms react when holding, using, or swinging items.
A
Parallel animations (blinking, ears, hair physics)Parallel animations in Yes Steve Model (YSM) allow you to run continuous background effects like blinking, ear twitches, or tail wagging alongside standard player actions. These animations loop independently of the main movement states, bringing your character to life without getting interrupted when the player walks, sprints, or attacks.