ChatColor+ - 聊天色彩插件

ChatColor+ Premium 是一款功能强大的聊天与界面颜色管理插件，它允许玩家通过图形界面（GUI）或命令自定义聊天、名称、标签页、告示牌的颜色以及字体样式。本插件是原免费版 ChatColor+ 的重构与增强版本，修复了大量问题并引入了诸多新特性，例如完整的 MySQL 支持、自定义字体、彩虹色等。

💡版本说明

ChatColor+ 项目已存在超过 8 年，拥有超过 20 万次下载。由于早期代码结构问题，旧版免费版本已难以维护和更新。因此，作者决定：

• 免费版：继续提供，但将不再获得更新或技术支持。
• Premium 版：完全重写，修复错误，增加新功能，并作为付费版本发布，以支持作者的持续开发工作。

✨核心特性

• 图形界面 (GUI) 管理：玩家可通过 GUI 直观选择颜色。
• 颜色混合：拥有权限的玩家可通过右键点击混合多种颜色。
• 多区域支持：可分别设置聊天、名称、标签页、告示牌颜色及字体。
• MySQL 支持：跨服同步玩家的颜色设置。
• 自定义字体：支持创建并使用 Unicode 艺术字体。
• PlaceholderAPI 支持：可在其他插件中调用玩家的颜色数据。
• 高度可配置：所有 GUI 物品、消息、权限均可通过配置文件自定义。
• 强大的 API：方便开发者进行集成。

与免费版的区别

• 稳定可用的 MySQL 支持
• 字体系统
• 新增 / setColorString 命令
• 新增 / help 命令
• 支持多次混合颜色
• 更少的 Bug，更高效的代码
• 告示牌颜色支持
• 更完善的 API
• 兼容更多聊天插件
• 更细致的权限控制
• 兼容 Minecraft 1.12 及以上版本
• 支持 PlaceholderAPI
• 重载命令 (/chatcolorplus reload)

🔧使用方法

玩家只需执行对应命令即可打开 GUI 进行选择

• /chatcolor - 聊天颜色
• /namecolor - 名称颜色
• /tabcolor - 标签页颜色
• /signcolor - 告示牌颜色
• /font - 字体

**GUI 操作**

• 左键点击：选择该颜色/字体。
• 右键点击：混合当前颜色（需拥有相应权限）。

🎮命令列表

<color> 可替换为：chatcolor, signcolor, namecolor, tabcolor, font（font 无 setColorString 命令）。

• /<color> - 打开对应颜色的 GUI
• /<color> help - 显示帮助信息
• /<color> set <ColorName> <Player> - 为指定玩家设置颜色
• /<color> get <Player> - 查看指定玩家的当前颜色
• /<color> remove <Player> - 移除指定玩家的当前颜色
• /chatcolorplus reload - 重载插件配置
• /<color> setColorString <ColorString> <Player> - 使用颜色代码字符串为玩家设置颜色（例如：/chatcolor setColorString &4&l Chemmic）

**`<ColorName>` 可选值**

Black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white, magic, bold, strikethrough, underline, italic。

⭐权限节点

• <color>.use - 允许玩家打开对应颜色的 GUI。（例如：chatcolor.use）
• <color>.op - 允许玩家使用所有其他颜色命令。
• <color>.MixColor.multiply.<ColorName> - 允许玩家将所选颜色与特定颜色多次混合。
• <color>.<ColorName> - 在 GUI 中添加特定颜色供玩家选择。
• <color>.rainbow - 在 GUI 中添加彩虹色。
• MixColor.use - 允许玩家混合颜色。
• MixColor.multiply.use - 允许玩家多次混合颜色。
• chatcolorplus.reload - 允许玩家重载插件。
• <color>.groups.<GroupName> - 为指定权限组设置默认颜色（需在对应 ColorConfig.yml 中配置组）。例如：TabColor.groups.vip。
• <Color>.all - 为玩家 GUI 添加所有颜色。例如：ChatColor.all。
• <Color>.MixColor.multiply.all - 允许玩家与所有颜色进行多次混合。例如：NameColor.mixcolor.multiply.all。

❓PlaceholderAPI 占位符

• %ChatColorPlusPremium_chat_color% - 玩家的聊天颜色代码
• %ChatColorPlusPremium_chat_color_name% - 玩家的聊天颜色名称
• 可将 chat 替换为 sign、name、tab 以获取相应颜色。
• 字体占位符：%ChatColorPlusPremium_font%

🔧配置文件

插件会生成 8 个配置文件，结构类似但可独立配置：

• ChatConfig.yml
• FontConfig.yml
• NameConfig.yml
• SignConfig.yml
• TabConfig.yml
• GeneralConfig.yml
• MySqlConfig.yml
• ColorConfig.yml（当 MySQL 未启用时存储玩家数据，不建议手动修改）

配置示例 (TabConfig.yml 节选)

size: 27 # 库存大小，必须是 9 的倍数
title: '&6Choose your TabColor:'
mix-title: '&6Mix your TabColor:'
TabColor:
  default: '&f' # 默认颜色
Reset:
  Name: '&4Click to reset your ChatColor!'
  Lore:
    - '&6Change your ChatColor back to normal again!'
  ItemID: 20
  InventoryPosition: 18
Message:
  color:
    changed: '%prefix%&eYour &6TabColor &ehas been changed to%color-code% %color-name%&e!'
    reset: '%prefix%&eYou have &creset &eyour &6TabColor &e!'
NormalColors:
  BLACK:
    Name: '&0black'
    Lore:
      - '&6Left-click &eto select this color!'
      - '&6Right-click &eto mix this color with other colors'
    ItemID: '35:15'

字体配置 (FontConfig.yml)

您可以在 FontConfig.yml 中创建自定义字体。

title: '&6Choose your Font:'
size: 27
Fonts:
  ExampleFont:
    letter-small: ⓐⓑⓒⓓⓔⓕⓖⓗⓘⓙⓚⓛⓜⓝⓞⓟⓠⓡⓢⓣⓤⓥⓦⓧⓨⓩ
    letter-big: ⒶⒷⒸⒹⒺⒻⒼⒽⒾⒿⓀⓁⓂⓃⓄⓅⓆⓇⓈⓉⓊⓋⓌⓍⓎⓏ
    Permission: ExampleFont.use # 需要此权限才能在 GUI 中看到该字体
    ItemID: '1'
    ItemTitle: '&eClick to select the ExampleFont!'

MySQL 配置

在 MySqlConfig.yml 中，将 ACTIVE 设为 true 并填入正确的数据库信息即可启用跨服数据同步。若连接失败，插件将自动回退至文件存储。

⭐彩虹色 (Rainbow)

从 1.2 版本开始，所有颜色类型均支持彩虹色。

• 权限：<Color>.rainbow（例如 chatcolor.rainbow）
• 在配置文件中，可以定义彩虹色循环的颜色列表和是否随机选择。

🎮开发者 API

将插件 Jar 文件添加到您的项目后，可以使用以下 API 方法：

// 设置玩家颜色
ChatColorPlus.setColor(ColorEnum, Player, String colorCode, String colorName);
// 示例：设置玩家聊天颜色为深红色加粗
ChatColorPlus.setColor(ColorEnum.CHATCOLOR, player, "&4&l", "dark_red_bold");

// 获取玩家的颜色代码
String colorCode = ChatColorPlus.getColor(ColorEnum, Player);

// 获取玩家的颜色名称
String colorName = ChatColorPlus.getColorName(ColorEnum, Player);

// 获取插件前缀
String prefix = ChatColorPlus.getPrefix();

🔧注意事项与许可

• 许可协议摘要：
• 允许商业使用。
• 禁止修改源代码或二进制代码（禁止创建衍生作品）。
• 必须注明软件来源。
• 禁止对软件进行逆向工程、反编译。
• 软件按“原样”提供，不提供任何担保。
• 购买后不提供退款。

• 捐赠支持：如果您喜欢这个插件并想支持开发，可以通过 PayPal 向 [email protected] 捐赠任何金额。

• 重要提醒：严禁反编译本插件或使用其代码。