Mods
Resource Packs
Data Packs
Modpacks
Shaders
Plugins
Mods Resource Packs Data Packs Plugins Shaders Modpacks
Get Modrinth App Upgrade to Modrinth+
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Sign in
Settings
Chat Heads

Chat Heads

See who you're chatting with!

23.07M
5,007
Decoration
Social

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.1–1.19.4
1.18.x
1.17.x
1.16.x

Platforms

Fabric
Forge
NeoForge

Supported environments

Client-side

90% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source

Creators

dzwdz
dzwdz Owner
Fourmisain
Fourmisain Maintainer

Details

Licensed MPL-2.0
Published 3 years ago
Updated last week
DescriptionGalleryChangelogVersions
All versions1.1.7

1.1.7

Download
Report

Changelog

1.1.7

Quick followup fix for 1.1.6:

  • chat heads always use the "white" style (fixes e.g. chat heads in leave messages rendering with a yellowish tint)

1.1.6

Another really small but important bug fix!

  • fix an issue where translatable messages (e.g. join/whisper messages) could lose their style

1.1.5

  • fix translations JSON (oops!)

1.1.4

  • update Simplified Chinese (zh_cn), Traditional Chinese (zh_tw) and Japanese (ja_jp) translations, thanks to Internet Yamero!

1.1.3

  • fix click position being wrongfully offset in "Before Name" rendering

1.1.2

Breaking News: Single Source Code Character causes Havoc!

This tiny release fixes an important bug where name aliases and display names weren't always considered for player detection.
Fixes e.g. nicknamed players on EssentialsX servers to not show a chat head despite a name alias being defined.

1.1.1

As expected, there were bugs!
Chat Heads should now deal with all forms of text styling including § formatting codes correctly again.
Keep the issue reports coming!

1.1.0

  • add "Auto-detect Name Aliases" feature, which detects responses to /realname commands on EssentialsX servers and automatically adds aliases for it (on by default)
  • [1.21.6+] fix "Missing Cloth Config" screen text being invisible

1.0.0

This is a large rewrite of the mod - it finally works how it always should have worked!
(And it took an insane amount of work to make it work, work.)

If you care for a bit of technical babbling with some info strewn inbetween, do read on!

The reason for this rework is that in 1.21.9 Mojang added 2 types of "object" text components:
Atlas sprites and player sprites, which allow putting any sprite or player head inside any text - chat, menus, signs, you name it!

Chat Heads now uses these player sprite text components.

On paper this should mean massively improved mod compatibility, since it's a vanilla feature.
In fact, it appears Chat Heads is finally fully compatible with Caxton!
The same may be true for Modern UI's text engine.

Servers will start making use of player sprites as well.
There was already ways to do "server-side chat heads" by using special fonts allowing to print 1 pixel at a time.
Now it's as easy as pie and due to that, Chat Heads will not add any heads itself, if it detects any in a received message.
(Whether this is sane behavior, time will tell)

Player sprites do however come with some limitations.

In Vanilla, they are always 8x8 pixels without any padding, which can look quite bad in chat.
To remedy this, Chat Heads adds 1 pixel of padding, making it consistent with regular characters. This only applies to chat, so it won't mess e.g. with signs.

They also suffer from transparency issues.
This only really affects you if you changed Minecraft's "Chat Text Opacity" setting.
What happens is that the hat layer of your skin blends together with the face, which can make the hat layer almost invisible.
(On that note, Chat Heads still supports the old "Before Line" render mode, which does have a transparency fix.)

Speaking of hat layers, Chat Heads now respects Minecraft's "Skin Customization" settings.
If you take your hat off, it won't show in chat either.

Finally, almost the entire player detection logic was rewritten.
It's hard to say if this really changes anything, but it's much more gooder code now.

While I did a ton of testing, due to the large scale of changes, issues are to be expected.
Please report any issue you find!

- Fourmisain

Dependencies

dependency-iconCloth Config APIoptional

Files

chat_heads-1.1.7-neoforge-1.21.9.jar(86.57 KiB) Primary
Download

90% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Metadata

Release channel

Release

Version number

1.1.7

Loaders

NeoForge

Game versions

1.21.9, 1.21.10

Downloads

1037

Publication date

November 24, 2025 at 5:22 PM

Publisher

Fourmisain

Fourmisain

Maintainer

Version ID

Modrinth is open source.

sidebar-refinement@948af2b

© Rinth, Inc.

Company

TermsPrivacyRulesCareers

Resources

SupportBlogDocsStatus

Interact

Discord X (Twitter) Mastodon Crowdin
Get Modrinth App Settings
NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.