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)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.
- Gather all your models (.ysm, .zip, .7z, or model folders) inside one main pack folder.
- Create and add at least one identifier file: ysm-pack.json or ysm-pack.png (or both).
- Compress the pack folder into a standard .zip archive.
- Place the .zip file directly into the custom or auth folder to test it in-game.
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.