Guide · Getting started

Yes Steve Model FAQ and Common Problems

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

Mod Installation and Supported Versions

Before downloading models, make sure you are running the latest version of the mod, which is currently version 2.6.5. YSM underwent a major rewrite in version 1.2.0, meaning that almost all modern models will fail to load on version 1.1.5 or older. Furthermore, most newer community models require at least version 2.2.2 to function properly.

Because YSM was removed from CurseForge due to review issues, you should download official releases from Modrinth. When downloading, pay close attention to your mod loader so you do not mix up Forge, Fabric, and NeoForge files.

Version 2.6.5 supports Forge (1.20.1), Fabric (1.20.1, 1.21.1), and NeoForge (1.21.1, 26.1.2). If you are playing on older Minecraft versions, version 2.4.1 supports Forge (1.16.5, 1.18.2, 1.19.2, 1.20.1), Fabric (1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.21, 1.21.1), and NeoForge (1.21, 1.21.1). You can always verify your installed YSM version by checking the bottom-left corner of the in-game Select Model menu.

Always double-check that your downloaded YSM file matches both your exact Minecraft version and your mod loader (Forge, Fabric, or NeoForge).

Opening the Select Model Menu

Once in-game, you can browse and equip models through the Select Model menu. Press Alt + Y on Forge and NeoForge, or press Y on Fabric to open this interface.

If pressing the hotkey does nothing, first check Minecraft's controls settings to ensure the keybind was not changed or conflicting with another mod. If the keybind does not appear in the controls list at all, verify that you installed the correct mod loader version of YSM and that your keyboard is functioning properly.

Finding and Installing Custom Models

You can download free community models from Planet Minecraft or the GitHub free model repository (Yes-Steve-Model-Repo). Installing models locally only works for singleplayer worlds; if you play on a multiplayer server, a server operator (OP) must install the models on the server side.

Follow these steps to add new model files to your singleplayer game:

  1. Open the Select Model menu in-game using Alt + Y (Forge/NeoForge) or Y (Fabric).
  2. Click the Open Model Folder button located in the top-right corner, then click Open Model Folder again in the confirmation dialog.
  3. Place your downloaded model files directly into the system folder window that pops up.
  4. Return to your Minecraft window, open the chat, and run the reload command (requires OP permissions).
  5. Reopen the Select Model menu to view your newly added models. If you have many models, use the page buttons at the bottom to browse.
/ysm model reload
If you install a large batch of models for the first time, you might only see the default model right after reloading. Wait a moment for YSM to finish building the model cache, then reopen the menu.

Troubleshooting Missing or Unsupported Models

If you placed your files into the folder and ran /ysm model reload but still cannot find your model, check that you are playing in singleplayer and that you have updated to the latest YSM release (2.6.5). Most modern models require at least YSM 2.2.2.

If the game displays an "Unsupported ysm format version" error, it almost always means your YSM mod is outdated compared to the version the model was built for. Update YSM to 2.6.5 first; if the error persists on the latest version, you will need to contact the model creator.

Fixing Visual Glitches and Vanilla Model Rendering

Sometimes you may select a custom model, yet your character still appears as the default vanilla Steve or Alex skin. This happens when self-rendering prevention is enabled in your settings.

To fix the stuck vanilla model, follow these steps:

  1. Open the Select Model menu.
  2. Click the Open Config GUI button.
  3. Uncheck the option labeled Prevents rendering of self player's model.
If your custom model loads but looks severely distorted, scrambled, or broken, it is almost certainly caused by an incompatibility with OptiFine.

Solving OptiFine Rendering Distortion

When OptiFine is installed, custom YSM models often render with scrambled geometry or broken textures. You have two ways to solve this problem:

The recommended fix is to remove OptiFine and switch to modern shader loaders like Oculus (for Forge) or Iris (for Fabric). If you must keep OptiFine, you can enable YSM's built-in compatibility mode instead:

  1. Open the Select Model menu and click Open Config GUI.
  2. Check the box labeled Use compatibility renderer.

Customizing the Extra Player Render (Paper Doll)

YSM can display a miniature preview of your character model on your HUD, known as the extra player render. You can freely move, resize, rotate, or disable this on-screen preview so it does not block your view during gameplay.

To toggle the preview off or on, open the Select Model menu, click Open Config GUI, and check or uncheck Disable extra player render. To adjust its layout on your screen, press Alt + P (Forge/NeoForge) or P (Fabric) to open the placement screen, follow the instructions in the top-right corner to change its position, scale, and rotation, and press Esc to save and exit.

Fixing Startup Crashes and Playing on Android

If Minecraft crashes on startup with a Java error reading EXCEPTION_ILLEGAL_INSTRUCTION, your computer's CPU does not support the AVX instruction set. Starting from version 2.2.2, YSM uses AVX instructions to boost performance, which requires a CPU manufactured after 2010. To play on older hardware, you must downgrade to a YSM version older than 2.2.2 or upgrade your PC.

Starting from version 2.5.2, YSM supports Android mobile devices running Java Edition through compatible launchers: Fold Craft Launcher, Zalith Launcher, and Zalith Launcher 2. Be sure to keep your mobile launcher updated to the latest version.

For Android launcher developers: due to Android 7.0+ native library namespace isolation, YSM requires the MOD_ANDROID_RUNTIME environment variable to point to a directory in the exact same namespace as libjvm.so so that YSM's native .so libraries can load.

# Fold Craft Launcher example
MOD_ANDROID_RUNTIME=/data/user/0/com.tungsten.fcl/app_runtime_mod
JVM Library=/data/user/0/com.tungsten.fcl/app_runtime/java/jre17/lib/server/libjvm.so

# Zalith Launcher example
MOD_ANDROID_RUNTIME=/data/user/0/com.movtery.zalithlauncher/app_runtime_mod
JVM Library=/data/user/0/com.movtery.zalithlauncher/runtimes/Internal-17/lib/server/libjvm.so

Questions

Why don't my newly installed models show up in multiplayer?

Installing models into your local folder only works for singleplayer. On a multiplayer server, a server admin (OP) must install the model files onto the server and run /ysm model reload.

Why does my model look completely scrambled and glitchy?

This is caused by OptiFine. You can either uninstall OptiFine and use Iris or Oculus instead, or open the YSM Config GUI and check 'Use compatibility renderer'.

Is there a Bedrock Edition or NetEase version of Yes Steve Model?

There is no regular Bedrock Edition port, though an official NetEase Chinese Edition exists. Note that the NetEase version and Java Edition are maintained separately, so issues from one version should not be reported to the other team.

Why does my game crash with EXCEPTION_ILLEGAL_INSTRUCTION on launch?

YSM 2.2.2 and newer use the AVX CPU instruction set for performance, which requires a processor made after 2010. On older CPUs, you will need to use a YSM version prior to 2.2.2.

Next: Adding sounds to a YSM model →

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