- ◆ 游戏版本
- 1.12.x-1.12.2 其他版本无测试
- ◆ 服务端核心
- Spigot--CatServer-Magma
- ◆ 前置/依赖
- 硬依赖： PlayerPoints 软依赖：PlaceholderAPI
核心功能
- 点卷充值自动返利
- 多档阶梯返利比例配置
- 返利存储至待领取池，玩家手动领取
- GUI 界面可视化操作
- 命令行快速操作
每日首充奖励
- 自定义每日前 N 名充值玩家触发奖励
- 奖励比例独立配置（完全替代阶梯返利）
- 支持百分比返利（如 100%、200%）
- 支持固定数量额外奖励
- 每日自动重置计数器
返利限额
- 单笔最低返利金额限制
- 单笔最高返利金额限制
- 每日返利上限限制
数据存储
- YAML 文件夹存储（每个玩家独立文件）
- MySQL 数据库存储（支持运行时切换）
- 自动定时保存（可配置间隔）
- 历史返利记录保留（可查看最近 50 条）
全局统计
- 玩家总数统计
- 累计返利总额统计
- 待领取总额统计
- 今日返利统计
- 返利排行榜（前 N 名玩家）
玩家命令
- /xhn gui - 打开 GUI 界面
- /xhn info - 查看个人返利信息
- /xhn claim - 一键领取返利
- /xhn history - 查看返利历史记录
管理员命令
- /xhna reload - 重载配置
- /xhna set - 设置玩家返利
- /xhna add - 添加玩家返利
- /xhna take - 扣除玩家返利
- /xhna reset - 重置玩家数据
- /xhna storage - 切换存储模式
- /xhna stats - 查看全局统计
- /xhna top - 返利排行榜
- /xhna toggle - 一键开关返利功能
PlaceholderAPI 变量
- %xhcashback_pending% - 待领取返利
- %xhcashback_total% - 累计返利
- %xhcashback_daily% - 今日返利
- %xhcashback_status% - 返利状态
- %xhcashback_first_bonus_remaining% - 首充奖励剩余次数
- %xhcashback_daily_cap_remaining% - 每日上限剩余
通知系统
- 充值返利自动提示
- 每日首充奖励特殊提示
- 登录时提示未领取返利
- 领取成功提示
