[综合][信息] VelocityTitle——适用于 Velocity 群组服的免费跨服称号插件[1.13.x-1.21.x]
# VelocityTitle**VelocityTitle** 是一个适用于 **Minecraft Velocity 群组服** 的称号插件。
它在 **Velocity 服务端** 统一创建并管理数据库来存储玩家称号，通过 **Velocity 和子服之间的消息通道** 同步数据，最终可在子服中通过 **PlaceholderAPI** 进行显示，后续也计划支持 **GUI** 操作。
本插件主要用于填补目前缺少**开源免费跨服称号插件**的问题。
项目完全开源，欢迎反馈问题与提交 PR。
---
## 项目地址
- GitHub：<https://github.com/redstarmc/velocitytitle>
- Issues：<https://github.com/redstarmc/velocitytitle/issues>
- Releases：<https://github.com/redstarmc/velocitytitle/releases>
---
## 一、插件特色
1. **适用于 Velocity 群组服**
支持在 Velocity 代理层统一管理称号，适合多子服统一称号系统。
2. **跨服同步**
通过 Velocity 与子服消息通道同步称号数据，实现跨服使用。
3. **开源免费**
项目完全开源，方便二次开发、审查与定制。
4. **支持 PlaceholderAPI**
可在子服通过 PAPI 占位符显示当前称号前后缀。
5. **统一称号管理**
称号创建、编辑、分配、收回、穿戴等操作均可在 Velocity 端完成。
6. **支持命令确认系统**
对敏感操作可增加确认步骤，降低误操作风险。
---
## 二、适用场景
1. 群组服统一称号系统
2. 跨服活动奖励称号
3. 捐赠称号 / 成就称号 / 身份称号
4. 多子服共享前缀、后缀展示
---
## 三、安装方法
1. **下载插件**
你可以使用统一的插件，也可以按平台分别下载对应版本。
注意：`core` 不是独立插件，不能直接安装运行。
2. **安装插件**
将对应平台插件放入服务端插件目录中。
注意：**Velocity 端必须安装**，否则插件无法正常工作。
3. **配置插件**
首次启动后根据配置文件说明完成配置。
4. **设置 PAPI**
可使用以下占位符：
- `velocitytitle_prefix`
- `velocitytitle_suffix`
---
## 四、命令说明
根命令：
- `/velocitytitle`
- `/vt`
命令结构说明：
- `<>` 为必填
- `[]` 为选填
- `()` 为可选项之一
### 1. 玩家操作
- `player divide <name> `
向指定玩家分配一个称号，不写玩家默认是自己
- `player list `
列出指定玩家拥有的全部可用称号，不写玩家默认是自己
- `player pick ( prefix | suffix | all )`
摘除指定类型的称号
- `player revoke <name> <player>`
收回指定玩家的某个称号
- `player wear <name> `
为指定玩家穿戴某个称号，不写玩家默认是自己
### 2. 称号操作
- `title create ( prefix | suffix ) <name> <display> `
创建一个称号，不填写描述时默认为“无”
- `title delete <name>`
删除指定称号
- `title edit <name> ( display | description ) <data>`
编辑称号显示名或描述
- `title list`
列出全部称号
- `title meta <name>`
查看指定称号详细信息
### 3. 其他命令
- `reload`
当前不稳定，暂时不要使用
- `help`
显示帮助列表
- `confirm`
执行等待确认的命令（仅在启用命令确认时可用）
- `cancel`
取消等待确认的命令（仅在启用命令确认时可用）
---
## 五、权限说明
- `velocitytitle.admin`
管理员权限，包含所有管理员应有权限
普通玩家使用相关命令时通常不需要额外配置权限。
---
## 六、使用注意
1. 称号的 `name` 请务必使用英文字母和下划线
2. 称号的 `display` 可使用英文双引号包裹以输入中文
3. `reload` 功能当前不稳定，暂时不建议使用
4. **Velocity 端必须安装插件**，否则整个系统无法正常工作
---
## 七、当前状态与开发计划
### 第一阶段目标
- 修复已知 bug
- 完善权限管理
- 增加命令确认系统
- [ ] 列表查询优化
### 第二阶段目标
- [ ] 配置文件热重载
- [ ] 支持 MySQL
- [ ] 添加 GUI
### 第三阶段目标
- [ ] Redis 内存数据库
- [ ] 支持模组服务端
- [ ] 数据库操作命令
---
## 八、插件定位
如果你正在寻找一个适用于 **Velocity 群组服**、支持**跨服同步**、且**开源免费**的称号插件，那么 **VelocityTitle** 可以作为一个直接可用并且便于后续扩展的方案。
---
## 九、开源与支持
本项目完全开源，欢迎提出建议、反馈问题、提交 Issue 或 PR。
- GitHub：<https://github.com/redstarmc/velocitytitle>
- Issues：<https://github.com/redstarmc/velocitytitle/issues>
- Releases：<https://github.com/redstarmc/velocitytitle/releases>
如果这个项目对你有帮助，欢迎 Star 支持。
页: [1]