BetterTeams Chat Extension
Fully customizable chat formatting powered by BetterTeams & PlaceholderAPI
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 <red> <gold> <aqua> …
- Gradients <gradient:#FF0000:#0000FF>text</gradient>
- Rainbow <rainbow>text</rainbow>
- 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
Code (YAML):
# chat-config.yml
# 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}
# 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}
- {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 |
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
BetterTeam Chat Format is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 68 times (via Spigot). Download it and open it directly in the game.