Guide · Making models

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.

The files in the default folder are released under the CC0 license, meaning you are completely free to modify, reuse, and redistribute them in your own model packs.

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.

  1. Create a new, blank project in Blockbench.
  2. Open your main character model, copy ONLY the LeftArm and RightArm groups, and paste them directly into the root directory of your new project.
  3. 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.
The Background group in the first-person arm model does not currently support Bedrock Edition animations. Also, if you use TaCZ and the hands look misaligned while holding guns, move both arms slightly downward and closer toward the center.

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.

Next: PBR textures (specular and normal maps) for YSM →

More in Making models

M
Adding sounds to a YSM modelSince version 2.3.0, Yes Steve Model (YSM) allows you to trigger custom or vanilla Minecraft audio directly inside your animations. This guide explains how to prepare audio files, link them in Blockbench, and control playback using Molang and playback contexts introduced in 2.5.3.
M
Adding translations (multi-language) to a YSM modelSince version 2.5.0, Yes Steve Model (YSM) supports multi-language localization through simple JSON language files. This guide walks you through setting up a language folder and writing translation keys for your model's metadata, animations, textures, and configuration menus so players worldwide can understand your model.
M
Animation controllers in YSMBefore YSM 2.3.0, animation playback rules were completely hardcoded. Starting from version 2.3.0, YSM supports Bedrock Edition animation controllers, allowing model creators to customize exactly when and how animations trigger using state machines and Molang.
M
Custom Animation Wheel and Config Menus for YSM ModelsStarting from version 2.3.0, Yes Steve Model (YSM) allows model creators to expand the standard animation roulette wheel with nested sub-wheels and interactive configuration panels. By editing the ysm.json file, you can organize extra animations into categories and let players toggle model parts or adjust values using sliders, checkboxes, and radio buttons.
M
Foreground and Background Images in the Model MenuStarting from version 2.5.0, Yes Steve Model (YSM) allows you to set custom foreground and background images for your model cards in the selection menu. This feature makes it much easier to create decorative frames and backdrops without having to build static 2D planes directly inside your 3D model geometry.
M
Make YSM models with the Blockbench YSM pluginLearning the raw Yes Steve Model (YSM) pack format manually can be complex and overwhelming for beginners. The easiest way to create YSM models is by installing the ysm-utils plugin for Blockbench, which automates the setup and export process. This guide covers how to choose, install, and update the plugin for your specific mod version.