Guide · Getting started

Yes Steve Model Config File Explained

Yes Steve Model (YSM) provides both an in-game settings menu and TOML configuration files so players can tweak visual settings and administrators can manage server performance. Understanding where these files live and what each setting does helps you fix rendering glitches, hide default models, and control server bandwidth.

In-Game Client Settings

Most players do not need to edit text files directly because client options can be changed inside the game. Open the model selection screen and click the settings button in the top-right corner to access the configuration GUI.

If you want to customize the paper doll (the extra player preview in the top-left corner of your HUD), press the Alt + P shortcut key to open its position and scale controls.

If Alt + P does nothing, check your Minecraft Controls menu for keybinding conflicts.

Where Config Files Are Located

YSM splits its settings across two locations depending on your mod version. Knowing which file to edit depends on whether you run version 2.2.2 or 2.3.0+.

In all versions, global and client settings are stored in config/yes_steve_model-common.toml (or config/yes_steve_model-client.toml depending on the build). In YSM 2.2.2 and earlier, server rules were also inside this file.

Starting in version 2.3.0, server-specific settings moved to Save Directory/serverconfig/yes_steve_model-server.toml inside your world folder. Changes to this server file hot-reload automatically without restarting the server.

General Client Settings ([general])

The [general] section controls how models, hands, projectiles, and sounds render on your client. Toggling these options is useful if you want to boost FPS or troubleshoot visual bugs with shaders and OptiFine.

Notice that SoundVolume was added in version 2.3.0 to control custom audio played by model animations, while older versions also include options like DisableArrowsModel alongside projectile and vehicle toggles.

[general]
	# Whether to display the disclaimer GUI
	DisclaimerShow = false
	# Whether to print animation roulette play messages in chat
	PrintAnimationRouletteMsg = false
	# Prevents rendering of your own YSM model
	DisableSelfModel = false
	# Prevents rendering of other players' YSM models
	DisableOtherModel = false
	# Prevents rendering of your first-person YSM hand
	DisableSelfHands = false
	# Prevents rendering of YSM arrow replacement models
	DisableArrowsModel = false
	# Default model ID and texture given to a player joining for the first time (pre-2.3.0)
	DefaultModelId = "default"
	DefaultModelTexture = "default"
	# Turn this on if rendering errors occur (e.g., when using OptiFine)
	UseCompatibilityRenderer = false
	# Global volume when animation sounds play (Added in 2.3.0, Range: 0.0 ~ 100.0)
	SoundVolume = 100.0
	# Prevents rendering of YSM projectile and vehicle replacement models
	DisableProjectileModel = false
	DisableVehicleModel = false
	# Display raw model ID first in the selection screen instead of the author's model name
	ShowModelIdFirst = false
Enable UseCompatibilityRenderer if your model turns invisible or glitches when using OptiFine.

Paper Doll & Loading Screen Settings

Below the general section, [extra_player_render] stores the exact screen coordinates, scale, and rotation of the HUD paper doll. These are the same values modified when you use the Alt + P menu in-game.

The [loading_state_screen] section controls the model synchronization status overlay. You can hide the loading toast completely or anchor it to any of the six screen positions.

[extra_player_render]
	# Whether to disable the extra player HUD render
	DisablePlayerRender = false
	# Screen X and Y coordinates (Range: > 0)
	PlayerPosX = 10
	PlayerPosY = 10
	# Display scale on screen (Range: 8.0 ~ 360.0)
	PlayerScale = 40.0
	# Rotation yaw offset (Range: 4.9E-324 ~ 1.7976931348623157E308)
	PlayerYawOffset = 5.0

[loading_state_screen]
	# Whether to disable the loading state overlay
	DisableLoadingStateScreen = false
	# Allowed Values: TOP_LEFT, TOP_CENTER, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT
	LoadingStatePosition = "TOP_CENTER"

Server Model Access & Defaults

At the top of Save Directory/serverconfig/yes_steve_model-server.toml (since 2.3.0), server owners can decide which model new players spawn with and whether players are allowed to open the GUI to switch models freely.

Version 2.3.0 also introduced ClientNotDisplayModels, which lets you hide specific built-in or server models from the client selection screen without deleting their files.

# The default model ID when a player first enters the game
DefaultModelId = "default"
# The default model texture name when a player first enters the game
DefaultModelTexture = "default"
# Whether players are allowed to freely switch models
CanSwitchModel = true
# Models hidden from the client selection screen (Added in 2.3.0)
# Example: ["default", "misc_3_default_boy", "misc_1_alex", "misc_2_steve", "wine_fox_1_taisho_maid", "wine_fox_7_jk"]
ClientNotDisplayModels = []

Server Bandwidth & Sync Scheduler ([server_scheduler])

Because YSM sends encrypted model packages to connected players, the [server_scheduler] section is critical for multiplayer performance. It controls how many CPU threads process models and caps the upload bandwidth per player.

For large servers, LowBandwidthUsage and AcceptSoundFX help reduce network traffic and client RAM usage. Note that changing AcceptSoundFX requires reloading models to take effect; raising the value will not force a resync, but lowering it will trigger a model resynchronization.

[server_scheduler]
	# Thread count for processing models. 0 means AUTO (Range: 0 ~ CPU core count)
	ThreadCount = 0
	# Bandwidth limit per player when distributing models, in Mbps (Range: 1 ~ 999)
	BandwidthLimit = 5
	# Timeout in seconds for player sync response. Value < 10 means AUTO (Range: 0 ~ 120)
	PlayerSyncTimeout = 0
	# Suppress partial network sync to save bandwidth (only effective with large player counts)
	LowBandwidthUsage = false
	# Skip sound effect processing to reduce server bandwidth and client memory (Range: 0 ~ 2)
	# 0: Accept all sounds (Default)
	# 1: Accept short sounds only (< 4 seconds and < 40 KB)
	# 2: Reject all sounds (Not recommended)
	AcceptSoundFX = 0
You do not need to restart the server after editing yes_steve_model-server.toml; it hot-reloads automatically.

Questions

Why can't I find yes_steve_model-server.toml in my main config folder?

Starting in YSM 2.3.0, server settings are stored per-world inside your world save folder at Save Directory/serverconfig/yes_steve_model-server.toml. If you are on version 2.2.2 or older, those settings are inside config/yes_steve_model-common.toml.

How do I move or turn off the mini player model in the top-left corner?

Press Alt + P in-game to adjust it visually, or set DisablePlayerRender = true under [extra_player_render] in your client config file.

How can I hide the default models on my server without deleting them?

In YSM 2.3.0+, add their model IDs to the ClientNotDisplayModels list in yes_steve_model-server.toml, for example: ["default", "misc_1_alex", "misc_2_steve"].

What should I do if my model glitches when using OptiFine?

Open the client configuration and set UseCompatibilityRenderer = true under the [general] section.

Next: Yes Steve Model FAQ and Common Problems →

More in Getting started

S
All Yes Steve Model Commands (/ysm and /ysmclient)Yes Steve Model includes built-in commands for managing player models, handling server permissions, and debugging animations. Most server commands start with /ysm and require OP permission level 2, while client-side creator tools use /ysmclient. Every command supports in-game auto-completion for player names and model IDs.
S
How to Install Yes Steve Model and Use Custom ModelsYes Steve Model (YSM) replaces the default Minecraft player avatar with custom models and animations. To unlock its full feature set, you must install the mod on both the client and the server, though a client-only workaround exists for vanilla servers.
S
Using YSM models on a server (Freesia plugin)Freesia is an open-source proxy plugin that enables plugin-based Minecraft servers (such as Paper or Spigot networks) to support the Yes Steve Model (YSM) mod. Because YSM normally requires a modded server to handle model synchronization and data generation, Freesia bridges the gap by routing YSM network traffic through a Velocity proxy and a lightweight background Fabric server. Please note that Freesia is a community project licensed under the Mozilla Public License 2.0, not an official YSM release.
S
What is Yes Steve Model? Features and how it worksYes Steve Model (YSM) is a Minecraft mod that replaces the vanilla player avatar with custom Minecraft Bedrock Edition models and animations. Designed with multiplayer servers in mind, it combines high-performance rendering with built-in model synchronization and file encryption. Whether you want expressive emotes, custom character designs, or third-party combat animations, YSM provides a complete framework for players and creators.
S
YSM model formats: folder, zip and encrypted .ysmYes Steve Model (YSM) loads custom player models in three different container formats: unpacked folders, compressed archives, and encrypted .ysm files. Understanding how each format works and where to place your files inside the game directory is the essential first step for both players installing models and creators distributing them.
S
Yes Steve Model FAQ and Common ProblemsThis troubleshooting guide covers everything a beginner needs to know to install, configure, and fix Yes Steve Model (YSM) for Minecraft Java Edition. From adding custom models to solving rendering glitches and crashes, follow these steps to get your character models working smoothly.