# 自定义聊天
> 📢 一个为 Paper 服务器设计的现代 Minecraft 聊天插件，具有完整的 PlaceholderAPI 支持和丰富的消息自定义功能。
CustomChat 是一个用于 Paper Minecraft 服务器的高度可定制聊天格式插件。 它可以根据权限创建不同的聊天格式，支持颜色、悬停消息、点击操作以及 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 集成。
CustomChat 专为性能和灵活性而设计，支持根据服务器版本使用传统的和现代的聊天事件。
---
## ✅ 特性
- 🧩 使用 **MiniMessage** 或 **传统颜色代码 (&)** 格式化聊天消息
- 🔐 基于**权限优先权**的多个聊天格式
- 🖱️ 支持 **悬停提示** 和 **点击操作** (建议命令，打开 URL 等)
- 🎨 可配置的消息颜色和格式
- 🛡️ 可选地阻止 `&k` 混淆文本代码
- 📦 与 **PlaceholderAPI** 集成，以获得动态的玩家信息
- ⚙️ 简单的 `/customchat reload` 命令，无需重启即可重新加载配置文件
---
## 📦 命令
| 命令 | 描述 | 权限 |
|-----------------------------|-------------------------------------------------|----------------------------|
| `/customchat reload` | 重新加载配置文件 | `customchat.admin` |
| `/chatcolor` | 打开颜色选择菜单 | `customchat.chatcolor` |
| `/customchat mentiontoggle` | 如果提及已启用，则按玩家切换 | `customchat.mentiontoggle` |
---
## 🔐 权限
| 权限 | 描述 |
|--------------------------------------------|---------------------------------------------------|
| `customchat.admin` | 允许访问 /customchat reload |
| `customchat.format.` | 允许使用指定的聊天格式 |
| `customchat.changecolor` | 允许更改自己消息的颜色 |
| `customchat.changeformat` | 允许更改自己消息的格式 |
| `customchat.chatcolor` | 允许访问 /chatcolor |
| `customchat.colorchat.color.` | 允许访问颜色chat中的特定颜色 |
| `customchat.colorchat.gradient.` | 允许访问颜色chat中的特定渐变 |
| `customchat.hover.item` | 允许访问 [item] |
| `customchat.hover.inv` | 允许访问 [inv] |
| `customchat.hover.ender` | 允许访问 [ender] |
| `customchat.mentiontoggle` | 允许访问 /customchat mentiontoggle |
---
## 🧠 工作原理
1. 插件加载 `config.yml` 中定义的聊天格式。
2. 当玩家发送消息时，插件：
- 检测其适用的格式（基于权限优先级）。
- 应用占位符，颜色和悬停/点击操作。
- 将格式化的消息发送给所有玩家和控制台。
3. 如果玩家拥有适当的权限，他们可以在消息中使用 & 颜色代码
4. 如果阻止了 `&k` ，并且玩家使用了它，他们将收到警告。
---
## 📥 安装
1. 下载插件 JAR。
2. 下载 [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi)
3. 将其放在你的 `plugins/` 文件夹中。
4. 重启服务器。
5. 配置 `config.yml` 并运行 `/customchat reload`。
---
### 💬 需要帮助或支持？
📖 维基：敬请期待…
加入我的 Discord 服务器（西班牙语/英语）：