
Just Player Heads
🗿 Allows the collection of player heads via command or death event.
About this Mod
Just Player Heads is a minimalistic mod that allows the collection of player heads via a command or death event. All heads are generated similar to a mob head via texture-data, lag free. The mod procedurally retrieves texture data via the Mojang API, and can cache them locally after.
I've also got a Just Mob Heads mod available!
All available config options:
Show Spoiler
enablePlayerHeadCaching default true
If enabled, enables the caching of player head textures. This fixes the limitations of the Mojang API, but does mean that whenever players update their skin the old head is still dropped until the server reboots or an administator uses the '/jph cache' command.
playerDropsHeadOnDeath default true
If enabled, allows players to drop their head on death.
playerHeadDropChance default 1.0, min 0.0001, max 1.0
Sets the chance of a player dropping their head if 'playerDropsHeadOnDeath' is enabled.
Texture values instead of generation via player-names
The mod uses texture values to generate the player heads. This means that there won't be any lag, which player-name generated heads usually cause.
Pure Vanilla Resources
Because the mod does not add any custom blocks, you may remove the mod and still have the heads previously gathered in-game.
In-game commands
If you want to generate a player head without any death event, you may do so via the jph command. Where the player name ignores capitalisation and the amount is optional (default amount is 1).
/jph head <playerName> (amount)
To empty the player head texture cache (if enabled in the config) you can reboot the server or use the following command:
/jph cache
Mojang API request limitations
The mod uses the UUID -> Profile + Skin/Cape function of the Mojang API. This has quite a strict rate limit: You can request the same profile once per minute, however you can send as many unique requests as you like. This means that sometimes the mod is unable to generate a head if the API limits its generation. The texture caching feature can fix this by saving the head texture data locally.
You may freely use this mod in any modpack, as long as the download remains hosted within the CurseForge or Modrinth ecosystem.
Serilum.com contains an overview and more information on all mods available.
For issues, ideas, suggestions or anything else there is the Github repo. Thanks!
Available Versions
How to Install Just Player Heads on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "Just Player Heads". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+25 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Just Player Heads server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is Just Player Heads compatible with fabric and forge and neoforge and quilt?
Just Player Heads officially supports fabric, forge, neoforge, quilt for Minecraft 26.2, 26.1.2, 26.1.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Just Player Heads – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Just Player Heads consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Just Player Heads with just one click on your server.
