原创 闭源 娱乐 KazePlayerTitle 称号插件 2.0.0

# KazePlayerTitle 称号插件

**作者:** Kazemar_sama
**QQ:** 1518554438
**版本:** 2.0.0
**支持:** MC 1.20 - 1.21.11

---

## 最新测试修复

- 修复配置文件加载逻辑，已存在的配置不会被覆盖
- 修复称号过期后显示不及时更新的问题
- 修复通过命令/GUI切换称号时头顶和Tab显示不同步的问题
- 修复管理员移除称号时玩家显示没有更新的问题
- 优化数据库连接资源管理，防止连接泄漏
- 优化玩家退出时清理GUI分页缓存，防止内存泄漏
- 增加称号lore为空时的空指针保护

---

## 这插件能干啥？

给玩家整称号用的，聊天、Tab列表、头顶都能显示。支持称号商店，玩家可以自己买称号。

## 主要功能

- **三位置显示** - 聊天/Tab/头顶，想显示哪就显示哪
- **多货币购买** - 金币、点券、经验都能买，每个称号可以单独设置
- **称号有效期** - 可以设永久的，也可以设限时的
- **稀有度分级** - 普通/稀有/史诗/传说/神话，五个等级随便配
- **渐变色特效** - 支持RGB渐变色称号，好看
- **在线奖励** - 玩家在线够时间自动发称号
- **GUI界面** - 选称号和买称号都有界面，不用记命令
- **双存储** - YAML和MySQL都支持，小服用文件，大服用数据库
- **自定义变量** - PAPI变量可以自己配，想返回啥就返回啥

## 经济支持

| 类型 | 插件 | 说明 |
|------|------|------|
| vault | Vault | 常规金币 |
| points | PlayerPoints | 点券 |
| exp | 无需插件 | 经验值 |

每个称号可以单独设置用什么货币买，比如普通称号用金币，稀有称号用点券。

## 命令

**玩家用:**
- `/title` 或 `/称号` - 打开称号界面
- `/title shop` - 打开商店
- `/title select <称号>` - 选称号
- `/title clear` - 取消称号

**管理用:**
- `/ta reload` - 重载配置
- `/ta give <玩家> <称号> [秒数]` - 给称号
- `/ta take <玩家> <称号>` - 收回称号
- `/ta list` - 看所有称号

## PAPI变量

基础变量:
- `%kazetitle_title%` - 当前称号
- `%kazetitle_count%` - 拥有数量
- `%kazetitle_has_称号ID%` - 是否拥有

自定义变量在config.yml里配:
```yaml
custom-placeholders:
viptag: '&7[{title}&7]'
test: '随便写点啥'
```
用的时候 `%kazetitle_custom_viptag%`

## 称号配置示例

```yaml
vip:
name: '&b&lVIP'
lore:
- '&7尊贵的VIP玩家'
rarity: epic
price: 500
currency: points # 用点券买
duration: 0 # 永久
icon: DIAMOND
```

## 依赖

- Paper/Spigot 1.20+
- Vault (可选，用金币买称号需要)
- PlayerPoints (可选，用点券买称号需要)
- PlaceholderAPI (可选，用变量需要)

---

有问题QQ找我: **1518554438**