[综合][信息] 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]
  向指定玩家分配一个称号，不写玩家默认是自己

• player list [player]
  列出指定玩家拥有的全部可用称号，不写玩家默认是自己

• player pick ( prefix | suffix | all )
  摘除指定类型的称号

• player revoke <name> <player>
  收回指定玩家的某个称号

• player wear <name> [player]
  为指定玩家穿戴某个称号，不写玩家默认是自己

2. 称号操作

• title create ( prefix | suffix ) <name> <display> [description]
  创建一个称号，不填写描述时默认为“无”

• 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 端必须安装插件，否则整个系统无法正常工作  

---

七、当前状态与开发计划

第一阶段目标

• [x] 修复已知 bug
• [x] 完善权限管理
• [x] 增加命令确认系统
• [ ] 列表查询优化

第二阶段目标

• [ ] 配置文件热重载
• [ ] 支持 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 支持。