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)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.
- idle: Plays when the player is standing still with no other input (Looping).
- walk: Plays during normal walking speed (Looping).
- run: Plays while the player is sprinting (Looping).
- jump: Plays while the player is jumping in the air (Looping).
- sneaking: Plays when the player is holding sneak but standing still (Looping).
- sneak: Plays when the player is sneaking and walking at the same time (Looping).
- climbing: Plays when the player is forced into a crawling state under a trapdoor without moving (Looping).
- 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.
- swim: Plays when the player is actively swimming horizontally underwater (Looping).
- swim_stand: Plays when the player is treading water in an upright standing position (Looping).
- fly: Plays when the player is flying in Creative mode (Looping).
- elytra_fly: Plays when the player is gliding with an Elytra (Looping).
- riptide: Plays when the player launches themselves using a Riptide-enchanted trident (Looping).
- ladder_up: Plays while climbing upward on a ladder (Looping).
- ladder_stillness: Plays while holding still on a ladder (Looping).
- 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.
- swing_hand: Plays once when swinging the main hand (Single play).
- swing_offhand: Plays once when swinging the off-hand (Single play).
- use_mainhand: Plays once when using an item in the right/main hand (Single play).
- use_offhand: Plays once when using an item in the left/off-hand (Single play).
- attacked: Plays once whenever the player takes damage (Single play).
- death: Plays once when the player dies; designed for a 1-second duration (Single play, 1s length).
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.
- sit: Plays when the player is sitting down (Looping).
- sleep: Plays while the player is lying in a bed sleeping (Looping).
- boat: Plays when the player is seated inside a boat (Looping).
- ride: Plays when riding a horse or donkey (Looping).
- 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) →