Guide · Getting started

YSM model formats: folder, zip and encrypted .ysm

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

Supported Bedrock File Standards

At its core, Yes Steve Model is powered by the geckolib rendering engine. Because of this foundation, your raw geometry and animation files must follow standard Minecraft Bedrock Edition specifications.

Specifically, the mod supports Bedrock Edition 1.12.0 and above for model geometry files, alongside Bedrock Edition 1.8.0 for animation files. Starting from YSM version 2.3.0, the engine also supports Bedrock Edition animation controllers and animation audio.

The Three Model Container Formats

YSM recognizes three distinct ways to package a model. All three work identically once loaded into the game, so you can choose the format that best fits your current workflow:

1. Folder format: An uncompressed folder containing your raw model files. This is the recommended format for model creators because you can edit textures, geometry, or animations directly and reload them in-game immediately for rapid testing.

2. Compressed package format (zip): A direct archive package of a model folder. This format keeps all assets inside a single file, making it convenient for sharing open-source models with other players.

3. ysm format (.ysm): An encrypted, single-file package created from a model folder. Creators use this format to distribute finished models publicly while preventing others from extracting, editing, or stealing the raw assets.

Where to Place Model Files

All model data is stored inside your Minecraft instance folder under the path config/yes_steve_model. When you launch the game with YSM installed, the mod automatically manages several subdirectories inside this folder:

• custom: Place your downloaded or created models here if you want them to be usable by anyone immediately without requiring authorization.

• auth: Place custom models here if they must be authorized before a player is allowed to equip them (commonly used on servers).

• builtin: Holds the default models bundled with the mod. Do not put your own work here, because this folder is wiped and regenerated every time the game starts.

• cache: Stores encrypted model data automatically downloaded from multiplayer servers.

• export: Receives your newly encrypted .ysm files whenever you run the in-game export command.

<Minecraft Directory>/config/yes_steve_model/
├── auth/     (Custom models requiring authorization)
├── builtin/  (Default models - wiped on every launch!)
├── cache/    (Server model cache)
├── custom/   (Custom models free for immediate use)
└── export/   (Output directory for /ysm export)
Some models have an internal setting that forbids authorization locking. Those specific models remain free for anyone to use even if you place them inside the auth folder.

Subfolders and File Naming Rules (Since 2.2.1)

In older versions of the mod, renaming files or accidentally extracting a zip inside an extra folder could prevent a model from loading. Starting from version 2.2.1, YSM automatically scans nested subfolders up to 16 layers deep inside both the custom and auth directories.

You can organize your collection into categorized subfolders, and you can freely rename archive or .ysm files using any characters—including spaces and non-English characters like Chinese—without breaking model recognition.

Exporting and Using Encrypted .ysm Models

When you finish building a model in folder format and want to protect your work before sharing, you can convert it into the encrypted ysm format using an in-game command. Keep in mind that encryption is permanent and one-way: an encrypted .ysm file cannot be converted back into a regular folder and cannot be edited again.

Starting from version 2.2.2, you can also attach custom text metadata (such as author credits or version notes) using the optional extra_info argument. When someone opens a .ysm file (exported in YSM 1.2.0 or later) in a text editor like Notepad, this header information is readable at the top of the file. However, the header is protected against tampering—if anyone edits that text in Notepad, YSM will refuse to load the file.

Also note that the .ysm format is only backward-compatible (newer mod versions can load older files, not vice versa). If you export a model using a newer version of YSM, players running an older version of the mod will not be able to load it.

  1. Place your working model folder inside config/yes_steve_model/custom (or auth) so the game loads it.
  2. Launch Minecraft, enter a world, and run the export command with your model's ID.
  3. Retrieve the generated .ysm file from config/yes_steve_model/export.
# Basic export command
/ysm export <model_id>

# Export with custom header text (since version 2.2.2)
/ysm export <model_id> [extra_info]
Always keep a backup copy of your original unencrypted model folder in a safe location outside the export directory, as you can never unpack a .ysm file once exported.

Questions

Where do I put a model I just downloaded?

Drop the folder, zip archive, or .ysm file into your game directory under config/yes_steve_model/custom. Since version 2.2.1, you can even organize them inside subfolders up to 16 levels deep.

Why did the models I put in the builtin folder disappear?

The config/yes_steve_model/builtin folder is strictly reserved for the mod's default assets. YSM deletes and regenerates this entire folder every time you launch Minecraft. Always use the custom or auth folders instead.

Can I unpack a .ysm file to edit its texture or animations?

No. The .ysm format is an encrypted distribution format. Once a folder model is exported to .ysm, it cannot be converted back into raw files or modified a second time.

Why won't my exported .ysm model load for a friend or after I edited its text?

There are two common reasons: First, the friend might be using an older version of the YSM mod than the version you used to export the file. Second, if anyone opened the .ysm file in a text editor like Notepad and altered the readable header information, the mod's integrity check will reject the file.

Next: Yes Steve Model Config File Explained →

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