Guide · Getting started

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.

Model sync time when joining a server depends on how many custom models the server hosts.

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: 54
If your game crashes on startup with err: 54, change your launcher's Java executable path to Microsoft OpenJDK.

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

  1. Install Fabric API (required for all Fabric versions).
  2. Install Forge Config API Port only if you are using a YSM version prior to 2.2.1.
  3. Optionally install First-Person Model for improved first-person body rendering.
  4. Optionally install Amecs to enable Alt + Y combo hotkeys (note: Amecs conflicts with the Controlling mod).
  5. Alternatively, on YSM 2.2.1 or newer, install Modern KeyBinding to get Alt + Y combo hotkeys without conflicting with Controlling.
Without Amecs or Modern KeyBinding installed on Fabric, just press Y by itself to open the model menu.

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.

Next: Using YSM models on a server (Freesia plugin) →

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