转载 开源 聊天 跨聊天 1.3.3

[MD]
# 跨聊天

Velocity 3.x 代理端插件，将所有后端服务器的聊天消息汇入同一个全局频道，所有在线玩家均可实时看到。

## 功能特性

- **跨服聊天** — 任意后端服务器发送的消息都会广播到所有（已配置的）服务器的全体玩家
- **自定义格式** — 可在 config.yml 中使用自定义颜色代码和占位符
- **支持 `&` 旧式颜色代码与 MiniMessage** — 自动识别格式，按需选用
- **LuckPerms 集成** — 可选功能；代理端安装 LuckPerms 后可自动获取前缀
- **服务器过滤** — 可指定哪些服务器参与全局聊天，排除大厅或小游戏服务器
- **无需重启即可切换** — 将 `enabled` 改为 `false` 并重启代理即可关闭插件

## 环境要求

| 依赖 | 版本要求 |
|---|---|
| Java | 17 或更高 |
| Velocity | 3.x（已对 3.4.0 进行测试） |
| LuckPerms（可选） | 5.x |

## 安装方式

1. 下载 velocityglobalchat-x.x.x.jar
2. 将其放入 Velocity 的 `plugins/` 目录
3. 重启代理 — `plugins/velocityglobalchat/`config.yml 将自动生成
4. 按需修改配置文件，然后再次重启代理

## 配置说明

配置文件路径：`plugins/velocityglobalchat/`config.yml

```yaml
# 是否启用插件
enabled: true

# 聊天格式 — 可用占位符：
# {server} — 后端服务器名称（如 HUB、SURVIVAL）
# {player} — 发送者的 Minecraft 用户名
# {prefix} — LuckPerms 前缀（未安装 LuckPerms 时为空）
# {message} — 聊天消息内容（始终为纯文本，防止注入）
#
# 使用 & 颜色代码或 MiniMessage 标签，二者不要混用。
format: "&8[&b{server}&8] &7{prefix}{player}&f: {message}"

# 参与全局聊天的服务器列表。
# 不在列表中的服务器的玩家既无法发送也无法接收全局消息。
# 留空则包含所有服务器。
servers:
- hub
- survival
- farming
```

## 格式示例

| 风格 | 示例 |
|---|---|
| 旧式 `&` 颜色代码 | `&8[&b{server}&8] &7{prefix}{player}&f: {message}` |
| MiniMessage | `<dark_gray>[<aqua>{server}`/aqua`>]`/dark_gray` <gray>{prefix}{player}`/gray`<white>: {message}`/white |

> **注意：** 无论使用何种格式风格，玩家消息内容始终以纯文本插入，可防止玩家通过颜色代码注入恶意内容。

## 工作原理

1. 玩家发送聊天消息时，代理端触发 `PlayerChatEvent`
2. 处理器通过 `player.getCurrentServer()` 获取该玩家当前所在的后端服务器
3. 使用 Adventure API（旧式或 MiniMessage）渲染格式字符串
4. 将渲染后的组件广播给所有当前服务器在配置列表中的玩家
5. 原始事件被拒绝 — 后端服务器不会收到该消息，因此不会产生本地回显

## 许可证

MIT — 详见 [LICENSE](https://modrinth.com/plugin/crosschat)
[/MD]