Chat Heads FAQ

The mod is client-side and works automatically once installed, so heads appear beside chat messages with no toggle needed. If nothing shows, check that the mod is actually loaded for your profile and that you're seeing vanilla chat rather than another mod's chat overlay.

The most common cause is another chat mod or HUD mod overriding the vanilla chat renderer. Disable conflicting chat mods or check your config to make sure head rendering is enabled.

Yes, it's client-side, so it works on any server without the server needing the mod installed. Heads are pulled from player skins, so players using default or hidden skins may show a generic head.

No, this is a Java Edition mod and won't run on Bedrock. Bedrock players looking for similar behavior would need a Bedrock-specific addon, which this mod is not.

It's a client-side mod, not a server plugin. You install it on your own game, and it enhances chat visually for you only — other players won't see the heads unless they also have it.

Enable the voice chat integration option in the config so speaking players get a visual indicator on their head. The exact toggle lives in the mod's config screen alongside the general chat head settings.

Lower the head size and opacity in the config, or reduce how many messages show heads at once. You can also disable heads for system messages so only player chat gets them.

Yes, head scale is adjustable in the configuration. You can also tweak opacity and spacing so heads fit your chat layout without overlapping text.

It's lightweight since it only renders small head textures beside chat lines. If you notice lag, it's usually from skin loading rather than the head rendering itself, and caching skins helps.

Their skin hasn't loaded yet, or they're using a skin the client can't fetch. Waiting a moment or relogging usually resolves it, since skins are fetched from the session server.