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:foxReplacing 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"
}
}
}
}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.
- Name the first seat group PassengerLocator for the primary driver or rider.
- 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:
- idle: Plays when the entity is standing still / on standby.
- water: Plays when the entity is in water.
- ground: Plays when the entity is on the ground.
- fly: Plays when the entity is flying.
- forward: Plays when the entity is moving forward.
- has_ride: Plays whenever the entity is currently being ridden.
- 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, parallel7SWEM 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.
- swem:idle - Player animation when mounted on a SWEM horse and standing still.
- swem:walk - Slow walk gait.
- swem:trot - Trot (fast walk) gait.
- swem:canter - Canter (running) gait.
- swem:canter_ext - Extended canter (running) gait.
- swem:gallop - Full gallop gait.
- 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"
}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 →