Server Chat Heads
Use player heads in chat and more via placeholders! Credits to CatDevz for making the original Minestom code.
Screenshots
About this Mod
Server Chat Heads
Plz Mojang optimize font rendering
Use player heads in chat and more via placeholders! Credits to CatDevz for making the original Minestom code.
How it works
When a player joins its skin gets downloaded and the colors of the pixels of the face get extracted and put in a User UUID, TextColor[][] Map, when the placeholder gets invoked, it searches for the user in that map and tries to print the head in chat using negative spaces and a custom pixel font.
Placeholders
| Placeholder | Function |
|---|---|
%chatheads:player% |
Print the invoker's head |
%chatheads:player [target]% |
Print the target's head |
Bleeding edge builds
Upstream builds are available in via GitHub Actions.
Credits
- CatDevz for making the original Minestom code
- Camper_Samu (me) for making the Fabric port
- TheEpicBlock for PolyMC
- Patbox for Polymer, a part of PolyMC and the core of many Serverside mods (like this one)
- Fabric Server-Side Development Discord for helping me while making this mod and other mods (like WAYF? or PolyForgery)
License
This template is available under the GPLv3 license. Feel free to learn from it and incorporate it in your own projects following the license's guidelines.
Available Versions
How to Install Server Chat 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 (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Server Chat Heads". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21, 1.20.6 (+6 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Server Chat 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 (1.21.1). You can switch loaders with one click in the panel.
Is Server Chat Heads compatible with fabric and quilt?
Server Chat Heads officially supports fabric, quilt for Minecraft 1.21.1, 1.21, 1.20.6. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Server Chat Heads – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Server Chat 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 Server Chat Heads with just one click on your server.