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.
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.
- Place your 52x90 PNG images into your model pack (for example, inside a textures/gui/ folder).
- Open ysm.json in a text editor and find the properties block.
- Add the gui_foreground key and set its value to your foreground image path.
- 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.