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 ChatColorAPI for 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 debug traces the whole chat pipeline into the console when something doesn't show up.
  • Folia support, region-thread safe throughout.