EzChat - Next Generation Chat - EzChat - 新一代聊天插件

EzChat 是一款高度可定制的聊天管理插件，允许服务器管理员完全控制聊天格式、颜色和交互功能。它支持现代的颜色代码和占位符，并能与其他插件无缝集成。

💡核心功能

• 完全可自定义的聊天格式与布局。
• 支持 1.16+ 的十六进制颜色代码，格式为 &[RRRR,GGGG,BBBB]。
• 可为聊天前缀、玩家名和后缀设置点击动作（执行命令、建议命令、打开链接）和悬停提示。
• 与 PlaceholderAPI 集成，可在格式中使用各种占位符。
• 基于权限系统分配不同的聊天格式。
• 可调整聊天事件的监听优先级，以兼容其他插件。

🎮配置文件详解

formats.yml

此文件用于定义所有聊天格式。每个格式都是一个独立的配置块。

基础结构：

default-priority-ordering: LOWER_FIRST
formats:
  - ==: me.fixeddev.ezchat.format.BaseChatFormat
    name: format_name
    priority: 1000
    permission: permission.node
    use-placeholderapi: true
    # ... 其他字段

主要字段说明：

• default-priority-ordering：优先级排序方式。

-   `LOWER_FIRST`：选择玩家拥有的**优先级最低**的格式。

-   `HIGHER_FIRST`：选择玩家拥有的**优先级最高**的格式。

• name：格式的唯一标识名称。
• priority：格式的优先级（数字）。数值越小，在实际排序中可能越优先或越靠后，具体取决于 default-priority-ordering 的设置。
• permission：玩家需要拥有此权限节点才能使用该格式。例如：ezchat.format.vip。
• use-placeholderapi：是否在此格式中解析 PlaceholderAPI 占位符。

格式组件：

每个格式可以定义以下部分的外观和行为

• prefix：聊天信息前的固定前缀文本。
• player-name：玩家名字的显示格式，可使用 {displayName} 或 {name} 等变量。
• suffix：玩家名后的固定后缀文本。
• chat-color：聊天正文的默认颜色（使用 & 颜色代码或十六进制代码）。

交互动作：

对于 prefix、player-name 和 suffix，可以设置：

• -click-action：点击该部分时执行的动作。

-   `EXECUTE`：执行一条命令。

-   `SUGGEST`：在聊天栏中建议一条命令。

-   `OPEN`：打开一个网页链接。

-   `''`：留空表示无动作。

• -tooltip：鼠标悬停时显示的提示文本列表。

创建新格式：

• 复制一个现有格式的完整配置块（从 - ==: 开始到下一个 - 之前结束）。
• 将其粘贴为新的一行。
• 修改 name、priority、permission 等字段以符合你的需求。

config.yml

此文件用于调整插件的基础行为。

主要设置：

• chat-event-priority：控制 EzChat 处理聊天事件的优先级。如果与其他插件冲突，可以调整此值。

-   **可选值**：`LOWEST`, `LOW`, `NORMAL`, `HIGH`, `HIGHEST`, `MONITOR`

-   **默认值**：`NORMAL`

-   **说明**：数值越高（如 `MONITOR` 最高），该处理器执行得越晚。如果 EzChat 的格式被其他插件覆盖，请尝试调高此值。

🔧使用与配置步骤

• 安装插件：将 EzChat 放入服务器的 plugins 文件夹并重启服务器。
• 基础配置：根据需求编辑 config.yml，特别是 chat-event-priority。
• 设计聊天格式：编辑 formats.yml。

-   决定优先级排序方式（`LOWER_FIRST` 或 `HIGHER_FIRST`）。

-   修改默认的 `default` 和 `vip` 格式，或创建新的格式。

-   为每个格式设置独特的 `prefix`、`chat-color` 和 `permission` 节点。

• 分配权限：使用权限管理插件（如 LuckPerms）将 ezchat.format.<格式名> 权限授予相应的玩家或组。
• 重载配置：在游戏内使用 /ezchat reload 重载配置，或重启服务器使更改生效。

❓常见问题

• 问：如何设置彩色聊天？

-   答：在格式的 `chat-color` 字段中使用颜色代码，例如 `'&c'` 代表红色，或使用十六进制代码 `'&[FF5555]'`。

• 问：玩家没有显示正确的格式？

1.  检查玩家是否拥有对应格式的权限（`ezchat.format.格式名`）。

2.  检查 `formats.yml` 中该格式的 `priority` 设置，并确认 `default-priority-ordering` 规则是否符合预期。

3.  检查是否有其他插件（如聊天管理或权限插件）冲突，尝试在 `config.yml` 中提高 `chat-event-priority`。

• 问：如何让玩家名可点击并执行命令？

-   答：在格式中设置 `player-name-click-action: '[EXECUTE] /tell {name} Hello'`。点击玩家名就会对点击者执行 `/tell 玩家名 Hello`。

• 问：支持 PlaceholderAPI 吗？

-   答：支持。确保已安装 PlaceholderAPI，并在格式中设置 `use-placeholderapi: true`，即可在文本中使用 `%placeholder%` 格式的占位符。

✨附加信息

• 插件演示（西班牙语）：你可以在 YouTube 上搜索 “Sortexx 19” 查看相关的评测或展示视频。
• 配置技巧：建议先备份原始的 formats.yml 文件，再进行修改。从复制和修改现有格式开始是最安全的方式。