# vMessage
> ⚠️ **警告：** LiteBans静默支持尚未经过测试。如果遇到任何问题，请在Discord上联系我：`szymon.off`
**vMessage** 是 Velocity 中最好的插件，用于在整个代理网络中同步聊天和玩家事件。 它专为希望在不增加不必要复杂性的情况下实现无缝、可靠且可配置的消息同步的服务器管理员而设计。
## 功能
- **全局聊天同步：** 立即同步连接到 Velocity 代理的所有服务器上的聊天消息。
- **加入/离开/更改服务器广播：** 当有人加入、离开或切换服务器时，向网络中的所有玩家发送通知。
- **静默权限：** 拥有特殊静默权限的玩家可以阻止他们的加入、离开和服务器更改消息被宣布。
- **强大的配置：** 具有强大、易于使用的配置文件，因此您可以将其配置为满足网络的需要。
- **轻量级和快速：** 没有不必要的特性或膨胀——只需高效、可靠的消息同步。
## 安装
1. 将 `vMessage.jar` 放入 Velocity 的 `plugins` 文件夹中。
2. 在代理和后端上安装 [SignedVelocity](https://modrinth.com/plugin/signedvelocity) 的适当版本。
3. 启动或重启 Velocity 代理。
4. 编辑生成的配置文件 (`plugins/vMessage/config.yml`) 以满足您的偏好。
安装并配置后，vMessage 将自动：
- 同步所有服务器上的聊天消息
- 将加入、离开和服务器切换事件广播给所有玩家（除非玩家拥有静默权限）
基本功能不需要命令或权限。
## 更新
要更新 vMessage，请将 `plugins` 文件夹中的现有 `vMessage.jar` 替换为最新版本并重启 Velocity 代理。
如果引入了新的配置选项，请务必更新您的配置文件。
配置文件在此处可用：[config.yml](https://github.com/szymon-off/vMessage/blob/master/src/main/resources/config.yml)
自动配置迁移尚未可用，但计划在未来版本中提供。
感谢您的理解。
## 命令
vMessage 提供了几个管理命令，用于高级用法和配置：
- `/vmessage say `
将消息作为指定的玩家跨网络发送。
**权限：** `vmessage.command.say`
- `/vmessage fake [player] [old-server]`
将虚假的加入、离开或服务器更改消息发送，就好像指定的玩家执行了该操作一样。
**权限：** `vmessage.command.fake`, `vmessage.command.fake.join`, `[...].leave`, `[...].change`
- `/vmessage reload`
在不重启代理的情况下重新加载插件配置。
**权限：** `vmessage.command.reload`
- `/vmessage help`
显示带有可用命令的帮助消息。
**权限：** `vmessage.command.help`
- `/broadcast `
在网络上广播自定义消息。
**权限：** `vmessage.command.broadcast`
**别名：** `/bc`, `/bcast`
- `/message `
将私人消息发送给网络中的特定玩家。
**权限：** `vmessage.command.msg`
**别名：** `/msg`, `/tell`, `/whisper`, `/w`
- `/reply `
回复最后给你发送私人消息的玩家。
**权限：** `vmessage.command.reply`
**别名：** `/r`
您还可以使用 `/vmsg` 或 `/vm` 作为 `/vmessage` 的别名，以获得便利。
请务必在 Velocity 配置文件中为您的工作人员或管理员角色分配适当的权限。
## 配置
vMessage 提供了强大且易于使用的配置文件。 您可以自定义消息格式、切换功能等等。 请参阅 `config.yml` 中的注释以获取详细信息。
## 为什么选择 vMessage？
- **专为 Velocity 设计：** 专门为 Velocity 设计，使其成为网络范围消息传递最可靠、功能最丰富的解决方案。
- **简单设置：** 放入，配置并开始使用。 没有复杂的依赖项或设置步骤。
- **积极维护：** 使用现代最佳实践构建，并欢迎社区反馈。
## 贡献
欢迎贡献！ 请提出问题或提交拉取请求以改进或修复错误。
## 从源代码构建
如果您想自己构建 vMessage：
- 前置条件：Java 17 或更高版本，Maven
- 克隆存储库并构建：
```bash
git clone https://github.com/szymon-off/vMessage.git
cd vMessage
mvn clean package
```
- 构建的 jar 将在 `target` 目录中。
## 许可
- **≤ 1.6.1** 的版本采用 **MIT 许可证**。
- **≥ 1.7.0** 的版本采用 **GNU 通用公共许可证 v3.0** (GPL-3.0)。
您可以找到每个许可的全文在相应版本档案中，或在 `LICENSE` 文件下获取该版本的仓库。