Slimefun and Geyser Custom Heads fix
Running a Paper server with both Slimefun and Geyser is one of the best ways to let Java and Bedrock players share the same world. There is just one problem that keeps popping up: Bedrock players stare at a Slimefun menu full of cursed Steve heads instead of the custom textures everyone else sees. The Slimefun and Geyser Custom Heads fix exists to solve exactly that, and this guide explains why the issue happens and how to install the solution on your server.
Why Bedrock Players See Cursed Steve
Slimefun stores its custom heads as player-head items with specific texture values. On Java Edition, the client resolves those textures and renders the correct icon. Bedrock clients connected through Geyser work differently. They rely on Geyser's custom skull handling, and when the head data does not match what the Bedrock client expects, the fallback is the default Steve head, often nicknamed cursed Steve.
Most fixes floating around the community fail because they only address one half of the problem. They might patch the resource pack, or they might tweak Geyser settings, but they ignore how Slimefun loads its addons. That is where this fix takes a different approach.
The Addon Folder Trap
The original creator of this fix discovered a critical detail after testing on their own Paper server: Slimefun addons placed inside the .../slimefun/addons folder do not register their custom heads correctly. Any addon that lives outside .../plugins will not show its proper heads, and cursed Steve appears again for Bedrock players.
- Addons in
.../slimefun/addonslose their custom head textures for Bedrock clients. - Addons installed directly in
.../pluginsdisplay their heads correctly. - The fix must be paired with correct addon placement to work reliably.
In other words, the fix itself is only part of the equation. Server owners need to move their Slimefun addons into the main plugins directory so the head data is registered in a way Geyser can translate for Bedrock players.
Supported Versions and Loaders
The Slimefun and Geyser Custom Heads fix targets Paper servers, which is the loader most Slimefun and Geyser setups run on. It works alongside modern Minecraft Java releases commonly used with Geyser, including 1.19.x and 1.20.x, and it plays nicely with Spigot-based forks that support the same plugin APIs. If you run a hybrid or proxy setup, keep Geyser and Floodgate updated to avoid mismatches between Java and Bedrock head rendering.
If you would rather skip manual file juggling, the foxygame.net launcher bundles this kind of server-side utility in its add-on catalog, letting you drop the Slimefun and Geyser Custom Heads fix into your instance with a single click and keep it current through automatic updates.
How to Install the Fix
Installing is straightforward once you understand the folder rules. Follow these steps in order:
- Stop your Paper server completely before touching any files.
- Download Slimefun and Geyser Custom Heads fix from a trusted source and place the jar in your
.../pluginsfolder. - Check every Slimefun addon you use and move any that sit in
.../slimefun/addonsinto.../plugins. - Confirm Geyser and Floodgate are installed and updated to versions compatible with your Minecraft release.
- Start the server and let all plugins generate their configuration files.
- Join from a Bedrock client and open a Slimefun menu to verify the custom heads render correctly.
After the first successful launch, restart once more so cached head data refreshes. Bedrock players should now see the proper Slimefun icons instead of cursed Steve, and Java players will notice no difference at all.
Troubleshooting Tips
If heads still look wrong, re-check your addon placement first. A single addon left in the wrong folder can reintroduce cursed Steve across the whole menu. Next, verify that your resource pack delivery through Geyser is enabled, since Bedrock clients need the pack to resolve custom textures. Finally, clear the server's cached player head data and restart, because stale entries sometimes survive plugin updates.
Final Thoughts
The Slimefun and Geyser Custom Heads fix for Minecraft solves a problem that has frustrated cross-play server owners for a long time. The key insight is simple: keep your Slimefun addons in .../plugins, install the fix, and keep Geyser updated. Do that, and Bedrock players get the full Slimefun experience with proper custom heads, while cursed Steve finally stays where he belongs.