Introduction
ChatColor is a chat color plugin for Paper, Purpur and Folia servers on 1.21 and newer. Players pick a solid color, a multi-stop gradient or a character-cycling pattern for their chat from an in-game GUI or a command, and ChatColor applies it to every message, whichever chat formatter the server runs.
What's in this guide
- Getting Started — install the plugin and give players their first color.
- Core Reference — every command and permission node, and the color selector GUI.
- Configuration —
config.yml, the color and pattern files, and how updates keep your edits. - Integrations — PlaceholderAPI, and how ChatColor works alongside EssentialsChat, LPC, ChatManager and DiscordSRV.
- Advanced — the
ChatColorAPIfor other plugins. - Support — FAQ, common issues, and how to get help.
Key features
- Solid colors, gradients and patterns, each with its own permission node, plus custom colors you add from a command.
- Color selector GUI with a main menu and a page per category, fully configurable in
gui/gui.yml. - Works with the chat formatter you already run: EssentialsChat, ChatManager and ZelChat are detected and set up automatically; LPC and LPC-Pro work through
%chatcolor_message%. - PlaceholderAPI placeholders for the player's color, colored name and colored message.
/color debugtraces the whole chat pipeline into the console when something doesn't show up.- Folia support, region-thread safe throughout.