- 版权类型
- 原创
- 插件中文名称
- 航式排名奖励
- 插件英文名称
- HangRankReward
- 原帖地址
- #
- 支持的核心(服务端)
- 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]
## 📖 插件介绍
**HangRankReward** 是一款基于 **PlaceholderAPI** 的排行榜自动奖励插件,属于 **Hang系列插件**。
### 💡 为什么选择 HangRankReward?
传统的排行榜奖励需要管理员手动发放,费时费力。**HangRankReward** 支持**每日/每周/每月**定时自动发放奖励,完全自动化!通过 PAPI 变量获取任意排行榜数据,兼容所有主流排行榜插件。
> 🎯 **核心特色**:只要排行榜插件提供 PAPI 变量,就能实现自动奖励发放!支持离线奖励存储,玩家上线自动领取!
---
## ✨ 插件特性
- 🎯 **多周期定时奖励** - 支持每日/每周/每月自动发放(核心功能)
- 📊 **PAPI 变量支持** - 兼容任意提供 PAPI 变量的排行榜插件
- 🏆 **灵活排名配置** - 支持单独排名(1,2,3)和范围排名(4-10)
- 📦 **离线奖励存储** - 玩家离线时自动存储,上线后自动发放
- ⚡ **在线即时奖励** - 支持仅在线才能领取的特殊奖励
- 📢 **全服广播** - 可配置获奖玩家的全服公告
- 🎮 **多种命令类型** - 支持控制台/玩家/消息三种执行方式
- 🌐 **全版本支持** - 支持 1.8.x - 1.21.x 全版本
---
## 📋 命令列表
| 命令 | 说明 | 权限 |
|------|------|------|
| `/rankreward` | 插件主命令/帮助 | 无 |
| `/rankreward reload` | 重载配置文件 | `rankreward.admin` |
| `/rankreward list` | 查看所有奖励任务 | `rankreward.admin` |
| `/rankreward give <奖励ID>` | 手动发放指定奖励 | `rankreward.admin` |
| `/rankreward info <奖励ID>` | 查看奖励详细信息 | `rankreward.admin` |
**命令别名**: `/rr` 或 `/reward`
---
## 🔑 权限节点
| 权限 | 说明 | 默认 |
|------|------|------|
| `rankreward.admin` | 管理员权限(所有命令) | OP |
---
## 📝 功能说明
### 🎯 定时奖励类型
- **daily** - 每天指定时间发放(如每晚23:59)
- **weekly** - 每周指定星期几发放(如每周一12:00)
- **monthly** - 每月指定日期发放(如每月1号00:00)
### 📦 奖励命令分组
- **offline-commands** - 离线可存储奖励,玩家不在线时保存,上线自动发放
- **online-commands** - 仅在线奖励,玩家必须在线才能领取,离线则跳过
### 🎮 命令执行方式
- `[console]` - 以控制台身份执行命令
- `[player]` - 以玩家身份执行命令
- `[message]` - 发送消息给玩家
---
## ⚙️ 配置文件
```yaml
rewards:
# 每日击杀排行奖励
daily_kills:
type: daily
time: "23:59"
# PAPI变量,%rank% 会被替换为排名数字
placeholder: "%ajleaderboards_name_daily_kills_%rank%"
rank-rewards:
1: # 第1名
offline-commands:
- "[console]give %player% diamond 64"
- "[console]eco give %player% 10000"
online-commands:
- "[message]&a恭喜你获得每日击杀榜第1名奖励!"
broadcast: "&6[公告] &e恭喜 &f%player% &e获得击杀榜冠军!"
2: # 第2名
offline-commands:
- "[console]give %player% diamond 32"
broadcast: "&6[公告] &e恭喜 &f%player% &e获得击杀榜第2名!"
4-10: # 第4-10名范围奖励
offline-commands:
- "[console]give %player% diamond 8"
# 每周在线时长奖励
weekly_playtime:
type: weekly
day: 2 # 周一发放 (1=周日, 2=周一, ..., 7=周六)
time: "12:00"
placeholder: "%ajleaderboards_name_weekly_playtime_%rank%"
rank-rewards:
1:
offline-commands:
- "[console]give %player% diamond_block 32"
broadcast: "&6[公告] &e恭喜 &f%player% &e获得每周在线榜冠军!"
# 每月充值排行奖励
monthly_donate:
type: monthly
day: 1 # 每月1号发放
time: "00:00"
placeholder: "%ajleaderboards_name_monthly_donate_%rank%"
rank-rewards:
1:
offline-commands:
- "[console]lp user %player% permission set vip.monthly true"
broadcast: "&6[公告] &e恭喜 &f%player% &e成为本月充值冠军!"
```
---
## 📥 安装方法
1. 确保服务器已安装 **PlaceholderAPI** 插件
2. 下载 `HangRankReward-Universal-1.0.0.jar`
3. 将jar文件放入服务器 `plugins` 文件夹
4. 重启服务器或使用插件管理器加载
5. 根据需要修改 `plugins/HangRankReward/config.yml`
6. 使用 `/rr reload` 重载配置
---
[/MD]
Q群361919269 禁广 有报错或者想添加的可以跟我说
Q群361919269 禁广 有报错或者想添加的可以跟我说