BetterTeams Chat Extension
Fully customizable chat formatting powered by BetterTeams & PlaceholderAPI
What does it do?
This is an extension for
BetterTeams that takes over your chat formatting.
It replaces the default chat with a fully customizable format that pulls data directly from BetterTeams — team name, tag, prefix, suffix, color — and supports every color format Minecraft has to offer.
✨ Features
- BetterTeams integration — displays team name, tag, custom prefix, suffix and team color in chat
- PlaceholderAPI support — use any %placeholder% from any PAPI expansion in your format
- Full color support — every color format supported, freely mixed in one format string:
- Legacy codes &a &b &c … &r
- Short hex RRGGBB
- Bukkit/EssentialsX hex &x&R&R&G&G&B&B
- MiniMessage hex <#RRGGBB>
- MiniMessage named colors …
- Gradients text
- Rainbow text
- Bold, italic, underline, strikethrough, obfuscated
- /teama reload — reload the config without restarting the server
- Lightweight — no database, no extra overhead
⚙️ Requirements
- BetterTeams 5.0.0+ (required) — this is a BetterTeams extension, it cannot run without it
- PlaceholderAPI 2.11.0+ (required) — used to expand placeholders in the format string
- Paper 1.21+ (required) — uses the Paper Adventure chat pipeline; Spigot is not supported
- Java 21+
Installation
- Make sure BetterTeams and PlaceholderAPI are installed and working
- Drop the BetterTeamsChatExtension.jar into your /plugins/BetterTeams/extensions/ folder
- Restart/Start or /teama reload the server — a chat-config.yml will be generated automatically
- Edit the format to your liking and run /teama reload
Configuration
# Chat format – supports BetterTeams tags and PlaceholderAPI placeholders
format: "&7[&r%betterteams_tag%&7]&r %luckperms_prefix%{DISPLAYNAME}&7: &c{MESSAGE}"
# Available tags: {TEAM}, {PREFIX}, {SUFFIX}, {COLOR}, {DISPLAYNAME}, {NAME}, {MESSAGE}
Available tags:
- {TEAM} — raw team name
- {TAG} — team display tag (set with /team tag)
- {PREFIX} — custom meta value (set with /teama meta set prefix [VALUE])
- {SUFFIX} — custom meta value (set with /teama meta set suffix [VALUE])
- {COLOR} — team color as a color code
- {DISPLAYNAME} — player display name
- {NAME} — player username
- {MESSAGE} — the chat message
- %any_papi_placeholder% — any PlaceholderAPI placeholder
Commands & Permissions
Command
Description
Permission
/teama reload
Reloads chat-config.yml
OP