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%

Recommended Settings for LPC:

• In ChatColor config.yml: Set apply-to-message: false and late-bind: true.
• In LPC config.yml: Set your format to {message}: %chatcolor_mm_message%.

---

MiniMessage vs. Legacy

Depending on the plugin you are using, you may need a different format:

1. Legacy (%chatcolor_...%): Uses standard color codes (like §6). Best for DiscordSRV, Scoreboards, and older Tab plugins.
2. MiniMessage (%chatcolor_mm_...% or %chatcolor_..._mm%): Uses modern tags (like <red>). Best for LPC, Tab, and modern chat plugins.

Available MiniMessage Variants:

• %chatcolor_mm_message% / %chatcolor_message_mm% (Universal Message)
• %chatcolor_mm_<text>% / %chatcolor_<text>_mm% (Universal Text)
• %chatcolor_mm_formatted_msg_<text>% (Color any text using MiniMessage)

---

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
%chatcolor_color%	Raw MiniMessage tag / Pattern key	<red>, rainbow
%chatcolor_color_legacy%	The legacy color code of selection	§c
%chatcolor_formatted_msg_<text>%	Colors <text> with player color	Hello (colored)

---

Advanced: Color Overrides

If you want to force a specific color regardless of what the player has selected, you can use:

• %chatcolor_<colorName>_<text>% (Legacy)
• %chatcolor_mm_<colorName>_<text>% (MiniMessage)

Example: %chatcolor_red_Warning% will always be red.

Note: <colorName> must be a key from colors.yml, gradients, or patterns.yml.