Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
BetterChat for Fabric
BetterChat is a Fabric mod designed to enhance the chat experience on Minecraft servers. It makes communication between players more dynamic and convenient with features like Markdown-style text formatting, player mentions, and mention notifications & history.
✨ Key Features
-
Markdown-Style Chat Formatting: Emphasize your messages with various text styles.
Bold Text
Italic Text
Underlined Text
Strikethrough Text||obfuscated||
-
HEX Color Code Support: Freely apply any color to your text using the
#RRGGBB
format. -
Player Mention System: Use the
@
symbol to mention other players. -
Notification: Mentioned players who are online will hear a notification sound.
-
Team Colors: If a mentioned player is on a team, their name will be displayed in their team's color.
-
Offline Mention Storage: Mentions received while a player is offline are securely saved. The player is notified of unread messages upon logging in.
-
Message Metadata & Copy: Hovering over a chat message displays its timestamp. Clicking the message copies its content to your clipboard.
-
Customizable by Server: All major features can be enabled, disabled, or fine-tuned by server administrators via the
betterchat_config.json
file.
💾 Installation
- Install the Fabric Loader.
- Download the Fabric API.
- Download the latest BetterChat mod
.jar
file. - Place the downloaded Fabric API and BetterChat
.jar
files into your.minecraft/mods
folder.
🛠️ Usage
Use the following formats in the chat window to apply various styles to your messages.
Feature | Syntax | Example | Result |
---|---|---|---|
Bold | **Text** |
**Important Message** |
Important Message |
Italic | _Text_ |
_A point I want to emphasize_ |
A point I want to emphasize |
Underline | __Text__ |
__This looks like a link__ |
This looks like a link |
~~Text~~ |
~~This content is outdated~~ |
||
obfuscated | ||Text|| |
This will be unreadable |
ajsabjkdbakb |
Color | #HexCodeText# |
#FF5555Hello World# |
Hello World |
Mention | @PlayerName |
Hello, @Player492! |
Hello, @Player492! |
Escape Formatting | Use a backslash \ |
This is not \**bold**. |
This is not **bold**. |
⚙️ Configuration
Sample betterchat_config.json
You can find betterchat_config.json
in your save folder.
{
"textPostProcessingEnabled": true,
"mentionEnabled": true,
"defaultMentionColor": "0xFFFF55",
"defaultMentionSound": "minecraft:entity.experience_orb.pickup"
}
Configuration Options
textPostProcessingEnabled
: Iftrue
, enables Markdown and color formatting for chat messages.mentionEnabled
: Iftrue
, enables the@
mention feature.defaultMentionColor
: Sets the default HEX color for mentioned players who are not on a team. Example:"0xFFFF55"
will color mentions in yello for non-team players.defaultMentionSound
: Sets the sound event ID to be played when a mention occurs. For example,"minecraft:entity.experience_orb.pickup"
will play the experience orb sound.
Version Compatibility
- Minecraft Versions Supported: 1.21.8 (tested).
- Fabric Loader Requirement: Fabric Loader 1.21.8 or newer.
- Recommended Fabric API: 0.16.14 or newer.
- Java Version: Java 21 or newer is required to run this mod.
Troubleshooting & FAQ
-
Mod Does Not Load:
- Ensure you have the correct Fabric Loader version installed (check
.minecraft/versions
folder). - Confirm that Fabric API and BetterChat
.jar
files are both in themods
folder. - Check the server/client logs for errors related to BetterChat during startup.
- Ensure you have the correct Fabric Loader version installed (check
-
Color Formatting Not Applying:
- Verify
textPostProcessingEnabled
is set totrue
inbetterchat_config.json
. - Make sure your HEX color syntax is correct: wrap text as
#RRGGBBYour Message#
.
- Verify
-
Mentions Not Notifying Players:
- Confirm
mentionEnabled
istrue
. - Ensure the mentioned player is online to hear the notification sound.
- If the player is on a team, the mention color will default to the team's color rather than
defaultMentionColor
.
- Confirm
📜 License & Distribution
This project is licensed under the CC BY 4.0.
To ensure everyone gets the latest and safest version, please download the mod from the official sources below. I would appreciate it if you link to these pages rather than re-hosting the files.
Official Download on Modrinth: https://modrinth.com/mod/better-chat
Source Code on GitHub: https://github.com/hanhy06/better-chat
If you plan to use this mod on a large-scale server, I would appreciate it if you could let me know! This is not a requirement, but I’m curious how and where my work is used.