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.
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)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.
- Download the matching ysm-utils.js file for your YSM mod version.
- Move ysm-utils.js to a safe folder on your computer without changing its file name.
- Open Blockbench and navigate to the top menu bar.
- Click File -> Plugins -> Load Plugin from File.
- 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.
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).