Just Player Heads

Just Player Heads

🗿 Allows the collection of player heads via command or death event.

by
1.2M Downloads
fabricforgeneoforgequiltadventuredecorationgame-mechanics
Rent Server with this Mod

About this Mod

A Serilum Mod. Made with love. Lots of active mods for Fabric, Forge and Neo!

CurseForge Modrinth Patreon YouTube

About the 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!



Dependencies

Requires Collective
Included in The Vanilla ExperienceIncluded in Serilum's RPG Bundle
Environment: Server



Configurable

Configuration guide

   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



Description

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.



Notes and links

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

[Fabric/Forge/Neo] 26.2.0-4.4release
MC 26.2fabric, forge, neoforge, quilt
June 18, 2026
[Fabric/Forge/Neo] 26.1.2-4.4release
MC 26.1.2fabric, forge, neoforge, quilt
June 7, 2026
[Fabric/Forge/Neo] 1.21.11-4.4release
MC 1.21.11fabric, forge, neoforge, quilt
June 7, 2026
[Fabric/Forge/Neo] 1.21.1-4.4release
MC 1.21, 1.21.1fabric, forge, neoforge, quilt
June 7, 2026
[Fabric/Forge/Neo] 1.20.1-4.4release
MC 1.20.1fabric, forge, neoforge, quilt
June 7, 2026

How to Install Just Player Heads on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).

3

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

fabricforgeneoforgequilt

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+25 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Just Player Heads with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Required

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+18 more