AL-TeamChat + Mod

A clean and lightweight team chat plugin for your Minecraft server with an optional Fabric mod for a stylish ingame chat overlay.

💡 Optional Mod Integration: TeamChat works fully on its own. For an enhanced experience, an optional Fabric client mod displays the team chat in a custom overlay on the side of your screen. Players without the mod still use TeamChat normally through the regular chat — nothing required.

You find the Mod for the Plugin here

✨ Features

• Private team chat — a separate chat channel only your staff can read and write in

• Three ways to chat:

  • Send a single message with a command
  • Toggle team chat mode (everything you type goes to the team)
  • Quick prefix to send a one-off message

• Username highlighting — online players' names are automatically highlighted in color

• Optional mention ping — notify a player with a sound when their name is mentioned (configurable)

• Fully configurable — colors, formats, and behavior via a simple config.yml

• Language system — all messages live in language files (en included), easily switch or add languages

• Permission-based access — only players with the right permission join the team chat

• Optional Fabric mod — displays the team chat in a sleek custom overlay (configurable position, size, colors)

🎮 Commands

• /tc | Send a message to the TeamChat
• /tc | Toggle the TeamChat (on or off)
• /tc reload | Reload the config and language

🔑 Permissions

• teamchat.use | Allow to read and write in the TeamChat
• teamchat.reload | Allow to reload the settings

⚙️ Setup

1. Drop the plugin .jar into your server's plugins/ folder
2. Start the server once to generate the config and language files
3. Adjust config.yml and the language file to your liking
4. Give your team the teamchat.use permission
5. (Optional) Install the Fabric mod on your client for the chat overlay

🌐 Language

All messages are stored in language files. The default language is English (en). You can switch the language in the config or add your own — more languages may be added in future updates.

📦 Compatibility

• Server: Paper / Spigot (Minecraft 1.21.x)
• Mod (optional): Fabric (Minecraft 1.21.x)

config.yml:

#####################################################################
#                     TeamChat by AddonLab
# Disocrd: https://discord.gg/RJC6zSmru3
#####################################################################

# Language file from the lang/ folder (falls back to en).
language: en

# Character to send a single message to the TeamChat (e.g. @hi). Empty = off.
prefix-char: "@"

highlight:
  # Highlight online player names in messages.
  enabled: true
  # Named colour, <tag> or #RRGGBB.
  color: gold

ping:
  # Play a sound for mentioned players.
  enabled: true
  sound: "minecraft:block.note_block.pling"
  volume: 1.0
  pitch: 1.2

bridge:
  # Link to the optional client mod (does nothing without it).
  enabled: true
  # Mod users see the TeamChat in their overlay only, not the normal chat.
  suppress-chat-for-mod-users: true
  # Log bridge activity to the console.
  debug-log: false

If you find bugs or have suggestions, you can find our Discord here:

• https://discord.gg/RJC6zSmru3