# ChatTools - Velocity 跨服聊天插件
  
**ChatTools** 是一个专为 Minecraft Velocity 服务器设计的跨服聊天管理插件。 它支持 **全局消息同步**、**自定义服务器显示名称** 和 **跨服私聊**，增强了多服务器环境中的玩家沟通。
> **注意**: 此插件由 AI 开发，旨在简化跨服聊天管理。
---
## 功能
- **跨服消息同步**:
- 任何子服务器上的玩家发送的消息会实时广播给所有在线玩家。
- 消息格式包括 **服务器别名** 和 **玩家姓名**。
- **自定义服务器名称**:
- 通过配置文件定义服务器显示名称（例如，`lobby` → `主大厅`）。
- **跨服私聊**:
- 使用 `/tell` 或 `/msg` 命令向其他服务器的玩家发送私密消息。
- 消息仅对 **发送者**、**接收者**和 **控制台**可见。
- 支持在线玩家名称的自动完成。
- **动态配置**:
- 使用 `/chattools reload` 命令重新加载配置文件，无需重启服务器即可应用更改。
- **兼容性**:
- 支持 Velocity 3.4+ 和 Minecraft 1.16+。
---
## 安装
### 1. 下载插件
从 [GitHub](https://github.com/NSrank/ChatTools) 或其他分发渠道下载最新的 `ChatTools.jar`。
### 2. 安装插件
将下载的 `ChatTools.jar` 放入你的 Velocity 服务器的 `plugins/` 目录中。
### 3. 启动服务器
启动 Velocity 服务器。 插件将在 `plugins/ChatTools/config.yml` 处自动生成默认配置文件。
---
## 使用方法
### 命令
| 命令 | 权限 | 描述 |
|----------------------------|------------------------|---------------------------------------------------------------------|
| `/chattools reload` | `chattools.reload` | 重新加载插件配置文件，立即应用更改。 |
| `/tell ` | `chattools.command.tell` | 向其他服务器的玩家发送私密消息。 |
| `/msg ` | `chattools.command.tell` | `/tell` 命令的别名。 |
### 示例
1. **跨服聊天**
`Lobby` 服务器上的玩家发送：
```
[主大厅] Steve: 大家好！
```
`Survive` 服务器上的玩家回复：
```
[生存世界] Alex: 欢迎来到生存世界！
```
2. **跨服私聊**:
```
[主大厅] Steve → [生存世界] Alex: 最近怎么样？
```
---
## 配置文件
配置文件位于 `plugins/ChatTools/config.yml`：
```yaml
servers:
lobby:
name: "主大厅"
color: "AQUA"
survive:
name: "生存世界"
color: "GREEN"
minigame:
name: "迷你游戏区"
color: "YELLOW"
```
- **键** (例如，lobby) 是 **Velocity 服务器 ID**。
- **值** (例如，主大厅) 是在聊天中使用的 **显示名称**。
---
## 支持与反馈
如果您遇到任何问题或有改进建议，请通过以下渠道与我们联系：
- **GitHub Issues**: [提交问题](https://github.com/NSrank/ChatTools/issues)
---
## 许可与免责声明
- **开发声明**: 此插件由 AI 开发，旨在为 Minecraft Velocity 社区提供高效的聊天管理。
- **许可**: 采用 GNU 通用公共许可证 v3.0 许可。 您可以在许可条款下自由使用、修改和分发它。
- **免责声明**: 开发人员不对因使用本插件而产生的问题负责。
---
## 致谢
特别感谢以下技术和工具：
- [Velocity API](https://papermc.io/software/velocity)
- [SnakeYAML](https://github.com/snakeyaml/snakeyaml)
- [Adventure API](https://github.com/KyoriPowered/adventure?spm=a2ty_o01.29997173.0.0.7c5733f51H3mj8)
---
**中文版**：[Github](https://github.com/NSrank/ChatTools)