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.
Available Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
%chatcolor_color_type% |
The player's active color type | SOLID, GRADIENT, PATTERN, or NONE |
%chatcolor_color_key% |
The key of the player's active selection | red, sunset, rainbow, or none |
%chatcolor_color% |
The raw MiniMessage tag for solids/gradients, or the key for patterns | <red>, <gradient:red:blue>, or rainbow |
%chatcolor_message% |
The player's last chat message with their active color/pattern applied | §cHello world! |
%chatcolor_message_<text>% |
Applies the player's active color/pattern to the provided <text> |
§6§lBusyBee |
%chatcolor_formatted_msg_<text>% |
Identical to above (alternative syntax) | §6§lBusyBee |
Example Usage
Chat formatting
If your chat plugin supports PlaceholderAPI, you can use %chatcolor_color% before the message placeholder. However, since %chatcolor_color% returns MiniMessage tags, your chat plugin must support MiniMessage for it to work.
Tablist/Scoreboard (Legacy Support)
Most Tablist and Scoreboard plugins only support legacy color codes (§). Use the message placeholders to get a legacy-formatted string:
- Format:
%chatcolor_formatted_msg_%player_name%% - Result: Displays the player's name in their chosen color, gradient, or pattern, compatible with almost all plugins.
Last Message
You can display a player's last message in their chosen color (useful for social spy or hover effects):
- Format:
%chatcolor_message%