Guide · Making models

Make YSM models with the Blockbench YSM plugin

Learning the raw Yes Steve Model (YSM) pack format manually can be complex and overwhelming for beginners. The easiest way to create YSM models is by installing the ysm-utils plugin for Blockbench, which automates the setup and export process. This guide covers how to choose, install, and update the plugin for your specific mod version.

Why Use the ysm-utils Plugin?

Building a YSM model pack from scratch requires understanding complex folder structures and configuration files. Using the official ysm-utils Blockbench plugin eliminates the need to memorize the raw model pack format, making model creation accessible to beginners.

Before starting, it is recommended to update to the latest version of Blockbench. The newest release of the plugin fully supports both Blockbench 4.x and 5.x versions, ensuring compatibility with modern modeling tools.

Always check your Blockbench version before installing plugins to avoid unexpected errors during model export.

Choose the Right Plugin Version

YSM updates frequently change how models are packaged and read by the mod. You must download the ysm-utils.js plugin version that matches the specific YSM mod version you are targeting.

Regardless of which version you download, the plugin file is always named ysm-utils.js. Below are the four version tiers available and their corresponding file details so you can verify you have the right build:

YSM 2.5.2 and later:      ysm-utils.js (approx. 2.01 MB, 2.6.0 build)
YSM 2.5.0 to 2.5.1:       ysm-utils.js (approx. 2.02 MB, 2.5.1 build)
YSM 2.2.1 to 2.4.1:       ysm-utils.js (approx. 2.11 MB, 2.2.2 build)
YSM 1.2.0 and earlier:    ysm-utils.js (approx. 520 KB, 1.2.0 build)
notice how the legacy 1.2.0 plugin is much smaller (520 KB) compared to the 2.2.1+ versions (around 2 MB), as a major format overhaul occurred starting in the 2.2.x updates.

How to Install the Plugin in Blockbench

Because the YSM plugin is distributed as a standalone JavaScript file rather than through the built-in Blockbench store, you need to load the ysm-utils.js file manually from your computer.

Do not rename the ysm-utils.js file after downloading it, as Blockbench relies on the exact file name to register and update the plugin properly. Place it in a permanent folder where it will not be accidentally deleted.

  1. Download the matching ysm-utils.js file for your YSM mod version.
  2. Move ysm-utils.js to a safe folder on your computer without changing its file name.
  3. Open Blockbench and navigate to the top menu bar.
  4. Click File -> Plugins -> Load Plugin from File.
  5. Select your saved ysm-utils.js file to complete the installation.

Verify the Installation

Once you load the file, the plugin activates immediately without needing a full system reboot. You can verify a successful installation by looking at the top menu bar in Blockbench.

If you see a new menu tab labeled YSM (or Yes! Steve Model in the localized interface) in the top bar, the plugin is loaded and ready to use. All YSM-specific model creation and export tools will be located inside this menu.

Updating the Plugin

When you upgrade your YSM mod to a newer release, you will often need to update your Blockbench plugin to match. To update the plugin, simply overwrite the old ysm-utils.js file in its folder with the newly downloaded version.

Make sure the replacement file keeps the exact name ysm-utils.js, then restart Blockbench. Upon restarting, Blockbench will automatically load the updated script from the existing file path.

If your browser automatically renames the downloaded file to something like ysm-utils (1).js, delete the extra characters before replacing your old file.

Questions

Does the YSM plugin work with Blockbench 5.x?

Yes. The latest version of the ysm-utils.js plugin fully supports both Blockbench 4.x and 5.x.

Why shouldn't I rename the ysm-utils.js file?

Blockbench tracks locally loaded plugins by their exact file path and name. Keeping the name as ysm-utils.js ensures the plugin loads properly and allows you to update it simply by replacing the file in the same folder.

How do I know if the plugin loaded properly?

Check the top menu bar of Blockbench. When a new menu item labeled 'YSM' (or 'Yes! Steve Model') appears, the plugin is active.

Which plugin file should I use for YSM 2.4.0?

You should download the plugin build made for YSM versions 2.2.1 to 2.4.1 (the 2.11 MB ysm-utils.js file).

Next: Modeling a YSM Character Step by Step →

More in Making models

M
Adding sounds to a YSM modelSince version 2.3.0, Yes Steve Model (YSM) allows you to trigger custom or vanilla Minecraft audio directly inside your animations. This guide explains how to prepare audio files, link them in Blockbench, and control playback using Molang and playback contexts introduced in 2.5.3.
M
Adding translations (multi-language) to a YSM modelSince version 2.5.0, Yes Steve Model (YSM) supports multi-language localization through simple JSON language files. This guide walks you through setting up a language folder and writing translation keys for your model's metadata, animations, textures, and configuration menus so players worldwide can understand your model.
M
Animation controllers in YSMBefore YSM 2.3.0, animation playback rules were completely hardcoded. Starting from version 2.3.0, YSM supports Bedrock Edition animation controllers, allowing model creators to customize exactly when and how animations trigger using state machines and Molang.
M
Custom Animation Wheel and Config Menus for YSM ModelsStarting from version 2.3.0, Yes Steve Model (YSM) allows model creators to expand the standard animation roulette wheel with nested sub-wheels and interactive configuration panels. By editing the ysm.json file, you can organize extra animations into categories and let players toggle model parts or adjust values using sliders, checkboxes, and radio buttons.
M
Foreground and Background Images in the Model MenuStarting from version 2.5.0, Yes Steve Model (YSM) allows you to set custom foreground and background images for your model cards in the selection menu. This feature makes it much easier to create decorative frames and backdrops without having to build static 2D planes directly inside your 3D model geometry.
M
Modeling a YSM Character Step by StepCreating a custom character for Yes Steve Model (YSM) is much easier when you understand its standardized bone and locator system. This guide explains how to use the built-in template, set up special locator groups for items and compatibility with other mods, and build first-person arm and custom arrow models.