ChatColor - 聊天颜色样式插件

ChatColor 是一款允许玩家自由更改聊天颜色与样式的插件，支持超过1600万种色彩选择，涵盖所有Minecraft原生颜色、修饰符及十六进制（HEX）色值，让每位玩家的聊天信息都独一无二。

💡功能特色

• 为玩家的聊天信息应用超过1600万种可能的颜色。
• 全面支持传统颜色代码、十六进制色值、彩虹色及渐变色，提供极高的自定义自由度。
• 所有修饰符均可使用，包括粗体、斜体、<u>下划线</u>，甚至混淆字符。
• 支持 MySQL 与 MariaDB，确保玩家颜色在所有服务器间保持一致。
• 支持从控制台设置颜色，便于作为捐赠奖励集成。
• 提供完整的权限节点，可精细控制玩家对颜色和功能的访问。
• 自定义颜色系统，便于创建并保存您喜爱的十六进制、彩虹色或渐变色。
• 群组颜色系统，可通过权限为特定组设置固定颜色。
• 所有插件消息均可自定义。
• 提供完全可自定义的GUI界面，用于高级颜色选择。
• 可调整插件功能的各项设置。
• 作者乐于提供友好、及时的帮助！

> 注意：下文提供了关于命令、权限、颜色、修饰符和设置的详细说明。

🎮命令与用法

**格式说明**

• <值> 表示必填参数。
• [值] 表示可选参数。

主要命令

• /chatcolor [玩家] <颜色/default> [修饰符] - 更改自己或指定玩家的聊天颜色！
• 要使用自定义颜色，请执行：/chatcolor [玩家] %<名称>。名称在 custom-colors.yml 配置文件中定义。

> 注意：十六进制颜色的格式为 &#RRGGBB，其中 # 后的每个字符必须是 0-9 或 a-f 之间的数字或字母。

管理员命令

• /chatcolor reload - 重载所有配置文件（修改配置后使用）。
• /chatcolor reset - 谨慎使用，将配置重置为默认状态。
• /chatcolor set <设置项> <值> - 更改众多设置中的某一项（详情见下文）。
• /chatcolor confirm - 确认一项设置更改。
• /chatcolor group <add/remove/list> [名称] [颜色] - 添加、移除或列出群组颜色。可通过权限为群组赋予聊天颜色。
• /chatcolor custom <add/remove/list> [名称] [颜色] - 添加、移除或列出自定义颜色。颜色必须是有效的自定义颜色字符串。
• /chatcolor pause - 暂停您的聊天颜色（临时移除），以便无干扰地与其他聊天插件交互。

其他玩家命令

• /chatcolor - 显示您当前的聊天颜色！
• /chatcolor clear - 完全移除您的聊天颜色。
• /chatcolor gui - 打开GUI界面来选择颜色！
• /chatcolor <add/remove> <修饰符> - 为您的聊天颜色添加或移除一个修饰符。
• /chatcolor available - 显示您可用的颜色和修饰符！
• /chatcolor help - 显示命令帮助信息。

🔧可自定义的GUI

GUI界面可通过配置文件 gui.yml 进行完全自定义。配置文件中提供了创建自定义GUI的说明，并内置了三个示例GUI（分别对应普通颜色、十六进制颜色和自定义颜色），开箱即用。

**有效的物品类型**

• COLOUR
• MODIFIER
• INVENTORY
• FILLER
• COMMAND

您可以在命令中使用 %player% 占位符来代表玩家名称。如需任何帮助，欢迎随时联系作者！

✨设置

所有设置均可在 config.yml 中找到。请查阅插件的Wiki页面以了解每个设置项的具体功能。

⭐颜色与修饰符

有效颜色代码

• 0 或 black
• 1 或 dark.blue
• 2 或 dark.green
• 3 或 dark.aqua
• 4 或 dark.red
• 5 或 dark.purple
• 6 或 gold
• 7 或 gray
• 8 或 dark.gray
• 9 或 blue
• a 或 green
• b 或 aqua
• c 或 red
• d 或 light.purple
• e 或 yellow
• f 或 white
• 所有十六进制颜色，格式为 #RRGGBB

有效修饰符代码

• k 或 obfuscated
• l 或 bold
• m 或 strikethrough
• n 或 underlined
• o 或 italic

❓权限节点

• chatcolor.* - 授予玩家所有ChatColor权限。注意：拥有此权限将无法使用自定义颜色！
• chatcolor.use - 允许玩家使用 /chatcolor 和 /chatcolor cmdhelp。
• chatcolor.clear - 允许玩家清除自己的聊天颜色。
• chatcolor.use-color-codes - 允许玩家在聊天中使用 & 颜色代码。
• chatcolor.use-hex-codes - 允许玩家使用十六进制代码为聊天着色（允许使用所有颜色！）。
• chatcolor.special - 允许玩家通过 /chatcolor 命令使用彩虹色和渐变色。不允许使用预设的自定义颜色。
• chatcolor.gui - 允许使用GUI选择颜色。
• chatcolor.color.* - 允许玩家使用所有颜色。
• chatcolor.color.<颜色> - 允许玩家使用特定颜色（请使用上方列出的数字或字母代码）。
• chatcolor.modifier.* - 允许玩家使用所有修饰符。
• chatcolor.modifier.<修饰符> - 允许玩家使用特定修饰符（请使用上方列出的字母代码）。
• chatcolor.change.* - 允许玩家更改所有人的聊天颜色。
• chatcolor.change.self - 允许玩家更改自己的颜色。
• chatcolor.admin - 允许玩家使用所有管理员命令。
• chatcolor.group.<颜色名称> - 为玩家/群组设置群组颜色。
• chatcolor.custom.<颜色名称> - 授予玩家访问特定自定义颜色的权限。

> 注意：在颜色和修饰符的权限节点中，必须使用上方列出的数字或字母代码。

✨PlaceholderAPI 占位符

本插件提供以下占位符

• %cc_full_color% - 返回玩家的完整颜色（颜色+修饰符）。可用于后续文本着色。注意：彩虹色和渐变色不会显示！
• %cc_color% - 仅返回玩家的颜色部分（不含修饰符）。
• %cc_color_name% - 返回玩家颜色的名称或字符，例如 a、b、c 或 %custom-name。
• %cc_colored_color_name% - 与 %cc_color_name% 相同，但返回的文本已应用该颜色。
• %full_color_name% - 返回玩家颜色的完整单词版本，例如 red、black、dark green。
• %colored_full_color_name% - 与 %cc_full_color_name% 相同，但返回的文本已应用该颜色。
• %cc_modifiers% - 仅返回玩家的修饰符部分（不含颜色）。可用于后续文本修饰。
• %cc_modifier_names% - 返回修饰符名称，例如 l、mn、lmn。
• %cc_modified_modifier_names% - 与 %cc_modifier_names% 相同，但返回的文本已应用这些修饰符。
• %cc_full_modifier_names% - 返回玩家修饰符的完整单词版本，例如 bold、italic。
• %cc_modified_full_modifier_names% - 与 %cc_full_modifier_names% 相同，但返回的文本已应用这些修饰符。
• %cc_group% - 返回玩家当前激活的群组名称，如果没有则返回 "None"。
• %cc_<颜色/修饰符>_available% - 根据玩家是否拥有必要权限，返回 messages.yml 中的 'gui-available' 或 'gui-unavailable'。例如：%cc_a_available%
• %cc_modifiers_spaced% - 返回玩家当前修饰符的列表，以空格分隔。

🔧视频展示

由 Barbercraft 制作的插件展示视频。

✨数据收集

本插件使用 bStats 收集一些关于插件使用情况的统计信息，并发送至 https://bstats.org/。您可以通过将 config.yml 中的 stats 设置为 false 来禁用此功能。收集的统计数据包括版本分布、服务器/玩家统计、服务器位置、操作系统等。向公众公开的统计数据包括版本分布、服务器位置、排名、Java版本和全球统计，可在 https://bstats.org/plugin/bukkit/ChatColor2 查看。

💡问题与支持

获取帮助

如果您需要插件方面的帮助或支持，请加入我们的支持Discord服务器：https://discord.gg/hNBtt9cDk4。此外，请查阅插件Wiki（建设中）以获取关于配置和使用插件的更详细信息。

报告漏洞

如果您发现任何漏洞，请务必报告！漏洞报告对我至关重要，能帮助我了解问题所在并进行修复。您可以通过以下方式报告：

• GitHub
• 直接私信作者
• 加入本文档顶部显示的支持Discord服务器