PlayerTitle 玩家称号插件

PlayerTitle 称号插件介绍

一、插件简介

PlayerTitle 是一款由开发者"丶米饭"制作的 Minecraft 服务器玩家称号插件，由国人开发完全适配中文100%汉化。它允许服务器管理员通过简单的指令或 GUI 界面创建、管理称号，玩家则可通过称号商店购买、使用称号，在聊天栏、Tab 列表和头顶显示个性化的称号标识。

该插件历经多年持续维护（当前已更新至 5.x 版本），支持从 1.7.2 到 1.21.x 的几乎所有主流服务端版本，兼容 Spigot、Paper、Purpur、Folia 等核心，是中文社区最成熟的称号插件之一[citation:4][citation:9]。
插件文档：米饭插件文档 - PlayerTitle
获取渠道：爱发电（AfDian）/ SpigotMC
开源协议：部分付费（源码可见，商业使用需授权）但免费版已经足够使用。
适用核心：Spigot / Paper / Purpur / Folia
版本支持：1.7.2 - 1.21.x
二、核心功能
基础功能
称号系统：支持创建无限数量的称号，每个称号可自定义名称、描述、材质、Lore。
三处显示：称号可在聊天栏、Tab 列表、玩家头顶三处独立开关显示。
称号商店：自带 GUI 商店界面，玩家可浏览和购买称号，支持按类型分类展示。
称号仓库：玩家拥有多个称号时，可通过仓库 GUI 自由切换当前使用的称号。
称号管理 GUI：管理员可通过可视化界面进行称号的增删改查，无需手动编辑配置文件。
称号卡系统：支持普通称号卡和随机称号卡，玩家使用后可获得对应天数的限时称号。
高级功能
称号 BUFF：每个称号可绑定 1 个或多个属性加成，支持 AttributePlus、SX-Attribute 属性标签、原版药水效果、MMOItems 属性、怪物休战等，共 5 种 BUFF 类型[citation:8]。
称号粒子特效：每个称号可设置独有的粒子效果，佩戴后在玩家周围展示，增强视觉逼格[citation:6]。
RGB 渐变色：1.16+ 服务器支持 16 位 RGB 颜色代码，可制作炫酷的渐变称号文字[citation:4]。
前后缀体系：支持展示称号（前缀）、属性称号（中缀/BUFF）、粒子称号（后缀）三类独立设置，三类称号互不影响[citation:3]。
称号数量奖励：当玩家收集达到一定数量的称号时，可自动发放奖励，自带 GUI 管理页面。
多样化购买方式：支持金币（Vault）、点券（PlayerPoints）、任意物品、称号币、权限、活动等多种途径获取称号[citation:4]。
限时与永久：称号可设置为限时（按天计算）或永久拥有，灵活适配各种运营活动。
数据与性能
双存储模式：支持 MySQL 和本地 SQLite 两种存储方式，小型服务器用文件、大型群组服用数据库。
UUID 存储：4.0.0+ 版本全面使用 UUID 存储玩家数据，避免改名导致数据丢失。
自动备份：4.5.2+ 版本支持自动全量备份数据至 backUp 文件夹，保障数据安全[citation:9]。
性能优化：在多个大型服务器上运行表现良好，可通过 timings on 查看性能影响。
PlaceholderAPI 支持：提供丰富的 PAPI 变量，可与其他插件（如计分板、聊天格式）深度联动[citation:3]。
三、适用场景
生存服：用称号区分玩家等级、职业、阵营，增强角色扮演感。
RPG 服：将称号与任务、成就系统绑定，作为玩家进度的荣誉标识。
小游戏服：获胜者自动获得限时称号，刺激玩家参与竞争。
VIP 体系：付费玩家获得专属炫酷称号，提升付费转化率。
活动运营：通过限时称号和活动称号，营造节日氛围和紧迫感。
四、安装与配置要点
安装步骤
下载对应版本的 PlayerTitle-x.x.x.jar 文件。
将 Jar 文件放入服务器的 plugins 目录。
重启或启动服务器，插件会自动生成配置文件目录 plugins/PlayerTitle/。
根据需求修改配置文件，使用 /plt reload 热重载（部分更改需重启）。
关键配置项

| 配置项 | 说明 |
| :--- | :--- |
| 存储方式 | 选择 mysql 或 sqlite，群组服务必使用 MySQL |
| 聊天显示称号 | 开关是否在聊天消息中展示称号前缀 |
| Tab 显示称号 | 开关是否在 Tab 列表中展示称号 |
| 头顶显示称号 | 开关是否在玩家头顶名称旁展示称号 |
| 称号币名称 | 自定义称号币的显示名称 |
| 语言文件 | 支持简体中文、繁体中文、English |
新增称号示例

在 titles.yml（或对应配置文件）中添加：

vip:
name: '&b&lVIP'
description: '&7尊贵的VIP玩家'
material: DIAMOND
lore:
- '&7特权标识'
price: 500
currency: vault # 金币购买
duration: 0 # 0为永久
rarity: epic
buff:
- 'potion:SPEED:2'
particle: FLAME
前置依赖（均为可选）
Vault：使用金币购买称号时需要。
PlayerPoints：使用点券购买称号时需要（要求 3.0.0+）。
PlayerCurrency：多货币系统支持（要求 1.0.3+）。
PlaceholderAPI：需要使用变量时安装。
五、常用命令
玩家命令

| 命令 | 说明 |
| :--- | :--- |
| /pt 或 /称号 | 打开称号主界面 |
| /pt shop | 打开称号商店 |
| /pt select <称号ID> | 选择并使用某个称号 |
| /pt clear | 取消当前佩戴的称号 |
| /pt list | 查看自己拥有的所有称号 |
管理员命令

| 命令 | 说明 |
| :--- | :--- |
| /pt reload | 重载配置文件 |
| /pt give <玩家> <称号ID> [秒数] | 给予玩家某个称号（可限时） |
| /pt take <玩家> <称号ID> | 收回玩家的某个称号 |
| /pt list [玩家] | 查看所有称号或指定玩家的称号 |
| /pt open | 打开称号管理 GUI |
注意：以上命令的具体格式以实际版本为准，部分版本使用 /playertitle 作为主命令。
六、权限节点

| 权限节点 | 说明 | 默认 |
| :--- | :--- | :--- |
| playertitle.use | 允许使用基础称号功能 | 所有玩家 |
| playertitle.shop | 允许打开称号商店 | 所有玩家 |
| playertitle.admin | 管理员权限，可使用所有管理命令 | OP |
| playertitle.bypasscost | 绕过购买费用 | OP |
| playertitle.title.<称号ID> | 允许使用指定称号 | 按需分配 |
七、PlaceholderAPI 变量大全

PlayerTitle 提供了丰富的 PAPI 变量，方便在其他插件中调用称号数据[citation:3]：
基础变量

| 变量 | 说明 |
| :--- | :--- |
| %playerTitle_use% | 玩家当前使用的展示称号名称 |
| %playerTitle_description% | 玩家当前展示称号的描述 |
| %playerTitle_buff% | 玩家当前展示称号的 BUFF 列表 |
| %playerTitle_particle% | 玩家当前展示称号的粒子效果 |
| %playerTitle_number% | 玩家拥有的称号总数 |
| %playerTitle_coin% | 玩家的称号币数量 |
分类变量（3.3.0+）

| 变量 | 说明 |
| :--- | :--- |
| %playerTitle_use_buff% | 当前属性称号名称 |
| %playerTitle_use_particle% | 当前粒子称号名称 |
| %playerTitle_description_buff% | 属性称号描述 |
| %playerTitle_description_particle% | 粒子称号描述 |
| %playerTitle_buff_buff% | 属性称号 BUFF 列表 |
| %playerTitle_particle_particle% | 粒子称号的粒子效果 |
高级变量（3.4.3+）

| 变量 | 说明 |
| :--- | :--- |
| %playerTitle_count_<称号ID>% | 指定称号的已售数量 |
| %playerTitle_have_<称号ID>% | 玩家是否拥有指定称号（true/false） |
| %playerTitle_use_id% | 当前展示称号的 ID |
| %playerTitle_use_buff_id% | 当前属性称号的 ID |
| %playerTitle_use_particle_id% | 当前粒子称号的 ID |
八、称号 BUFF 详解

每个称号可绑定 1 个或多个 BUFF，支持以下类型[citation:8]：
AttributePlus 属性标签：与 AttributePlus 插件联动，提供攻击力、防御力等自定义属性加成。
SX-Attribute 属性标签：与 SX-Attribute 插件联动，提供另一种属性体系支持。
原版药水效果：直接赋予玩家速度、力量、抗性 etc. 等原版状态效果。
MMOItems 属性：与 MMOItems 联动（要求 2.8.2+），提供高级物品属性加成。
怪物休战 BUFF：佩戴特定称号后，怪物不再主动攻击该玩家。

配置示例：

buff:
'potion:SPEED:2' # 速度 II
'potion:RESISTANCE:1' # 抗性 I
'attributeplus:attack:10' # 攻击力+10
九、称号粒子特效

从 2.3.0 版本起，每个称号可设置独有的粒子效果[citation:6]。佩戴该称号后，粒子会在玩家周围持续展示。

支持的部分粒子类型：

FLAME、HEART、CRIT、ENCHANT、PORTAL、CLOUD、DRIP_WATER、REDSTONE、SPELL、NOTE 等（具体以服务端版本支持为准）。

配置示例：

particle: FLAME # 火焰粒子环绕
十、RGB 渐变称号

1.16+ 服务器支持使用 16 位 RGB 颜色代码制作渐变效果[citation:4]。

格式示例：

&x&f&f&0&0&0&0VIP &x&f&f&5&0&0&0尊贵 &x&f&f&a&0&0&0玩家

上述代码会呈现从白色到红色再到绿色的渐变文字效果。配合 PlaceholderAPI 和聊天插件，可实现动态流动的渐变称号。
十一、前后缀体系（3.3.0+）

3.3.0 版本引入了三类独立称号体系[citation:4]：

| 类型 | 默认名称 | 作用 |
| :--- | :--- | :--- |
| 展示称号 | 前缀 | 在聊天、Tab、头顶显示的称号文字 |
| 属性称号 | 中缀 | 提供 BUFF 加成但不一定显示 |
| 粒子称号 | 后缀 | 提供粒子特效但不一定显示 |

三类称号可分别设置、分别佩戴，互不影响。管理员可在配置文件中自定义这三类的显示名称（如改为"前缀/中缀/后缀"）。
十二、注意事项
版本匹配：务必下载与服务端核心版本匹配的插件构建，特别是 1.13+ 材质名称变化较大。
存储选择：群组服（BungeeCord/Velocity）必须使用 MySQL，否则各子服数据不互通。
数据备份：升级大版本前务必备份整个 PlayerTitle 文件夹，4.x 从旧版升级有数据结构变化。
性能考量：称号粒子特效会持续运行，过多玩家同时佩戴粒子称号可能对 TPS 产生影响，建议限制粒子类型或数量。
YAML 语法：手动编辑称号配置时注意缩进和冒号后的空格，建议使用带 YAML 校验的编辑器。
PlaceholderAPI：如使用变量功能，需确保 PlaceholderAPI 已正确安装并注册了 playerTitle_ 系列变量。
十三、推荐联动插件

| 插件 | 联动效果 |
| :--- | :--- |
| Vault | 提供经济系统，支持金币购买称号 |
| PlayerPoints | 提供点券系统，支持点券购买称号 |
| PlaceholderAPI | 在计分板、聊天、菜单中展示称号变量 |
| LuckPerms | 配合权限节点精细化管理称号分配 |
| AttributePlus / SX-Attribute | 为称号提供深度属性 BUFF |
| ChestCommands | 在 GUI 菜单中展示和切换称号 |
| MMOItems | 为称号提供高级物品属性加成 |
十四、资源信息
官方文档：米饭插件文档 - PlayerTitle
下载地址：爱发电（AfDian）/ SpigotMC
交流群：插件文档内提供 QQ 群号
视频教程：B站有针对小白的安装配置视频教程
开源状态：部分付费（源码可见，商用需授权）
支持版本：1.7.2 - 1.21.x
兼容核心：Spigot, Paper, Purpur, Folia

制作 by LT-YHC