Guide · Animation

Player main animations (idle, walk, run, jump...)

Every custom model in Yes Steve Model relies on a core set of animations to react to everyday Minecraft gameplay. These main player animations are stored in the main.animation.json file by default and control everything from walking and jumping to riding mounts and using items. Understanding the exact animation names and their playback rules ensures your character moves naturally in every in-game situation.

Overview of main.animation.json

When creating or editing a YSM character, the primary movement and state animations live inside the main.animation.json file. The mod automatically triggers specific animations from this file based on what the player is currently doing in the game.

To make your custom animations work, you must name them inside Blockbench using the exact identifiers recognized by YSM. You also need to configure their loop mode (looping vs. play once) to match how the game expects them to behave.

One special entry in this file is the empty animation. This is strictly an internal debugging animation that is intentionally left blank.

empty - Debugging animation (Empty animation, DO NOT modify)
Never rename, delete, or add keyframes to the empty animation, as it is required by the mod for internal debugging.

Basic Ground Movement and Stances

The most frequently seen animations are those for standing still and moving across the ground. All basic ground locomotion animations must be set to loop continuously so the transition between steps stays smooth while the player holds down movement keys.

Notice that YSM separates stationary posture from active movement for both crouching and crawling under low ceilings (such as trapdoors). This allows you to create a distinct breathing pose when the player stops moving while sneaking or crawling.

  1. idle: Plays when the player is standing still with no other input (Looping).
  2. walk: Plays during normal walking speed (Looping).
  3. run: Plays while the player is sprinting (Looping).
  4. jump: Plays while the player is jumping in the air (Looping).
  5. sneaking: Plays when the player is holding sneak but standing still (Looping).
  6. sneak: Plays when the player is sneaking and walking at the same time (Looping).
  7. climbing: Plays when the player is forced into a crawling state under a trapdoor without moving (Looping).
  8. climb: Plays when the player is actively crawling under a trapdoor (Looping).

Water, Air, and Ladder Navigation

Minecraft includes vertical and fluid movement states that look awkward if the model just uses a standard walking cycle. YSM provides dedicated looping states for swimming, flying, and climbing ladders so your character matches their environment.

For ladders, the mod distinguishes between climbing up, climbing down, and holding onto the rungs without moving. Similarly, water movement is split between horizontal sprint-swimming and treading water upright.

  1. swim: Plays when the player is actively swimming horizontally underwater (Looping).
  2. swim_stand: Plays when the player is treading water in an upright standing position (Looping).
  3. fly: Plays when the player is flying in Creative mode (Looping).
  4. elytra_fly: Plays when the player is gliding with an Elytra (Looping).
  5. riptide: Plays when the player launches themselves using a Riptide-enchanted trident (Looping).
  6. ladder_up: Plays while climbing upward on a ladder (Looping).
  7. ladder_stillness: Plays while holding still on a ladder (Looping).
  8. ladder_down: Plays while descending a ladder (Looping).

Hand Actions, Combat, and Damage

Unlike movement states that loop endlessly, combat, hand interactions, and damage animations are set to play once per trigger. These animations overlay or interrupt regular movement when you click your mouse buttons or take hits.

YSM separates main-hand (right hand) and off-hand (left hand) actions, as well as swinging (attacking or mining) versus using an item. Make sure the death animation is timed properly so it finishes before the respawn screen takes over.

  1. swing_hand: Plays once when swinging the main hand (Single play).
  2. swing_offhand: Plays once when swinging the off-hand (Single play).
  3. use_mainhand: Plays once when using an item in the right/main hand (Single play).
  4. use_offhand: Plays once when using an item in the left/off-hand (Single play).
  5. attacked: Plays once whenever the player takes damage (Single play).
  6. death: Plays once when the player dies; designed for a 1-second duration (Single play, 1s length).
Keep your death animation exactly 1 second long so the full fall plays out cleanly before the player entity disappears.

Mounts, Vehicles, and Resting Postures

When the player interacts with beds, chairs, boats, or rideable mobs, the model switches to a looping posture animation until the player dismounts. Having separate animations for horses, pigs, and boats lets you adjust leg width and hand placement to fit different entity sizes.

  1. sit: Plays when the player is sitting down (Looping).
  2. sleep: Plays while the player is lying in a bed sleeping (Looping).
  3. boat: Plays when the player is seated inside a boat (Looping).
  4. ride: Plays when riding a horse or donkey (Looping).
  5. ride_pig: Plays when riding a saddled pig (Looping).

Questions

What is the difference between 'sneak' and 'sneaking', or 'climb' and 'climbing'?

In YSM, 'sneaking' and 'climbing' play when you are in the crouched or under-trapdoor posture but standing completely still. 'sneak' and 'climb' play when you are actively moving while in those postures.

Can I delete the 'empty' animation to clean up my main.animation.json file?

No. The 'empty' animation is a required debugging animation used internally by the mod. Do not delete or modify it.

Why does my attack or item-use animation keep repeating endlessly?

Action animations like swing_hand, swing_offhand, use_mainhand, use_offhand, attacked, and death must be configured as single-play (play once) animations rather than looping animations.

How long should the player death animation be?

The death animation should be configured as a single-play animation with a duration of 1 second.

Next: Riding Animations and Custom Vehicles (Boats, Horses, Mobs) →

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