- 版权类型
- 原创
- 插件中文名称
- 航式排行
- 插件英文名称
- HangVarRank-
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- SpongeVanilla
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI
- 适配版本(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]
## ✨ 插件简介
**HangVarRank** 可以将服务器中任意 PlaceholderAPI 变量在玩家离线后依然保留,同时自动生成排行榜。无论是金币、等级、击杀数还是任何 PAPI 变量,都可以轻松追踪并排名。
## 🎯 核心功能
- **离线变量保存** - 玩家下线后变量数据不丢失,随时可查
- **万能变量追踪** - 支持追踪任意 PlaceholderAPI 变量
- **自动排行榜** - 自动根据数值生成排行榜,定时刷新
- **自定义排行榜格式** - 标题、条目、前三名样式、底部全部可自定义
- **显示个人排名** - 查看排行榜时自动显示自己的排名
- **异步处理** - 数据保存、排行榜更新均为异步,不卡服
## 📥 安装方法
1. 确保服务器已安装 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
2. 将 `HangVarRank-Universal-1.0.0.jar` 放入 `plugins` 文件夹
3. 重启服务器
4. 编辑 `plugins/HangVarRank/config.yml` 配置你要追踪的变量
5. 执行 `/vr reload` 重载配置
## 📋 指令列表
| 指令 | 说明 | 权限 |
|------|------|------|
| `/vr reload` | 重载配置文件 | `varrank.admin` |
| `/vr save` | 手动保存所有数据 | `varrank.admin` |
| `/vr set <玩家> <变量> <值>` | 设置玩家变量 | `varrank.admin` |
| `/vr get <玩家> <变量>` | 获取玩家变量 | `varrank.admin` |
| `/vr top <变量> [数量]` | 查看排行榜 | 无 |
> 指令别名:`/varrank`、`/vr`、`/hvr`
## 🔤 变量(PlaceholderAPI)
| 变量 | 说明 |
|------|------|
| `%varrank_<变量名>%` | 获取自己的变量值 |
| `%varrank_<变量名>_<玩家名>%` | 获取指定玩家的变量值 |
| `%varrank_top_<变量>_<排名>_name%` | 排行榜第N名的玩家名 |
| `%varrank_top_<变量>_<排名>_value%` | 排行榜第N名的数值 |
| `%varrank_rank_<变量>%` | 获取自己的排名 |
| `%varrank_rank_<变量>_<玩家名>%` | 获取指定玩家的排名 |
### 变量使用示例
假设你追踪了 `vault_eco_balance`(金币):
```
%varrank_vault_eco_balance% → 自己的金币数
%varrank_top_vault_eco_balance_1_name% → 金币排行榜第1名玩家名
%varrank_top_vault_eco_balance_1_value% → 金币排行榜第1名的金币数
%varrank_rank_vault_eco_balance% → 自己的金币排名
```
## ⚙️ 配置文件
```yaml
# 自动保存间隔 (分钟)
auto-save-interval: 5
# 排行榜设置
leaderboard:
default-size: 10 # 默认显示数量
max-size: 100 # 最大排行榜数量
update-interval: 60 # 更新间隔 (秒)
format:
header: "&8&m---------&r &6&l%variable_display% &e排行榜 &8&m---------"
footer: "&8&m---------------------------------------------"
entry: "&e#%rank% &f%player% &7- &a%value%"
entry-top1: "&6&l① &e&l%player% &7- &a&l%value%"
entry-top2: "&7&l② &f%player% &7- &a%value%"
entry-top3: "&c&l③ &f%player% &7- &a%value%"
empty: "&7暂无数据"
self-rank: "&7你的排名: &e#%rank% &7- &a%value%"
self-not-ranked: "&7你的排名: &c未上榜"
# 追踪的变量 (格式: PAPI变量名: 显示名称)
variables:
tracked:
player_level: "等级"
vault_eco_balance: "金币"
statistic_player_kills: "击杀数"
```
## 🎨 排行榜效果预览
```
----------------- 金币 排行榜 -----------------
① hangzong - 100000
② Steve - 50000
③ Alex - 25000
#4 Player1 - 10000
#5 Player2 - 5000
你的排名: #3 - 25000
---------------------------------------------
[/MD]
Q群361919269 禁广 有报错或者想添加的功能可以跟我说
Q群361919269 禁广 有报错或者想添加的功能可以跟我说