Guide · Making models

Packaging and Exporting a YSM Model Pack

Starting from version 2.5.0, Yes Steve Model allows you to group multiple models together into organized model packs. Packaging your models makes it much easier to categorize your collection in-game and share bundles with other players without requiring them to extract files.

What is a Model Pack?

Available since version 2.5.0, YSM can read models placed inside subfolders and treat them as a single model pack. When you load the game, any pack folder you create will appear as its own separate category directory in the model selection menu.

This feature is ideal for creators releasing themed collections or players trying to keep dozens of downloaded models tidy. Instead of scrolling through one massive list, you can browse clean, categorized folders.

Model Pack Folder Structure

To create a model pack, make a new subfolder inside your custom or auth directory and place your models inside it. A single pack can hold a mix of different model formats, including raw model folders, .ysm files, .zip archives, and .7z archives.

You can also include two optional metadata files in the root of your pack folder: ysm-pack.json for text details and ysm-pack.png for the cover art.

custom (or auth)
└── My_Model_Pack/
    ├── Model_1/
    ├── Model_2.ysm
    ├── Model_3.zip
    ├── Model_4.7z
    ├── ysm-pack.json  (optional metadata)
    └── ysm-pack.png   (optional cover icon)
If you do not include a ysm-pack.json file, the game will simply use the folder's name as the pack title.

Configuring ysm-pack.json

The ysm-pack.json file defines your pack's display name and description inside the YSM menu. Setting this up gives your pack a clean, professional title instead of showing a raw folder name.

You can also add an optional lang object to provide translations for different Minecraft language settings. If a player's current language is not listed under lang, YSM falls back to the top-level name and description fields.

{
  "name": "Wine Fox & Friends",
  "description": "Cute Wine Fox and her friends",
  "lang": {
    "zh_cn": {
      "name": "酒狐与小伙伴",
      "description": "可爱酒狐和她的小伙伴们"
    }
  }
}

Adding a Pack Cover Icon

You can give your model pack a custom thumbnail in the selection menu by placing an image named ysm-pack.png inside the pack folder. If you skip this file, YSM will automatically display its built-in default cover.

Your cover image must use an aspect ratio of 52:90 (width to height). Make sure to crop or resize your artwork to match these proportions before saving, because any image that does not follow the 52:90 ratio will be forcibly stretched by the game.

Zipping a Pack for Distribution

You can compress your entire model pack folder into a single .zip file so other players can install it directly without extracting it. This is the recommended way to share multi-model bundles online.

However, for YSM to recognize a .zip archive as a model pack rather than a single zip-formatted model, the archive must contain either ysm-pack.json or ysm-pack.png.

  1. Gather all your models (.ysm, .zip, .7z, or model folders) inside one main pack folder.
  2. Create and add at least one identifier file: ysm-pack.json or ysm-pack.png (or both).
  3. Compress the pack folder into a standard .zip archive.
  4. Place the .zip file directly into the custom or auth folder to test it in-game.
When zipping your pack for sharing, including ysm-pack.json or ysm-pack.png is mandatory—they are no longer optional for zipped packs.

Questions

Why isn't my zipped model pack showing up in the game?

Check two things: first, make sure you are running YSM version 2.5.0 or newer. Second, when a model pack is compressed into a .zip file, it is required to contain either ysm-pack.json or ysm-pack.png so the mod knows it is a pack.

Why does my ysm-pack.png cover image look distorted?

YSM requires pack cover icons to have a 52:90 width-to-height aspect ratio (for example, 520x900 pixels). Any image with different proportions is automatically stretched to fit the slot.

Can I mix .ysm files and .zip models inside the same model pack?

Yes. A single model pack folder can simultaneously hold uncompressed model folders, .ysm files, .zip archives, and .7z archives.

What happens if I leave out both ysm-pack.json and ysm-pack.png?

If your pack is an uncompressed folder inside custom or auth, it will still work normally—YSM will just use the folder name as the title and show a default cover image. However, if you zip the folder for distribution, leaving both files out will prevent it from working as a pack.

Next: Painting textures for a YSM model →

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
Make YSM models with the Blockbench YSM pluginLearning 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.