Modeling a YSM Character Step by Step
Creating a custom character for Yes Steve Model (YSM) is much easier when you understand its standardized bone and locator system. This guide explains how to use the built-in template, set up special locator groups for items and compatibility with other mods, and build first-person arm and custom arrow models.
Starting with the Default Model Template
YSM uses a standardized bone group hierarchy for its main character models. As long as you do not heavily alter the default bone structure, existing YSM animation files will remain fully compatible with your new model. This saves you from having to animate everything from scratch.
To get started, launch Minecraft once with the mod installed. YSM will automatically generate a standard reference model and its animation files inside your game directory at config\yes_steve_model\custom\default.
Core Body, Camera, and Glow Groups
YSM recognizes specific bone group names and automatically attaches game behaviors to them. Applying scale, rotation, or position animations to these special groups will directly change the size, facing direction, and placement of the rendered features in-game.
Head: The head locator group. The game automatically applies head-tracking rotation based on the player's camera view (this is a legacy feature built into the mod).
AllHead: Used for compatibility with the Real First-Person Render and Better Combat mods. Any geometry placed inside this group is automatically hidden when viewing in first-person.
ViewLocator: The camera perspective locator. When using first-person camera mods, the Y-coordinate of this group's pivot point determines the vertical height of the player's viewpoint.
ysmGlow*: Any bone group whose name starts with ysmGlow (for example, ysmGlowHead or ysmGlowRingBow) acts as an emissive glow group. It will render with a glowing effect under most shader packs. Note that this effect only applies to cubes directly inside that group, not its child groups.
Vanilla Item and Equipment Locators
For your character to hold items, wear an Elytra, or carry parrots, you must include the corresponding locator groups. If a locator group is missing from your model, that specific item or feature simply will not render in-game.
RightHandLocator: Positions the main-hand held item. Since version 2.4.0, you can append numbers 2 through 8 to the name (e.g., RightHandLocator2) to create extra item locator points.
LeftHandLocator: Positions the off-hand held item. Since version 2.4.0, this also supports numbered variants from 2 to 8.
ElytraLocator: Positions the equipped Elytra on the character's back.
LeftShoulderLocator and RightShoulderLocator: Position parrots sitting on the player's left and right shoulders.
Mod Compatibility Locators (SlashBlade, TaCZ, and Backpacks)
YSM has built-in rendering support for popular equipment mods like SlashBlade, Timeless and Classics Zero (TaCZ), and Touhou Little Maid. Adding these locators ensures weapons and backpacks attach cleanly to your character's body instead of floating or disappearing.
LeftWaistLocator: Renders the main-hand SlashBlade on the left waist (yes, main-hand goes on the left waist). It is recommended to place this at the same hierarchy level as LeftHandLocator.
RightWaistLocator: Renders the off-hand SlashBlade on the right waist.
BladeLocator (added in 2.3.0): Positions the blade of the main-hand SlashBlade for sword-drawing animations. Place this at the same hierarchy level as RightHandLocator.
SheathLocator (added in 2.3.0): Positions the scabbard of the main-hand SlashBlade for animations. Place this at the same hierarchy level as LeftHandLocator.
PistolLocator: When TaCZ is installed and the player holds a pistol in their off-hand, this renders a holstered pistol at the waist.
RifleLocator: When TaCZ is installed and the player holds a rifle or RPG in their off-hand, this renders the weapon stowed on their back.
BackpackLocator (added in 2.4.0): Positioned between the shoulders. This is used when a Touhou Little Maid wears a backpack (or equips a SlashBlade or banner in her decoration slot), and also displays modded backpacks worn by players.
Building the First-Person Arm Model
Your first-person hand model is created by adapting your main model, and both models share the exact same texture file. You can also create a group named Background in the root directory to render persistent background elements in first-person view, which stay visible regardless of held items or player actions.
- Create a new, blank project in Blockbench.
- Open your main character model, copy ONLY the LeftArm and RightArm groups, and paste them directly into the root directory of your new project.
- Set the X, Y, and Z rotation values of both the LeftArm and RightArm root groups to 0 (do not change the rotations of any sub-groups inside them). Once zeroed out, both arms should point straight down.
Creating a Custom Arrow Model
Since version 1.2.0, YSM allows you to include a custom projectile model for arrows. When a player switches to your character model, any arrows or crossbow bolts they fire will automatically use your custom arrow model. If you do not provide one, the game falls back to the vanilla Minecraft arrow.
When modeling your custom arrow in Blockbench, pay strict attention to its orientation: when looking at the model from the Front view in Blockbench, the tip of the arrow must point to the left.
Questions
Why aren't my character's held items or Elytra showing up in-game?
YSM relies on exact bone group names to render equipment. If your model is missing RightHandLocator, LeftHandLocator, or ElytraLocator, the game will not render main-hand items, off-hand items, or the Elytra.
How do I make parts of my model glow when using shaders?
Place the glowing cubes inside a bone group whose name starts with ysmGlow (such as ysmGlowEyes or ysmGlowHead). Keep in mind that the glow only applies to geometry directly inside that group, not inside child sub-groups.
Why does my main-hand SlashBlade disappear during animations?
Since version 2.3.0, SlashBlade animations require both BladeLocator (placed at the same level as RightHandLocator) and SheathLocator (placed at the same level as LeftHandLocator), in addition to LeftWaistLocator.
My first-person hands look awkward when holding guns from TaCZ. How do I fix it?
Open your first-person arm model in Blockbench, shift both the LeftArm and RightArm groups slightly downward, and move them closer together toward the center.