First-Person Arm Animations and Mod Compatibility
Yes 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.
Registering First-Person Arm Animations
Support for first-person arm model animations was introduced in YSM version 2.5.0. This feature allows you to animate the player's hands when they are viewing the game from the standard Minecraft first-person perspective.
To enable these animations, you must link a dedicated animation file inside your pack's ysm.json configuration file. You do this by adding the fp_arm key inside the animation object under files.
- Open your model's ysm.json file.
- Locate the files object, and then find the animation section inside it.
- Add the fp_arm key and point it to your first-person animation JSON file (commonly named animations/fp.arm.animation.json).
{
"files": {
"animation": {
"main": "animations/main.animation.json",
"arm": "animations/arm.animation.json",
"extra": "animations/extra.animation.json",
"fp_arm": "animations/fp.arm.animation.json"
}
}
}Supported Parallel Animations
Inside your fp.arm.animation.json file, YSM uses parallel animations to drive movement. You can define up to eight parallel animations named parallel0 through parallel7.
These behave just like standard player parallel animations. They run independently from the main animations and carry the highest priority. If multiple parallel animations affect the same bone, the priority increases with the number—meaning parallel7 overrides parallel0.
Additionally, roaming variables are shared between your main animation file and the first-person animation file. This matters because you can trigger a variable in your third-person main animation and have your first-person arms react to it seamlessly.
Available First-Person Animation Names:
parallel0, parallel1, parallel2, parallel3, parallel4, parallel5, parallel6, parallel7Important Rules and Limitations
Before animating, you need to understand how YSM renders the first-person view so you do not waste time animating invisible parts. Animations will only apply to content placed inside the LeftArm and RightArm bone groups. Any cubes or groups outside of these two arm groups will neither render nor animate in first-person view.
First-person arm animations will not display when the player is holding an item in their hand. They are strictly for empty-hand views.
Finally, the background group currently does not support animations in the first-person perspective.
Compatibility with the First-person Model Mod
Many players use the third-party First-person Model mod, which replaces vanilla's floating arm view with a realistic 3D body view look-down camera. YSM provides basic compatibility for this mod, though minor glitches like a disappearing head or slightly off-center camera angles may occasionally happen.
To prevent the character's own head, hair, or hat from blocking the camera in this mode, any model parts placed inside a bone group named AllHead will automatically hide when rendering in first-person.
You can also adjust the camera height for tall or short characters. The vertical height of the player's camera is controlled by the pivot point of the ViewLocator bone. Because the First-person Model mod forces the X and Z coordinates to stay at the origin, you can only modify the Y height of the view.
- In Blockbench, group your character's head, hair, hats, and face accessories under the AllHead group.
- Create or select the ViewLocator bone.
- Move the pivot point of ViewLocator up or down along the Y-axis to match your character's eye level.
Advanced Hiding with Molang
Sometimes hiding just the AllHead group is not enough—for example, if your character has high shoulder pads, a bulky collar, or floating neck ornaments that clip into the camera when looking down.
YSM provides the ysm.first_person_mod_hide Molang query to create custom visibility rules. When the player has the First-person Model mod installed and the game needs to hide the player's head, this parameter returns true (1.0); otherwise, it returns false (0.0). You can use this query in bone scale animations to shrink obstructing body parts down to zero only when necessary.
ysm.first_person_mod_hideQuestions
Why isn't my first-person arm animation playing in-game?
First, make sure you are using YSM 2.5.0 or newer and that your player's hand is completely empty, as holding any item disables first-person arm animations. Second, verify that the animated bones are strictly inside the LeftArm or RightArm groups and that the animation is named parallel0 through parallel7.
Can I pass data from my main animation to my first-person arm animation?
Yes. Roaming variables are shared between the main animation and the first-person animation, so any state stored in a roaming variable can be read by your fp_arm animations.
How do I stop my character's hat or hair from blocking the screen when using the First-person Model mod?
Place the hat, hair, and any other head accessories inside the AllHead bone group in Blockbench. YSM automatically hides everything inside AllHead when rendering the First-person Model mod perspective.
Why didn't moving ViewLocator forward or backward change my camera position?
The third-party First-person Model mod locks the X and Z coordinates to the center origin. Moving the ViewLocator pivot point only affects the vertical height (Y-axis) of the camera.