mcmodwikiSparkle's Morpher
The successor to Fox Model Loader — a universal Minecraft custom model loader supporting YSM, Blockbench, animations, sounds, multiplayer synchronization, and more.
33 config settings
Build 1.2.1 · checked 13 September 2026
Guides
- Sparkle's Morpher: Animation Triggers and Roulette Configuration
- Sparkle's Morpher: Custom Model Management and Visual Display Settings
- Sparkle's Morpher: Rendering Backends and Memory Profiling
Config
- Animation debug log
animation_debug_log— Write verbose per-frame animation diagnostics to the log. - Animation distance LOD
animation_distance_lod— Debug option: lower distant entity animation update rates to 30/15 FPS. - Animation frame profiler
animation_frame_profiler— Record per-frame animation evaluation counts and timing.
Show all 33 settings
- Blur GUI background
blur_gui— Frosted-glass blur behind panels (roulette + model settings). - Resident CPU model limit
cpu_cache_limit— Maximum local and server models that keep full runtime data in memory; idle models reload from their source when used. - Disable external first person animation.
disable_external_first_person_anim— Disable first-person animations contributed by other mods. - Disable loading state screen
disable_loading_state_screen— Hide the loading state corner badge. - Disable model glow in shaderpack
disable_model_glow_in_shaderpack— Disable the glow effect on custom models when a shaderpack is active. - Prevents rendering of other player's model
disable_other_model— Hide other players' custom models. - Hide HUD player preview
disable_player_render— Hide the player preview shown in the HUD. - Prevents rendering of projectile model
disable_projectile_model— Disable custom projectile model rendering. - Prevents rendering of self player's hands
disable_self_hands— Hide custom hand model in first person view. - Prevents rendering of self player's model
disable_self_model— Hide your own custom model. Uses the vanilla Steve model instead. - Prevents rendering of vehicle model
disable_vehicle_model— Disable custom vehicle model rendering. - Input state debug log
input_state_debug_log— Print [SM-INPUT] logs for left/right click, attack/use keys, vanilla swing/use state, and local animation pulses. - Loading state screen position
loading_state_position— Choose where the loading state badge appears on screen. - Max cached GPU models
max_cached_gpu_models— 0 disables GPU/native render cache trimming. Higher values keep more model render caches resident. - Model import performance log
model_import_performance_log— Print [SM][Perf] timings for model import, upload, folder scans, and server reloads. Enable only while testing. - Model info screen mode
model_info_screen_mode - Model memory profiler
model_memory_profiler— Write model read, parse, texture, GPU mesh, and cache trim memory checkpoints to the log. - Network online debug log
network_online_debug_log— Print detailed client/server model sync logs for online play. Enable only while diagnosing multiplayer sync issues. - Whether to print animation roulette play message
print_animation_roulette_msg— Print a chat message when switching roulette animations. - Release texture bytes after upload
release_texture_bytes_after_upload— Release Java-side PNG bytes after a texture is uploaded to the GPU. - Renderer
renderer— Choose the rendering backend - Resource Station Log
resource_station_monitor_log— Enable debug logging for resource station - Roulette mode
roulette_mode - Roulette settings mode
roulette_settings_mode - Animation Sound Volume
sound_volume— Volume percentage for model animation sounds. - Texture screen mode
texture_screen_mode - Unused model cache TTL
unused_model_ttl_seconds— Minimum idle time before an unused model render cache can be trimmed. - Use compatibility renderer
use_compatibility_renderer— Use the slower but more compatible render path. - Use gpu renderer (experimental)
use_gpu_renderer— Enable the experimental GPU renderer. May have compatibility issues. - Warn repeated animation evaluation
warn_repeated_animation_evaluation— Warn when one entity is fully evaluated more than once in the same render frame.
Requires
| Mod | Needed | Versions |
|---|---|---|
touhou_little_maid |
optional | [0,) |
Frequently Asked Questions
How do you import custom character models into Sparkle's Morpher?
Open the model management interface and place supported model packages or folders directly into the designated custom directory.
How do you trigger custom emotes and animations in multiplayer?
Open the radial roulette menu to choose and activate your configured animation sequences during gameplay.
Can you hide other players' custom models if they cause visual clutter?
Yes, enabling the Prevents rendering of other player's model option substitutes default character models in place of custom avatars.
How do you resolve visual stuttering caused by high-poly models?
Adjust animation distance LOD to reduce refresh rates on distant entities and choose the compatibility or GPU renderer that best matches your hardware.