- 版权类型
- 原创
- 插件中文名称
- 航式段位
- 插件英文名称
- HangPvpTitles
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]
# HangPvpTitles - PVP段位称号系统
> 一款功能强大的PVP称号系统插件,通过击杀获得积分,自动解锁段位称号,支持排行榜、死亡扣分、自定义奖励等丰富功能。
---
## ✨ 核心特性
- ✅ **PVP积分系统** - 击杀获得积分,支持自定义积分公式
- ✅ **自动称号管理** - 根据积分自动解锁和升级称号
- ✅ **死亡扣分机制** - 支持多种扣分公式,增加游戏策略性
- ✅ **防刷分系统** - 防止同一玩家重复击杀刷分
- ✅ **排行榜系统** - 积分、K/D比率、连杀排行榜
- ✅ **自定义奖励** - 称号升级时执行自定义命令奖励
- ✅ **聊天段位前缀** - 可强制在聊天消息前显示段位(类似MV)
- ✅ **零积分保护** - 击杀0积分玩家不获得积分,防止欺负新人
- ✅ **初始积分设置** - 新玩家可配置初始积分
- ✅ **PlaceholderAPI** - 完整的变量支持,可用于其他插件
- ✅ **完全可配置** - 所有消息、公式、称号都可自定义
---
## 🎮 主要功能
### 1️⃣ PVP积分系统
- 击杀玩家获得积分
- 支持自定义积分计算公式
- 连杀加成系统
- 基于被击杀者积分的动态奖励
- 零积分保护(可配置)
### 2️⃣ 段位称号系统
- 根据积分自动解锁称号
- 支持称号前缀显示
- 玩家可自由切换已解锁的称号
- 称号升级自动奖励
- 聊天强制显示段位前缀(可配置格式)
### 3️⃣ 死亡扣分系统
- 仅PVP死亡扣分(环境死亡不扣分)
- 支持三种扣分公式:
- `deaths`: 连续死亡次数
- `fixed`: 固定扣分值
- `custom`: 自定义公式
- 击杀后重置连续死亡次数
- 可设置最大扣分和最低积分
### 4️⃣ 防刷分机制
- 同一玩家击杀冷却时间
- 击杀频率限制
- 防止恶意刷分
### 5️⃣ 排行榜系统
- 积分排行榜
- K/D比率排行榜
- 最高连杀排行榜
- 支持分页显示
### 6️⃣ 奖励系统
- 称号解锁时执行奖励命令
- 支持多条命令奖励
- 丰富的变量替换支持
- 奖励不会重复发放(掉段后重新升段不重复)
---
## 📝 命令列表
### 玩家命令
| 命令 | 说明 |
|:---|:---|
| `/pvptitles help` | 显示帮助信息 |
| `/pvptitles stats [玩家]` | 查看PVP统计 |
| `/pvptitles top [页数]` | 查看积分排行榜 |
| `/pvptitles topkd [页数]` | 查看K/D排行榜 |
| `/pvptitles topkillstreak [页数]` | 查看连杀排行榜 |
| `/title` | 管理你的称号 |
| `/title list` | 查看称号列表 |
| `/title set <称号ID>` | 设置称号 |
| `/title remove` | 移除当前称号 |
| `/title info <称号ID>` | 查看称号详细信息 |
### 管理员命令
| 命令 | 说明 |
|:---|:---|
| `/pvptitles reload` | 重载配置文件 |
| `/pvptitles set <玩家> <积分>` | 设置玩家积分 |
| `/pvptitles add <玩家> <积分>` | 添加玩家积分 |
| `/pvptitles remove <玩家> <积分>` | 移除玩家积分 |
| `/pvptitles reset <玩家>` | 重置玩家数据 |
| `/pvptitles preview <玩家> <称号>` | 预览称号奖励 |
| `/pvptitles testreward <玩家> <称号>` | 测试称号奖励 |
---
## 🔑 权限节点
| 权限 | 说明 | 默认 |
|:---|:---|:---:|
| `pvptitles.use` | 使用基础功能 | true |
| `pvptitles.admin` | 管理员权限 | op |
| `pvptitles.title.<称号ID>` | 特定称号权限 | 可选 |
---
## 🔗 PlaceholderAPI 变量
### 基础统计
| 变量 | 说明 |
|:---|:---|
| `%pvptitles_score%` | 玩家总积分 |
| `%pvptitles_kills%` | 击杀数 |
| `%pvptitles_deaths%` | 死亡数 |
| `%pvptitles_kd%` | K/D比率 |
### 连杀相关
| 变量 | 说明 |
|:---|:---|
| `%pvptitles_killstreak%` | 当前连杀数 |
| `%pvptitles_max_killstreak%` | 最高连杀记录 |
### 称号相关
| 变量 | 说明 |
|:---|:---|
| `%pvptitles_title%` | 当前称号名(带颜色) |
| `%pvptitles_title_raw%` | 当前称号名(无颜色) |
| `%pvptitles_title_id%` | 当前称号ID |
| `%pvptitles_prefix%` | 称号前缀 |
| `%pvptitles_titles_count%` | 已解锁称号数量 |
### 进度相关
| 变量 | 说明 |
|:---|:---|
| `%pvptitles_next_title%` | 下一个称号名称 |
| `%pvptitles_next_title_score%` | 下一称号所需积分 |
| `%pvptitles_next_title_needed%` | 还需多少积分 |
| `%pvptitles_next_title_progress%` | 进度百分比 |
| `%pvptitles_rank%` | 玩家排名 |
### 排行榜变量
| 变量 | 说明 |
|:---|:---|
| `%pvptitles_top_<排名>_name%` | 第N名玩家名 |
| `%pvptitles_top_<排名>_score%` | 第N名积分 |
| `%pvptitles_top_<排名>_kills%` | 第N名击杀数 |
---
## ⚙️ 配置示例
### 积分公式配置
```yaml
scoring:
base-score: 10
formula: "base + (killstreak * 2) + (victim_score / 100)"
# 初始积分设置
initial-score:
enabled: false
score: 100
# 零积分保护
zero-score-protection:
enabled: true
```
### 聊天段位前缀配置
```yaml
chat-title-prefix:
enabled: false
format: "&7[{title}&7] "
no-title: "&7无段位"
```
### 称号配置示例
```yaml
titles:
bronze:
display-name: "&6青铜"
required-score: 0
prefix: "&6[青铜]"
rewards:
- "give {player} diamond 1"
```
---
[/MD]
Q群361919269 禁广 有报错或者想添加的可以跟我说
Q群361919269 禁广 有报错或者想添加的可以跟我说