Guide · Animation

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.

  1. Open your model's ysm.json file.
  2. Locate the files object, and then find the animation section inside it.
  3. 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"
    }
  }
}
You do not need to include every optional compatibility animation (like tac or parcool) in ysm.json—only add fp_arm alongside the animation files your model actually uses.

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, parallel7

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

Double-check your Blockbench bone hierarchy to ensure sleeves, bracelets, or hand accessories are child bones of LeftArm or RightArm.

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.

  1. In Blockbench, group your character's head, hair, hats, and face accessories under the AllHead group.
  2. Create or select the ViewLocator bone.
  3. 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_hide
Use ysm.first_person_mod_hide in a parallel animation to scale collars or chest accessories to 0 when it returns true, keeping the player's view completely clear.

Questions

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.

Next: Hand Condition Animations (Items in Hand) →

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
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.
A
Parallel animations (blinking, ears, hair physics)Parallel animations in Yes Steve Model (YSM) allow you to run continuous background effects like blinking, ear twitches, or tail wagging alongside standard player actions. These animations loop independently of the main movement states, bringing your character to life without getting interrupted when the player walks, sprints, or attacks.