原创 工具 DailyRankCommands | LuckPerms 定时权限奖励 | Cron任务 | 离线补发 1.12.2

## 插件介绍

DailyRankCommands 是一款面向 Minecraft 1.12.2 服务端的定时权限指令插件。

插件可以按照 Cron 表达式定时检查在线玩家的 LuckPerms 权限节点或主权限组，并为符合条件的玩家执行对应指令，适用于每日礼包、VIP福利、月卡奖励、定时体力发放等场景。

## 主要功能

- 支持标准 5 段和带秒的 6 段 Cron 表达式
- 支持 LuckPerms 权限节点判断
- 兼容 LuckPerms 主权限组判断
- 支持多个权限分类叠加
- 同一分类内按照配置顺序只匹配最高优先级
- 支持在线立即发放
- 支持未在线玩家当天上线补发
- 持久化记录玩家领取状态，防止反复上下线重复领取
- 支持多个独立定时任务
- 支持配置热重载
- 支持自定义彩色消息

## 权限匹配示例

玩家同时拥有月卡、vip.1 和 vip.2 时：

- 月卡分类正常执行
- VIP 分类只执行优先级更高的 vip.2
- vip.1 不会重复执行

## 指令执行方式

- 无前缀或 `[console]`：控制台执行
- `[player]`：玩家身份执行
- `[op]`：临时给予玩家 OP 后执行，完成后恢复原状态
- `msg('内容')`：直接向当前玩家发送彩色消息

## 支持的占位符

- `%player_name%`：玩家名称
- `%player_uuid%`：玩家 UUID
- `%primary_group%`：LuckPerms 主组
- `%matched_permission%`：匹配到的权限节点
- `%permission_group%`：匹配到的权限分类
- `{prefix}`：配置文件中的消息前缀

## 管理命令

- `/drc reload`：重载配置
- `/drc list`：查看已加载任务
- `/drc run <任务名>`：立即测试指定任务

管理权限：`dailyrankcommands.admin`

## 运行环境

- Minecraft 1.12.2
- Spigot / Paper
- Java 8
- 必装前置：LuckPerms

## 注意事项

领取记录保存在各子服本地的 `last-runs.yml`。

目前不支持 BungeeCord 或 Velocity 多子服共享领取记录。在 BC 多子服环境中，玩家可能在不同子服重复领取，请仅在单子服环境使用，或等待后续共享数据库版本。

服务器必须在 Cron 触发时间处于运行状态。离线补发只保留最近一次有效奖励批次，不会累计补发多天奖励。