Painting textures for a YSM model
Textures bring your custom Yes Steve Model (YSM) character to life by defining its colors and surface details. This guide covers the required file formats, naming rules, and transparency limitations you need to know before painting. You will also learn how to assign a default texture when your model includes multiple outfit variations.
Texture Format and File Naming
Every texture you create for a YSM model must be saved in the png file format. Other image formats like JPEG or WebP are not supported by the mod and will fail to load in Minecraft.
If you are using the new model format introduced since version 2.2.1, there are no restrictions on texture file names. You are free to use any characters in your png file names, which makes organizing multiple outfits or color variations much simpler.
Avoiding Semi-Transparency Rendering Issues
When painting your model, you should minimize the use of semi-transparent pixels on your texture. While full transparency (completely invisible pixels used for cutouts) works reliably, partial opacity can cause visual glitches in Minecraft's rendering engine.
This matters most when your model has multiple overlapping cubes or layers, such as hair strands over a face or a sheer cape over armor. Stacking multiple layers of semi-transparent textures often leads to rendering errors, where surfaces behind the texture may flicker or turn completely invisible in-game.
Setting a Default Texture in ysm.json
Many creators paint multiple textures for a single model to give players different outfits, skins, or color schemes. When a model pack includes several textures, you should specify which texture appears first in the in-game model selection menu.
To set this manually, open your model's definition file named ysm.json. Locate the properties section and set the default_texture key todesignate your preferred starting texture.
- Open your model pack folder and locate the ysm.json definition file.
- Find the properties object inside the JSON structure.
- Update the default_texture field to point to your primary png texture file.
{
"properties": {
"default_texture": "default.png"
}
}Choosing the Default Texture in Blockbench
If you are creating or exporting your model using the official YSM Blockbench plugin, you do not need to edit the ysm.json code by hand. You can select the default texture directly inside the Blockbench plugin interface, and the tool will automatically write the default_texture entry for you upon export.
Questions
What image format is required for YSM textures?
All model textures must be saved in the png format.
Why do parts of my model disappear when looking through translucent hair or clothes?
Layered semi-transparent textures can cause sorting and rendering glitches in Minecraft. Reduce or remove semi-transparent pixels on overlapping geometry to fix the issue.
Can I use spaces or non-English characters in my texture file names?
Yes, since YSM version 2.2.1, any characters are allowed in texture names as long as your model uses the new YSM format.
How do I choose which outfit shows up first when a player selects my model?
Set the default_texture field inside the properties section of your ysm.json file, or select the default texture directly through the YSM Blockbench plugin.