## 描述
SimpleCrossChat 是一个轻量级的 Minecraft 插件，旨在实现跨服务器通信。专为 Minecraft 版本
1.21 构建，它通过集成 MQTT 代理提供简便的方式，允许玩家在全球范围内跨服务器共享消息。虽然
功能强大，但需要仔细设置以确保安全和适当的使用。
## Java 版本
从 Minecraft 1.21 开始，Spigot 和相关平台需要 **Java 21**。
## 功能
- **即插即用功能**: 添加到 plugins 文件夹后立即生效。
- **全球消息支持**: 玩家可以实时跨服务器聊天。
- **可定制的通信安全**: 通过托管私有 MQTT 代理来加强您的设置。
- **基于 MQTT 的消息传递**: 轻量级且高效。
- **广播消息格式**: 自定义消息的外观。
- **未来的可扩展性**: 计划支持通过外部插件进行消息过滤。
## 重要提示
### 全球消息处理
- **无频道**: 所有全球聊天消息都发送到代理，然后代理将其与所有通信
伙伴共享。这意味着**每条全球消息**都可供连接到代理的方访问。
- **第三方风险**: 使用公共代理时，例如默认的 `test.mosquitto.org`，全球消息可能
理论上会被第三方拦截。为了隐私，强烈建议您托管自己的代理。
- **消息范围**: 只有 **全球聊天消息**才会被广播。私信、广播或来自其他
插件的消息不会通过代理共享。为了确保透明，请告知玩家此行为。
## 设置
1. **安装 MQTT 代理**:
- 默认情况下，插件使用 `test.mosquitto.org` (一个公共代理)。
- 为了获得更好的安全性，请设置和配置您的私有代理。
2. **插件安装**:
- 将插件 JAR 文件放入服务器的 `plugins` 文件夹中。
3. **配置** (可选但推荐):
- 更新 `plugins/simplecrosschat` 中的 `options.yml` 文件以自定义设置，例如代理地址。
4. **重启/重新加载服务器**:
- 通过重启或重新加载服务器来应用更改。
5. **验证通信**:
- 确保插件连接到代理并且消息被传输。
## 插件配置
根据需要修改 `options.yml` 文件。这是一个例子：
```yaml
donottouch:
configexists: true
debug:
showmessages: false
general:
info: '- INFO: id 和 key 在其他服务器上必须匹配，以启用全局聊天，
一个值不同，它将无法工作'
servername: YourServerName
broadcastmessageformat: '&a%PLAYER% &0| &f%MESSAGE%'
enabled: true
privacyinfo: '- INFO: 即使消息对于外人来说不可读，
我也会托管自己的代理以进行安全通信！'
technical:
broker:
address: test.mosquitto.org
protocol: tcp
port: 1883
communication:
channel:
id: simplecrosschatwelcome
key: z87d3z8hde3z8
```
## 安全建议
- **托管私有代理**: 使用公共代理会使通信暴露于潜在的拦截。为了安全运行，请设置私有 MQTT
代理。
- **加密**: 插件使用 `AES/CBC/PKCS5Padding` 进行加密，但即使在公共代理上，这也不能完全抵御第三方
访问。
- **告知玩家**: 让玩家知道全球消息通过代理共享，并且如果使用公共代理，理论上可能被
拦截。
## 用法
1. 将插件安装到服务器的 `plugins` 文件夹中。
2. 可选地使用自定义代理地址和设置配置 `options.yml` 文件。
3. 重新启动或重新加载服务器以激活插件。
4. 现在，玩家可以使用全球聊天跨服务器进行通信。
## 声明
本插件按“现状”提供，不提供任何担保。 开发者不对以下事项负责：
- 隐私问题或插件的滥用。
- 第三方拦截或嗅探消息。
- 在不同地区使用此插件的法律影响 (例如，欧盟关于用户数据的法律)。
服务器所有者或技术顾问有责任确保正确、安全和合法地使用此插件。