How to make YSM models
A full course on Yes Steve Model: install and use models, build your own character in Blockbench, write ysm.json, animate it, add sounds and translations, use Molang, and support other mods.
Getting started
S
All Yes Steve Model Commands (/ysm and /ysmclient)Yes Steve Model includes built-in commands for managing player models, handling server permissions, and debugging animations. Most server commands start with /ysm and require OP permission level 2, while client-side creator tools use /ysmclient. Every command supports in-game auto-completion for player names and model IDs.
SHow to Install Yes Steve Model and Use Custom ModelsYes Steve Model (YSM) replaces the default Minecraft player avatar with custom models and animations. To unlock its full feature set, you must install the mod on both the client and the server, though a client-only workaround exists for vanilla servers.
SUsing YSM models on a server (Freesia plugin)Freesia is an open-source proxy plugin that enables plugin-based Minecraft servers (such as Paper or Spigot networks) to support the Yes Steve Model (YSM) mod. Because YSM normally requires a modded server to handle model synchronization and data generation, Freesia bridges the gap by routing YSM network traffic through a Velocity proxy and a lightweight background Fabric server. Please note that Freesia is a community project licensed under the Mozilla Public License 2.0, not an official YSM release.
SWhat is Yes Steve Model? Features and how it worksYes Steve Model (YSM) is a Minecraft mod that replaces the vanilla player avatar with custom Minecraft Bedrock Edition models and animations. Designed with multiplayer servers in mind, it combines high-performance rendering with built-in model synchronization and file encryption. Whether you want expressive emotes, custom character designs, or third-party combat animations, YSM provides a complete framework for players and creators.
SYSM model formats: folder, zip and encrypted .ysmYes Steve Model (YSM) loads custom player models in three different container formats: unpacked folders, compressed archives, and encrypted .ysm files. Understanding how each format works and where to place your files inside the game directory is the essential first step for both players installing models and creators distributing them.
SYes Steve Model Config File ExplainedYes Steve Model (YSM) provides both an in-game settings menu and TOML configuration files so players can tweak visual settings and administrators can manage server performance. Understanding where these files live and what each setting does helps you fix rendering glitches, hide default models, and control server bandwidth.
SYes Steve Model FAQ and Common ProblemsThis troubleshooting guide covers everything a beginner needs to know to install, configure, and fix Yes Steve Model (YSM) for Minecraft Java Edition. From adding custom models to solving rendering glitches and crashes, follow these steps to get your character models working smoothly.
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.
MAdding 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.
MAnimation 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.
MCustom 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.
MForeground 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.
MMake 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.
MModeling a YSM Character Step by StepCreating 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.
MPBR textures (specular and normal maps) for YSMYes Steve Model (YSM) supports Physically Based Rendering (PBR) textures when paired with shader mods like Oculus (Forge) or Iris (Fabric). PBR textures let you control surface properties like smoothness, metallic reflections, emissive brightness, and surface depth directly through extra image files. This guide walks you through what PBR channels do, how to prepare your palette, and how to paint specular maps in Blockbench.
MPackaging and Exporting a YSM Model PackStarting from version 2.5.0, Yes Steve Model allows you to group multiple models together into organized model packs. Packaging your models makes it much easier to categorize your collection in-game and share bundles with other players without requiring them to extract files.
MPainting textures for a YSM modelTextures bring your custom Yes Steve Model (YSM) character to life by defining its colors and surface details. This guide covers the required file formats, naming rules, and transparency limitations you need to know before painting. You will also learn how to assign a default texture when your model includes multiple outfit variations.
MTools You Need to Make a YSM ModelBefore creating your first custom character for the Yes Steve Model (YSM) mod, you need to set up your workspace. Gathering the right software and understanding a few modeling basics will save you hours of troubleshooting later. This guide covers every required and optional tool you need to build, texture, and test YSM model packs.
MYSM Model Pack Structure and ysm.json ExplainedEvery Yes Steve Model (YSM) pack starts as an organized folder of geometry, animations, textures, and sounds. Since version 2.2.1, the entire pack is indexed by a single descriptor file named ysm.json, giving creators complete freedom over file names, subfolder organization, and advanced features like PBR textures and config menus.
MYSM Model UV Rules and StandardsBlockbench handles texture mapping in ways that can cause visual glitches inside Minecraft. Starting with YSM 2.6.0, you must follow strict UV rules regarding coordinate alignment and minimum face sizes to guarantee your models render accurately in-game.
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.
AArrow 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.
AExtra 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.
AFirst-Person Arm Animations and Mod CompatibilityYes 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.
AHand 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.
AModel 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.
AParallel 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.
APlayer main animations (idle, walk, run, jump...)Every custom model in Yes Steve Model relies on a core set of animations to react to everyday Minecraft gameplay. These main player animations are stored in the main.animation.json file by default and control everything from walking and jumping to riding mounts and using items. Understanding the exact animation names and their playback rules ensures your character moves naturally in every in-game situation.
ARiding 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.
AYSM Animation Overview: Getting Started & PrerequisitesCustom animations bring your Yes Steve Model (YSM) characters to life, though animation files are completely optional because YSM automatically falls back to default animations when custom ones are missing. This guide covers how animation fallback works, compatibility rules, and the tools and knowledge you need before animating your first model.
Mod compatibility
C
Better Combat Animations in Yes Steve ModelStarting from version 2.6.0, Yes Steve Model (YSM) features improved compatibility with the Better Combat mod. Weapon swings now properly trigger YSM animations without first-person head clipping issues, and creators can use new Molang variables to build custom, dynamic combat animation controllers.
CCarry On Mod Compatibility AnimationsYes Steve Model (YSM) includes built-in animation support for the popular Carry On mod, which lets players pick up blocks, mobs, and other players by holding Shift and right-clicking. By adding a dedicated animation file to your model pack, you can create custom poses for both the carrier and the player being carried.
CGun animations for TaCZ and Superb WarfareYes Steve Model includes built-in animation support for popular firearm mods, allowing your custom character models to hold, aim, reload, and fire weapons naturally. All gun animations are stored in a dedicated tac.animation.json file and use a split upper-body and lower-body system to save you animation work.
CImmersive Melodies Instrument AnimationsSince version 2.6.0, Yes Steve Model (YSM) includes deep integration with the Immersive Melodies mod. This feature allows your custom character models to react dynamically to live performance data, such as note pitch, volume, and timing. By setting up these animations, your model can realistically strum, blow, or strike instruments in sync with the music.
CIron's Spells 'n Spellbooks AnimationsSince version 2.6.0, Yes Steve Model (YSM) supports custom spellcasting animations for the Iron's Spells 'n Spellbooks mod. By linking a dedicated animation file in your model configuration, your character can perform unique movements for projectiles, slashes, and long chants. This guide covers how to register the animation file and lists every available spell animation trigger.
CParCool Parkour AnimationsYes Steve Model (YSM) includes built-in compatibility for the ParCool mod starting since version 2.2.2, allowing custom models to display dynamic parkour movements. By linking a dedicated animation file in your configuration, you can customize wall runs, vaults, rolls, and flips to fit your character's unique proportions.
CSlashBlade Animations GuideStarting from version 2.3.0, Yes Steve Model (YSM) includes native animation compatibility for the SlashBlade mod, supporting both the legacy SlashBlade and SlashBlade: Resharped. This guide covers how to set up the required bone locators in your model, register the animation file in your configuration, and use in-game debugging tools to identify specific sword skill animation names.
CTouhou Little Maid AnimationsStarting from YSM version 2.4.0, you can apply YSM character models directly to maids from the Touhou Little Maid mod. This guide covers how to set up backpack attachment points, register the maid animation file in your configuration, and create custom poses for maid-specific interactions like riding brooms, playing board games, and sitting on cushions.
Molang
λ
Common Molang Snippets and Tricks for YSM ModelsMolang expressions let your Yes Steve Model (YSM) react dynamically to in-game player states without complex keyframe animations. This guide covers ready-to-use Molang snippets for Blockbench debugging, armor-based outfit toggling, eye tracking, automatic blinking, and glowing bone groups.
λCustom Molang Functions in YSMIntroduced in version 2.5.0, custom Molang functions allow model creators to write reusable scripts, respond to entity events, synchronize data across multiplayer servers, and directly override animation controllers. Instead of repeating long Molang expressions inside your animation files, you can organize your logic into clean, standalone script files.
λMolang Tips, Extra Queries, and Version Features in YSMYes Steve Model (YSM) extends standard Bedrock Molang with dozens of custom queries for checking equipment, weather, bones, Touhou Little Maid states, and Curios/Trinkets. This guide covers all extra YSM Molang variables and functions across versions 1.2.0 to 2.5.0, plus important Minecraft version compatibility warnings.
λMolang Variables in YSM: Complete Beginner GuideMolang variables allow your Yes Steve Model (YSM) creations to dynamically react to in-game player actions, such as looking around, walking, or taking damage. By reading and storing data like movement speed or health, you can create natural physics and responsive animations for your custom models.
λMolang in YSM: IntroductionMolang is a simple expression language originally created by Mojang for Minecraft Bedrock Edition animations. In Yes Steve Model (YSM), it allows creators to replace static keyframe numbers with dynamic logic that reacts to in-game player actions. This guide covers how Molang works in YSM, practical animation examples, persistent variables, and in-game debugging commands.
Converting
T
Convert Models Between Yes Steve Model and Touhou Little MaidStarting from version 1.1.3, the Touhou Little Maid (TLM) mod natively supports unencrypted Yes Steve Model (YSM) geometry and animation files. This guide explains the shared locator bones, animation differences, and Molang variables you need to know when adapting models between the two mods.
TYSM for Minecraft China Edition (NetEase)Learn how to convert your Java Edition Yes Steve Model (YSM) packs into Bedrock add-ons for the Minecraft China Edition (NetEase). This guide covers the required conversion tools, Blockbench plugin setup, testing in the Developer Launcher, and fixing common animation issues.