PlayerRewards 玩家奖励插件

PlayerRewards 玩家奖励

> 一款有点好用的玩家奖励插件。腐竹通过简单指令创建激活码和礼物，玩家使用激活码即可领取奖励。支持发卡平台对接、活动节日礼品发放、日常奖励等多种场景，兼容 1.7.x – 26.2，无前置依赖。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | PlayerRewards（玩家奖励） |
| 开发者 | 丶米饭（handy / handyplus） |
| 最新版本 | 1.2.0（2026-06-20） |
| 许可协议 | 保留所有权利（ARR，未经许可不得商用或再分发） |
| 兼容版本 | 1.7.x – 26.2（Java Edition） |
| 运行平台 | Bukkit / Spigot / Paper / Folia / Purpur |
| 项目地址 | https://ricedoc.handyplus.cn/wiki/PlayerRewards/ |
| 官方文档 | https://ricedoc.handyplus.cn/wiki/PlayerRewards/README/ |
简介

PlayerRewards 是一款专注于「激活码 → 奖励」流程的轻量插件。腐竹通过指令创建激活码（CDK）或直接创建礼物，玩家在游戏内输入激活码即可领取对应的物品、命令奖励等内容。

插件支持 MySQL 与本地 SQLite 双存储后端，可根据服务器规模灵活选择；提供 GUI 图形界面操作，降低管理成本；支持离线玩家奖励队列，玩家上线后自动补发。无需任何前置插件，开箱即用。
核心特性
激活码系统
支持创建指定内容的激活码，玩家在游戏内输入即可领取奖励。可用于发卡平台对接、活动礼品发放、日常福利等场景。
批量一次性激活码
可批量生成一次性使用的 CDK，每个码仅可被兑换一次，适合大规模分发场景（如节日活动、充值返利）。
直接创建奖励物品
除了激活码，也可直接向在线或离线玩家发放奖励物品，无需等待玩家主动兑换。
双存储后端
支持 MySQL 与本地 SQLite 存储，小型服务器使用默认 SQLite 零配置即可运行，大型网络服可切换 MySQL 实现数据集中管理。
GUI 图形管理
提供图形化管理界面，支持 GUI 点击音效，操作直观便捷。
离线玩家奖励队列
向离线玩家发放奖励时，奖励会进入队列，玩家下次上线后自动补发，不丢失任何奖励。
Folia 兼容
从 1.0.6 起适配 Folia 核心，支持现代多线程服务端架构。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Spigot / Paper / Folia / Purpur（Bukkit API 兼容） |
| Java | 8 及以上（1.7.x – 1.21.x 兼容） |
| 前置插件 | 无 |
| 数据库 | 默认 SQLite（内置），可选 MySQL |
安装方法
下载 PlayerRewards-1.2.0.jar
放入服务器的 plugins 文件夹
重启服务器（或使用 PlugMan 等热加载）
生成默认配置后，编辑 plugins/PlayerRewards/config.yml
使用 /pr reload 重载配置使修改生效

> 升级提醒：建议在升级前备份 plugins/PlayerRewards/ 目录（含数据库文件）。1.1.x 至 1.2.0 为平滑升级，无需手动迁移数据。
命令与权限

| 命令 | 说明 | 权限 | 默认 |
| --- | --- | --- | --- |
| /pr | 打开插件主界面 / 帮助 | playerrewards.use | 所有玩家 |
| /pr use <激活码> | 使用激活码领取奖励 | playerrewards.use | 所有玩家 |
| /pr create <名称> <数量> | 创建指定激活码 | playerrewards.admin | OP |
| /pr batch <前缀> <数量> <次数> | 批量生成一次性激活码 | playerrewards.admin | OP |
| /pr createGift <玩家> <奖励> | 直接向玩家创建礼物 | playerrewards.admin | OP |
| /pr addReward <名称> <指令> | 添加奖励命令 | playerrewards.admin | OP |
| /pr editReward <名称> | 编辑已有奖励 | playerrewards.admin | OP |
| /pr reload | 重载配置文件 | playerrewards.admin | OP |

> 命令前缀 /pr 可在配置文件中自定义。权限节点为示意结构，实际以所装版本的 plugin.yml 为准。
相关链接
米饭插件文档（官方 Wiki）：https://ricedoc.handyplus.cn/wiki/PlayerRewards/
Modrinth：https://modrinth.com/plugin/playerrewards
SpigotMC：https://www.spigotmc.org/resources/playerrewards.129442
MineBBS：https://www.minebbs.com/resources/playerrewards.7364/