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.
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 = falsePaper 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 = 0Questions
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.