Guide · Making models

Foreground and Background Images in the Model Menu

Starting 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.

Why Use Menu Images?

In older versions of YSM, creators who wanted a custom backdrop in the model selection screen had to model a flat plane behind the character and animate it to stay still. Version 2.5.0 introduces native support for 2D foreground and background images, completely replacing that old workaround.

Why it matters: Using native 2D images keeps your 3D model file clean, reduces unnecessary geometry, and ensures your card art always aligns perfectly in the GUI regardless of how the preview model rotates.

This feature requires YSM version 2.5.0 or higher. Older versions of the mod will simply ignore these settings.

Recommended Image Dimensions

Before configuring your files, you need to prepare your PNG artwork. The recommended aspect ratio and resolution for both foreground and background images is 52x90.

You can place these PNG files anywhere inside your model pack, though keeping them in a dedicated folder like textures/gui/ helps keep your project organized. Make sure your foreground image uses transparency so it does not completely cover your 3D character preview.

Configuring ysm.json

To apply your images, open your model pack's ysm.json configuration file and locate the properties object. You need to add the gui_foreground and gui_background keys inside the properties section and point them to the relative file paths of your PNG textures.

  1. Place your 52x90 PNG images into your model pack (for example, inside a textures/gui/ folder).
  2. Open ysm.json in a text editor and find the properties block.
  3. Add the gui_foreground key and set its value to your foreground image path.
  4. Add the gui_background key and set its value to your background image path.
{
  "properties": {
    "extra_animation_classify": [],
    "preview_animation": "gui",
    "disable_preview_rotation": true,
    "gui_no_lighting": false,
    "gui_foreground": "textures/gui/foreground.png",
    "gui_background": "textures/gui/background.png",
    "default_texture": "default",
    "render_layers_first": false,
    "free": true
  }
}

Combining with Other GUI Properties

As shown in the configuration example, menu images work best when paired with other preview settings inside the properties block. For instance, setting preview_animation to gui lets you pose the character specifically to fit your background art.

Additionally, enabling disable_preview_rotation prevents players from spinning the model in the menu, which is useful if your foreground and background images are drawn to match a specific camera angle.

Questions

Which version of YSM do I need for foreground and background images?

You must be using Yes Steve Model version 2.5.0 or newer. The gui_foreground and gui_background keys were added in 2.5.0.

What size should my foreground and background images be?

The official recommended resolution and aspect ratio is 52x90 pixels.

Do I still need to build a background cube inside Blockbench?

No. Since version 2.5.0, you can delete static background geometry from your 3D model and use gui_background and gui_foreground in ysm.json instead.

Next: Make YSM models with the Blockbench YSM plugin →

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
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.
M
Modeling a YSM Character Step by StepCreating a custom character for Yes Steve Model (YSM) is much easier when you understand its standardized bone and locator system. This guide explains how to use the built-in template, set up special locator groups for items and compatibility with other mods, and build first-person arm and custom arrow models.