PlaceholderAPI
When PlaceholderAPI is installed, you can use the following placeholders in other plugins to display player color data or apply their selection to arbitrary text.
Primary Placeholders
These are the most common placeholders you will use. They automatically detect whether the player has a Solid Color, Gradient, or Pattern selected and apply it.
| Placeholder | Description | Example Output |
|---|---|---|
%chatcolor_message% |
The Universal Chat Placeholder. Use this in your chat format to display the player's message with their selected color. | §cHello! |
%chatcolor_<text>% |
Colors any custom text (like a player's name) with their currently selected color. | §6§lBusyBee |
✨ For LPC (Chat Format)
If you are using LPC or any modern chat plugin, use the MiniMessage variant to ensure all gradients and patterns display correctly:
{message}: %chatcolor_mm_message%
MiniMessage vs. Legacy
Depending on the plugin you are using, you may need a different format:
- Legacy (
%chatcolor_...%): Uses standard color codes (like§6). Best for DiscordSRV, Scoreboards, and older Tab plugins. - MiniMessage (
%chatcolor_mm_...%): Uses modern tags (like<red>). Best for LPC, Tab, and modern chat plugins.
Available MiniMessage Variants:
%chatcolor_mm_message%(Universal Message)%chatcolor_mm_<text>%(Universal Text)
Status Placeholders
Use these to display information about what the player has selected:
| Placeholder | Description | Example Output |
|---|---|---|
%chatcolor_color_key% |
The name/ID of the active selection | red, sunset, rainbow |
%chatcolor_color_type% |
The type of selection | SOLID, GRADIENT, PATTERN |
Advanced: Color Overrides
If you want to force a specific color regardless of what the player has selected, you can use:
%chatcolor_<colorName>_<text>%%chatcolor_mm_<colorName>_<text>%
Example: %chatcolor_RED_Warning% will always be red.