Guide · Getting started

What is Yes Steve Model? Features and how it works

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

Core Gameplay and Server Features

YSM automatically synchronizes models from the server to connecting clients, meaning players do not need to manually download model packs before joining a multiplayer world. To protect creators' work, every model sent to a client is converted into an encrypted binary file to prevent model theft.

Server operators can lock specific models behind permissions so that a restricted character can only be equipped after an OP grants authorization via command.

For everyday gameplay, YSM includes upgraded default Steve and Alex models that automatically apply your vanilla Minecraft skin texture. Pressing the Z key opens an in-game animation roulette wheel, letting you trigger custom emotes, facial expressions, and poses on demand.

You can also apply YSM models and animations to NPC maids by combining Yes Steve Model 2.4.0 or newer with the Touhou Little Maid mod version 1.2.0 or newer.

Press the Z key in-game to open the animation wheel and test built-in emotes on the default Steve or Alex model.

Supported Minecraft Versions and Mod Loaders

The latest release of Yes Steve Model is version 2.6.5, which focuses on modern Minecraft releases and supports five loader setups: Forge on 1.20.1, Fabric on 1.20.1 and 1.21.1, and NeoForge on 1.21.1 and 26.1.2.

If you play on older Minecraft versions, YSM 2.4.1 covers twelve legacy and modern configurations. On Forge, 2.4.1 works with 1.16.5, 1.18.2, 1.19.2, and 1.20.1. On Fabric, it runs on those same four versions plus 1.21 and 1.21.1. On NeoForge, 2.4.1 supports 1.21 and 1.21.1.

Combat, Movement, and Action Mod Integrations

YSM integrates deeply with popular combat and movement mods so your custom model reacts naturally to modded items. If you are building your own model, you can inspect the default model's animation JSON files to see the exact animation names required for each integration.

For firearms and modern combat, YSM animates gun holding, aiming, firing, and reloading for Timeless and Classic Guns (TAC on 1.16.5 and 1.18.2 Forge), Timeless and Classics Zero (TACZ on 1.18.2, 1.19.2, and 1.20.1 Forge), and Superb Warfare (which also includes grenade throwing).

For melee and magic combat, YSM supports Better Combat attack animations and Iron's Spells 'n Spellbooks casting animations. It also renders main-hand and off-hand katanas from SlashBlade (including SlashBlade: Resharped since 2.2.1, 33 dedicated animations in slashblade.animation.json since 2.3.0, and Japanese blade addon skills since 2.4.0).

For movement and roleplay, YSM includes dedicated animation sets for parkour, riding, and maids. Model creators can reference parcool.animation.json (35 animations for Parcool), swem.animation.json (11 animations for SWEM equestrian riding), and tlm.animation.json (15 animations for Touhou Little Maid).

slashblade.animation.json  -> 33 animations for SlashBlade (since YSM 2.3.0)
swem.animation.json        -> 11 animations for SWEM (Equestrian)
parcool.animation.json     -> 35 animations for Parcool
tlm.animation.json         -> 15 animations for Touhou Little Maid
If you use Timeless and Classic Guns (TAC) on 1.16.5 or 1.18.2 Forge, you must install TAC version 0.3.7 or newer, otherwise holding a gun will crash the game.

Visual, Camera, and Utility Mod Compatibility

Beyond combat, YSM works with several visual, inventory, and world interaction mods to keep your character looking consistent in every situation.

Interactive world animations work out of the box with Carry On, Create, and Immersive Melodies. Your character will play carrying poses when picking up blocks, entities, or other players (on 1.19.2 and 1.20) with Carry On, hang properly from moving chains in Create, and play instruments with Immersive Melodies.

Equipment and shader mods are also supported: YSM renders backpacks from Sophisticated Backpacks, reads armor and elytra slots from Cosmetic Armor Reworked, supports PBR shader materials in Oculus (Forge) and Iris (Fabric), and renders on fake players spawned by Carpet or Curtain.

Camera mods like Real Camera and First-person Model are compatible with YSM so you can see your custom body in first-person view, though First-person Model may still exhibit minor visual glitches.

Operating System and Hardware Support

Starting from YSM 1.2.0, the core rendering and encryption engine was rewritten in C++ after the pure-Java encryption used in 1.1.5 and earlier was cracked. This native C++ core significantly boosts frame rates and model security, but restricts which operating systems can run the mod.

Windows (AMD64) and Linux (AMD64) support both client and server installations, while Android (AArch64) supports the client only. Neither Intel-based nor Apple Silicon macOS devices are supported on client or server.

Windows AMD64         -> Client: Yes | Server: Yes
Linux AMD64           -> Client: Yes | Server: Yes
Android AArch64       -> Client: Yes | Server: No
macOS (Intel / M-chip)-> Client: No  | Server: No

Questions

Do players on my server need to download model files manually?

No. When a player joins a server running Yes Steve Model, the server automatically synchronizes the encrypted binary model files to their client.

Can I run Yes Steve Model on a Mac?

No. Since version 1.2.0, YSM uses a native C++ engine for rendering and encryption, which does not support macOS on either Intel or Apple Silicon processors.

Why does my game crash when holding a gun with the TAC mod?

On 1.16.5 and 1.18.2 Forge, you must use Timeless and Classic Guns (TAC) version 0.3.7 or higher. Older versions of TAC cause a crash when equipping a firearm with YSM installed.

How do I use YSM models on Touhou Little Maid NPCs?

Install Yes Steve Model version 2.4.0 or newer alongside Touhou Little Maid version 1.2.0 or newer. You can then assign YSM models and their 15 dedicated maid animations (found in tlm.animation.json) to your maids.

Next: YSM model formats: folder, zip and encrypted .ysm →

More in 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.
S
How 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.
S
Using 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.
S
YSM 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.
S
Yes 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.
S
Yes 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.