PerfChatColors
Chat name colors with GUI shop, custom hex colors, vouchers, and PlaceholderAPI.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Runs on Folia and standard Paper backends
• Chat color GUI – Browse, buy, select, and reset chat colors from /colors
• Live chat coloring – Applies to legacy chat and Paper AsyncChat messages
• 14 preset colors – Unlock via permission, purchase, or default-colors list
• Economy shop – Buy colors with Vault, PlayerPoints, or ExcellentEconomy
• Custom personal colors – Creator item plus /colors create (hex) (name) for unique hex colors
• Color vouchers – Right-click vouchers to permanently unlock a color
• Color creator items – Staff can hand out creator items with /perfchatcolors giveitem
• Per-color permissions – Fine-grained access with perfchatcolors.color.* or per-color nodes
• Admin tools – Grant, revoke, reset, set active color, and inspect player unlocks
• PlaceholderAPI – Expose the active chat color for scoreboards, TAB, and chat plugins
• Persistence – Purchases, active color, and custom colors saved to database and data files
• Update notifier – Optional in-game notice when a new version is available
Placeholders
%perfchatcolors_color% – Player’s active chat color formatting for messages and displays
Commands
/colors – Open the chat color GUI (perfchatcolors.use)
/colors create (hex) (name) – Register a custom color with a creator item in hand (perfchatcolors.createitem.use)
/chatcolors – Alias for /colors (perfchatcolors.use)
/perfchatcolors reload – Reload config and messages (perfchatcolors.admin)
/perfchatcolors help – Show admin command usage (perfchatcolors.admin)
/perfchatcolors stats (player) – Show a player’s active color (perfchatcolors.admin)
/perfchatcolors info (player) – List active and unlocked colors for a player (perfchatcolors.admin)
/perfchatcolors give (player) (colorId) – Grant a color unlock (perfchatcolors.admin)
/perfchatcolors revoke (player) (colorId) – Remove a color unlock (perfchatcolors.admin)
/perfchatcolors reset (player) – Clear all unlocks and active color (perfchatcolors.admin)
/perfchatcolors setactive (player) (colorId) – Set active chat color or none (perfchatcolors.admin)
/perfchatcolors giveitem (player) [amount] – Give color creator items (perfchatcolors.admin.giveitem)
/perfchatcolors voucher give (player) (colorId) [amount] – Give color unlock vouchers (perfchatcolors.admin.voucher)
Database
• SQLite (default)
• MySQL (configurable)
