How to Install Yes Steve Model and Use Custom Models
Yes 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.
Client and Server Requirements
For multiplayer synchronization and full functionality, install YSM on both your game client and the dedicated server. When joining a YSM-enabled server for the first time, allow ten to twenty seconds for the server to finish sending model data to your client before opening the menu.
If you play on a server that does not have YSM installed, you can still use the mod locally. For a client-only setup, you must join a single-player world first to initialize and load your local models; only after doing this will your models render when you connect to a multiplayer server.
Supported Platforms and Java (JVM) Setup
Platform compatibility depends heavily on the version of YSM you choose to run. Versions 1.1.5 and below run across most major operating systems, including Windows, Linux, macOS, plus Android and iOS via mobile launchers like Pojav.
Starting with version 1.2.0, compatibility is currently restricted to Windows (both client and server) and Linux (server only) while support for other operating systems is being reworked.
YSM relies on native libraries that require a standard Java Virtual Machine (JVM). We recommend using Microsoft OpenJDK, though Oracle JVM, Azul Zulu, and Alibaba Cloud Dragonwell are also verified to work. Switching to one of these four distributions fixes the common native runtime crash shown below.
Exception message: java.lang.RuntimeException: err: 54Using the Model Selection GUI (Forge & NeoForge)
On Forge and NeoForge, press the default shortcut Alt + Y to open the YSM model selection screen once your models have finished synchronizing. The interface is split into three primary controls:
1. Model Grid Buttons: Click any card in the grid to apply that character model to your player. A grayed-out card indicates a locked model that you are not yet authorized to use. The number in the top-left corner of each card shows how many alternate textures (skins) that model includes.
2. Category Filter Tabs: Use the category tabs to filter the view between all installed models, models you have permission to use, and models you have bookmarked as favorites.
3. Details View Button: Open the details screen to preview animations and swap textures. Inside the middle preview viewport, left-click and drag to rotate the character, right-click and drag to pan the camera, and scroll the mouse wheel to zoom. Pick a skin from the right-hand list, or trigger animations from the left-hand list. Since version 2.2.1, an additional button in the top-left corner lets you inspect the creator's profile and credits.
Fabric Requirements and Keybind Differences
The Fabric port of YSM offers nearly identical features to the Forge edition and works smoothly alongside popular performance and rendering mods, including Sodium, Sodium Extra, Iris, Lithium, ModernFix, FerriteCore, ServerCore, Debugify, and Carpet (including its FakePlayer feature).
To launch YSM on Fabric, you must install Fabric API. If you are running a YSM release older than 2.2.1, you also need Forge Config API Port (this dependency was dropped in version 2.2.1).
Because vanilla Fabric does not natively support modifier key combinations like Ctrl, Alt, or Shift, the default menu hotkey on Fabric drops the modifier and becomes simply Y. If you want to restore the standard Alt + Y combination used on Forge, install one of the optional keybind mods below.
- Install Fabric API (required for all Fabric versions).
- Install Forge Config API Port only if you are using a YSM version prior to 2.2.1.
- Optionally install First-Person Model for improved first-person body rendering.
- Optionally install Amecs to enable Alt + Y combo hotkeys (note: Amecs conflicts with the Controlling mod).
- Alternatively, on YSM 2.2.1 or newer, install Modern KeyBinding to get Alt + Y combo hotkeys without conflicting with Controlling.
Questions
Why do my models not show up when I join a vanilla multiplayer server?
If YSM is only installed on your client, you must enter a single-player world first every time you launch the game so the mod can finish loading your models into memory before you join a server.
How do I fix 'java.lang.RuntimeException: err: 54' on startup?
This error means your current Java version is incompatible with YSM. Install Microsoft OpenJDK, Azul Zulu, Oracle JVM, or Dragonwell and point your Minecraft launcher to that Java installation.
Why does pressing Alt + Y do nothing on Fabric?
Standard Fabric does not support combination keys unless you install Amecs or Modern KeyBinding. Try pressing just the Y key by itself.
Why is a model card grayed out in the selection menu?
A gray background means the model requires authorization on that server and your player account has not been granted permission to equip it yet.
Can I run YSM 1.2.0 or newer on macOS, Linux client, or Android?
Not yet. Only YSM 1.1.5 and older support macOS, Linux clients, Android, and iOS. Starting from 1.2.0, only Windows (client and server) and Linux (server) are supported.