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.
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:
- Open the Select Model menu in-game using Alt + Y (Forge/NeoForge) or Y (Fabric).
- Click the Open Model Folder button located in the top-right corner, then click Open Model Folder again in the confirmation dialog.
- Place your downloaded model files directly into the system folder window that pops up.
- Return to your Minecraft window, open the chat, and run the reload command (requires OP permissions).
- 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 reloadTroubleshooting 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:
- Open the Select Model menu.
- Click the Open Config GUI button.
- Uncheck the option labeled Prevents rendering of self player's model.
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:
- Open the Select Model menu and click Open Config GUI.
- 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.soQuestions
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.