BetterHead Chat

A Fabric mod that displays chat messages above players’ heads in Minecraft.

Features

• Chat messages appear as floating text above the sender’s head
• Supports vanilla chat, /msg whispers, and /tellraw system messages
• Configurable message patterns for parsing /tellraw output (e.g. <%player%> %message%)
• Heuristic player name detection as a fallback
• Adjustable display range, line lifetime, line height, and max lines
• Optional chat hiding — show messages only above heads, not in chat
• YACL-based config screen with ModMenu integration

Installation

1. Install Fabric Loader
2. Download the appropriate module for your Minecraft version
3. Place the .jar file in your mods folder
4. Install Fabric API and YACL if not already installed

Configuration

Open the mod settings via ModMenu or the in-game config screen. Options include:

• Mod Enabled — toggle the mod on/off
• Max Lines — maximum number of lines displayed above a player
• Line Lifetime — how long messages stay visible (seconds)
• Attach to Head — position text at head level or fixed height
• Line Height — vertical offset above the head
• Hide Nametag — hide the vanilla nametag when overhead chat is active
• Hide Chat Messages — suppress messages from the chat window
• Enable Whisper — show /msg whispers above heads
• Range — maximum render distance for overhead text
• Reverse Order — display newest messages at the top
• Max Line Length — character limit before wrapping
• Chat Patterns — regex patterns for parsing /tellraw messages (e.g. <%player%> %message%)
• Heuristic Player Detection — attempt to detect player names in unrecognized system messages

License

All Rights Reserved

Links

• GitHub
• Issue Tracker