Guide · Making models

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.

If you are working with an older YSM version prior to 2.2.1 or using a legacy model format, stick to lowercase English letters, numbers, and underscores for file names to prevent loading issues.

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.

Use solid colors or 100% fully transparent cutouts for layered clothing and hair whenever possible to ensure consistent rendering from all camera angles.

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.

  1. Open your model pack folder and locate the ysm.json definition file.
  2. Find the properties object inside the JSON structure.
  3. 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.

Next: Tools You Need to Make 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.