Guide · Animation

Riding Animations and Custom Vehicles (Boats, Horses, Mobs)

Yes Steve Model (YSM) lets you create unique postures for your character when riding specific mobs or carrying passengers on your head. Furthermore, since version 2.5.0, you can completely replace the 3D models and animations of the vehicles themselves, and since 2.2.2, you can add dedicated equestrian animations for the SWEM horse mod.

Player Riding and Passenger Animations

When a player rides an entity or carries another entity on their head, you can trigger specific player animations. These riding animations do not require a separate file and can be placed directly inside your main.animation.json file. This matters because it lets you adjust your character's sitting posture to fit different mount shapes without altering your default sitting pose.

The naming convention works just like hand animations. You start with the prefix vehicle or passenger, followed by $ for a specific entity ID or # for an entity tag.

Use the vehicle prefix when the player is riding on top of another entity. Use the passenger prefix when another entity is riding on the player's head.

vehicle$minecraft:slime
passenger$minecraft:fox
In the examples above, vehicle$minecraft:slime plays when the player rides a slime, while passenger$minecraft:fox plays when a fox is sitting on the player's head.

Replacing Vehicle Models (Since 2.5.0)

Introduced in YSM 2.5.0, you can replace the vanilla or modded entity model of the vehicle a player is riding with a custom model, texture, animation, and animation controller. This allows your character pack to include a matching custom horse, boat, or plane.

To set this up, open your ysm.json file and add a vehicles object inside the files section. Each key inside vehicles must be a specific entity ID (entity tags are not supported here, though modded entity IDs work seamlessly).

{
  "files": {
    "vehicles": {
      "minecraft:horse": {
        "model": "models/horse.json",
        "texture": "textures/horse.png",
        "animation": "animations/vehicle/horse.animation.json",
        "controller": "controllers/vehicle/horse.controller.json"
      },
      "minecraft:boat": {
        "model": "models/boat.json",
        "texture": {
          "uv": "textures/boat.png",
          "normal": "textures/boat_n.png",
          "specular": "textures/boat_s.png"
        }
      },
      "man_of_many_planes:scarlet_biplane": {
        "model": "models/plane.json",
        "texture": "textures/plane.png",
        "animation": "animations/vehicle/plane.animation.json"
      }
    }
  }
}
As shown in the minecraft:boat example, vehicle textures also support PBR materials using uv, normal, and specular keys.

Positioning Passengers with Locator Groups

When you replace a vehicle's model, Minecraft's default seat height might not match your custom 3D mesh. You can control the exact rendering position of the riding players by adding locator bone groups to your vehicle model.

The player's origin point will snap directly to the locator point on the vehicle, meaning the rider will move and bounce along with the bone's animation. For multi-seat vehicles, riders are seated in numerical order.

  1. Name the first seat group PassengerLocator for the primary driver or rider.
  2. Name additional seat groups PassengerLocator2 through PassengerLocator8 in sequential order for extra passengers.

Built-in Vehicle Animation Names

When animating your custom vehicle in its animation file (such as animations/vehicle/horse.animation.json), YSM automatically triggers specific animations based on the vehicle's current state and movement.

Here are the standard state animations you can create for your vehicle:

  1. idle: Plays when the entity is standing still / on standby.
  2. water: Plays when the entity is in water.
  3. ground: Plays when the entity is on the ground.
  4. fly: Plays when the entity is flying.
  5. forward: Plays when the entity is moving forward.
  6. has_ride: Plays whenever the entity is currently being ridden.
  7. not_ride: Plays when the entity is not being ridden.

Vehicle Parallel Animations

Just like player models, custom vehicles support parallel animations that run independently alongside the main state animations. They are divided into two categories based on priority:

Low-priority parallel animations (pre_parallel0 to pre_parallel7) have the lowest priority and will be overridden by main animations. Among these, priority increases with the number (pre_parallel7 is higher than pre_parallel0).

High-priority parallel animations (parallel0 to parallel7) have the highest priority, use special blending, and override main animations. Similarly, their priority increases from 0 to 7.

pre_parallel0, pre_parallel1, pre_parallel2, pre_parallel3, pre_parallel4, pre_parallel5, pre_parallel6, pre_parallel7
parallel0, parallel1, parallel2, parallel3, parallel4, parallel5, parallel6, parallel7

SWEM Equestrian Mod Animations (Since 2.2.2)

The Star Worm Equestrian Mod (SWEM) adds realistic horse riding gaits and jumping mechanics to Minecraft. Since version 2.2.2, YSM supports custom player animations tailored to SWEM's riding states.

To enable SWEM animations, you must declare the swem animation file path inside the animation section of your ysm.json file, and you can refer to the default model's swem.animation.json as a template.

  1. swem:idle - Player animation when mounted on a SWEM horse and standing still.
  2. swem:walk - Slow walk gait.
  3. swem:trot - Trot (fast walk) gait.
  4. swem:canter - Canter (running) gait.
  5. swem:canter_ext - Extended canter (running) gait.
  6. swem:gallop - Full gallop gait.
  7. swem:jump_lv1, swem:jump_lv2, swem:jump_lv3, swem:jump_lv4, swem:jump_lv5 - Jumping animations across 5 distinct jump levels.
"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"
}
If your modified SWEM animations do not play in-game, double-check your ysm.json first to make sure the swem key is properly declared under the animation field.

Questions

Where do I put vehicle$ and passenger$ animations for my player model?

You can put them directly inside your main.animation.json file. They do not require a separate file registration.

Can I use entity tags with # to replace multiple vehicle models at once in ysm.json?

No. While player riding animations (like vehicle#...) support entity tags, the vehicles model replacement field in ysm.json (added in 2.5.0) only supports specific entity IDs, such as minecraft:horse or modded IDs.

How do I fix my player floating or clipping inside a custom vehicle model?

Add a bone group named PassengerLocator (and PassengerLocator2 up to PassengerLocator8 for extra seats) in your vehicle's model. The player's origin will attach directly to that locator group.

Why are my custom SWEM horse riding animations not working?

You likely forgot to register the animation file. Open ysm.json and make sure "swem": "animations/swem.animation.json" is listed inside the "animation" object.

Next: YSM Animation Overview: Getting Started & Prerequisites →

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.