- 版权类型
- 转载
- 插件中文名
- 每日奖励 | 连续签到、额外领取、倍率与奖励池
- 插件英文名
- daily rewards streaks bonus claims multipliers reward pools
- 支持的核心 [服务端]
- Spigot
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# 每日奖励（DailyRewards）
可配置奖励周期、连续签到、额外领取、倍率与奖励池
**Minecraft：** 1.19.4 – 26.2
**Java：** 17+
**可选依赖：** PlaceholderAPI
---
DailyRewards 是一款面向服务器管理员的现代每日奖励插件，设计目标是提供一套可靠、高度可配置且上手简单的奖励系统，不附带多余功能。
插件不追求堆砌无关特性，而是专注于核心价值：通过精致、轻量且灵活的体验奖励玩家的持续登录。
---
## 核心功能
### 可配置奖励周期（7 天或 14 天）
支持经典的 **7 天**周期或扩展的 **14 天**进阶周期。GUI、占位符和奖励系统均会自动适配所选周期。
### 每日连续签到系统
通过清晰、可预期的奖励进阶路径，激励玩家每天回归。
### 里程碑连签奖励
在玩家达到重要连签节点时，给予可配置的额外奖励，回馈忠实玩家。
### 自适应奖励 GUI
基于箱子界面，自动根据配置的奖励周期调整布局，安装后无需任何配置即可直接使用。
### 直接领取命令
玩家可通过以下命令即时领取可用奖励：
```text
/rewards claim
```
### 强大的管理工具
管理员可执行以下操作：
- 查看任意玩家的奖励进度
- 修改连签天数
- 重置玩家数据
- 重载配置
- 验证配置完整性
### 完全自定义的奖励内容
每个奖励日均可独立配置：
- GUI 物品
- 显示名称
- Lore（物品描述）
- 控制台命令
- 音效
- 粒子效果
- 额外奖励
### 加权奖励池
可将任意奖励日或连签里程碑奖励转换为神秘奖品。只需引用一个命名奖励池，DailyRewards 会按权重随机抽取其中一项，权重配置让稀有奖励保持应有的稀有度。
```yaml
days:
1:
commands:
- "pool:daily-mystery"
```
支持将多条命令打包进单个奖品、对同一奖励池多次抽取以获得多次独立机会。整个流程走正常奖励管线——权限倍率和 PlaceholderAPI 占位符均自动生效，无需额外配置。
### 基于权限的奖励倍率
为 VIP、赞助者或管理员配置专属奖励倍率。
### 多语言支持
内置以下语言的完整翻译：
- 英语
- 西班牙语
- 法语
- 德语
- 意大利语
- 葡萄牙语（巴西）
所有面向玩家的消息均可自定义。
### 现代反馈体验
领取奖励时可选音效、粒子效果和视觉反馈。
### PlaceholderAPI 集成
可在服务器任意位置显示奖励信息。
### 自动配置迁移
新版本引入额外设置或新奖励日时，DailyRewards 会自动更新现有配置，并尽可能保留原有自定义内容。
### 轻量且稳定
无需数据库，玩家数据通过本地 YAML 文件安全存储，设计上注重长期稳定性与兼容性。
---
## PlaceholderAPI 支持
安装 PlaceholderAPI 后，DailyRewards 会自动注册以下占位符，无需额外配置。
**主要占位符：**
```text
%dailyrewards_streak%
%dailyrewards_current_streak%
%dailyrewards_best_streak%
%dailyrewards_time_left%
%dailyrewards_next_day%
%dailyrewards_next_reward%
%dailyrewards_cycle_length%
%dailyrewards_cycle_progress%
%dailyrewards_week%
%dailyrewards_week_day%
%dailyrewards_can_claim%
%dailyrewards_can_claim_raw%
%dailyrewards_claimed_today%
%dailyrewards_claimed_today_raw%
%dailyrewards_multiplier%
%dailyrewards_total_claims%
%dailyrewards_prefix%
```
**旧版占位符（向下兼容）：**
```text
%rewardslite_*%
```
---
## 命令与权限
```
命令 说明 权限节点
/rewards 打开奖励菜单 dailyrewards.use
/rewards claim 领取当日奖励 dailyrewards.claim
/rewards help 显示命令帮助 dailyrewards.use
/rewards info 查看个人奖励进度 dailyrewards.use
/rewards check 查看指定玩家状态 dailyrewards.admin
/rewards setstreak 设置玩家连签天数 dailyrewards.admin
/rewards reload 重载配置与消息文件 dailyrewards.admin
/rewards reset 重置玩家奖励数据 dailyrewards.admin
/rewards verify 验证配置有效性 dailyrewards.admin
```
旧版权限节点 `rewardslite.*` 向下兼容，继续有效。
**默认权限：** `dailyrewards.use` 和 `dailyrewards.claim` 对所有玩家默认开放。
---
## 配置文件
DailyRewards 自动生成以下配置文件：
**config.yml**
主配置文件，可设置：
- 奖励周期（7 天或 14 天）
- 奖励命令
- GUI 外观
- 倍率规则
- 连签里程碑奖励
- 音效与粒子效果
- 冷却时间
- 通用行为参数
**messages.yml**
完全可自定义的多语言消息文件，支持 MiniMessage 格式及 HEX 颜色代码。
**data.yml**
本地玩家进度存储文件，安全可靠。
---
## 快速开始
1. 下载 **DailyRewards.jar**
2. 将文件放入服务器的 **/plugins/**folder** 目录
3. 重启服务器
4. 配置你的奖励内容
5. 执行 **/rewards reload** 重载配置
6. 完成，开始使用！
> 本插件需要 **Java 17 或更高版本**。
---
## 许可证
免费使用，禁止二次分发。未经授权，不得转载、转售、重新上传、重新打包或发布修改版本。
---
## 获取帮助
如需查阅完整文档，请访问**文档（Documentation）**标签页，内含安装说明、配置示例、命令与权限、占位符及排错指南。
如遇问题，请通过以下渠道寻求支持，**请勿在评价区反馈 Bug**：
- 讨论（Discussion）标签页
- 私信（Private Messages）
[/MD]
# 每日奖励（DailyRewards）
可配置奖励周期、连续签到、额外领取、倍率与奖励池
**Minecraft：** 1.19.4 – 26.2
**Java：** 17+
**可选依赖：** PlaceholderAPI
---
DailyRewards 是一款面向服务器管理员的现代每日奖励插件，设计目标是提供一套可靠、高度可配置且上手简单的奖励系统，不附带多余功能。
插件不追求堆砌无关特性，而是专注于核心价值：通过精致、轻量且灵活的体验奖励玩家的持续登录。
---
## 核心功能
### 可配置奖励周期（7 天或 14 天）
支持经典的 **7 天**周期或扩展的 **14 天**进阶周期。GUI、占位符和奖励系统均会自动适配所选周期。
### 每日连续签到系统
通过清晰、可预期的奖励进阶路径，激励玩家每天回归。
### 里程碑连签奖励
在玩家达到重要连签节点时，给予可配置的额外奖励，回馈忠实玩家。
### 自适应奖励 GUI
基于箱子界面，自动根据配置的奖励周期调整布局，安装后无需任何配置即可直接使用。
### 直接领取命令
玩家可通过以下命令即时领取可用奖励：
```text
/rewards claim
```
### 强大的管理工具
管理员可执行以下操作：
- 查看任意玩家的奖励进度
- 修改连签天数
- 重置玩家数据
- 重载配置
- 验证配置完整性
### 完全自定义的奖励内容
每个奖励日均可独立配置：
- GUI 物品
- 显示名称
- Lore（物品描述）
- 控制台命令
- 音效
- 粒子效果
- 额外奖励
### 加权奖励池
可将任意奖励日或连签里程碑奖励转换为神秘奖品。只需引用一个命名奖励池，DailyRewards 会按权重随机抽取其中一项，权重配置让稀有奖励保持应有的稀有度。
```yaml
days:
1:
commands:
- "pool:daily-mystery"
```
支持将多条命令打包进单个奖品、对同一奖励池多次抽取以获得多次独立机会。整个流程走正常奖励管线——权限倍率和 PlaceholderAPI 占位符均自动生效，无需额外配置。
### 基于权限的奖励倍率
为 VIP、赞助者或管理员配置专属奖励倍率。
### 多语言支持
内置以下语言的完整翻译：
- 英语
- 西班牙语
- 法语
- 德语
- 意大利语
- 葡萄牙语（巴西）
所有面向玩家的消息均可自定义。
### 现代反馈体验
领取奖励时可选音效、粒子效果和视觉反馈。
### PlaceholderAPI 集成
可在服务器任意位置显示奖励信息。
### 自动配置迁移
新版本引入额外设置或新奖励日时，DailyRewards 会自动更新现有配置，并尽可能保留原有自定义内容。
### 轻量且稳定
无需数据库，玩家数据通过本地 YAML 文件安全存储，设计上注重长期稳定性与兼容性。
---
## PlaceholderAPI 支持
安装 PlaceholderAPI 后，DailyRewards 会自动注册以下占位符，无需额外配置。
**主要占位符：**
```text
%dailyrewards_streak%
%dailyrewards_current_streak%
%dailyrewards_best_streak%
%dailyrewards_time_left%
%dailyrewards_next_day%
%dailyrewards_next_reward%
%dailyrewards_cycle_length%
%dailyrewards_cycle_progress%
%dailyrewards_week%
%dailyrewards_week_day%
%dailyrewards_can_claim%
%dailyrewards_can_claim_raw%
%dailyrewards_claimed_today%
%dailyrewards_claimed_today_raw%
%dailyrewards_multiplier%
%dailyrewards_total_claims%
%dailyrewards_prefix%
```
**旧版占位符（向下兼容）：**
```text
%rewardslite_*%
```
---
## 命令与权限
```
命令 说明 权限节点
/rewards 打开奖励菜单 dailyrewards.use
/rewards claim 领取当日奖励 dailyrewards.claim
/rewards help 显示命令帮助 dailyrewards.use
/rewards info 查看个人奖励进度 dailyrewards.use
/rewards check 查看指定玩家状态 dailyrewards.admin
/rewards setstreak 设置玩家连签天数 dailyrewards.admin
/rewards reload 重载配置与消息文件 dailyrewards.admin
/rewards reset 重置玩家奖励数据 dailyrewards.admin
/rewards verify 验证配置有效性 dailyrewards.admin
```
旧版权限节点 `rewardslite.*` 向下兼容，继续有效。
**默认权限：** `dailyrewards.use` 和 `dailyrewards.claim` 对所有玩家默认开放。
---
## 配置文件
DailyRewards 自动生成以下配置文件：
**config.yml**
主配置文件，可设置：
- 奖励周期（7 天或 14 天）
- 奖励命令
- GUI 外观
- 倍率规则
- 连签里程碑奖励
- 音效与粒子效果
- 冷却时间
- 通用行为参数
**messages.yml**
完全可自定义的多语言消息文件，支持 MiniMessage 格式及 HEX 颜色代码。
**data.yml**
本地玩家进度存储文件，安全可靠。
---
## 快速开始
1. 下载 **DailyRewards.jar**
2. 将文件放入服务器的 **/plugins/**folder** 目录
3. 重启服务器
4. 配置你的奖励内容
5. 执行 **/rewards reload** 重载配置
6. 完成，开始使用！
> 本插件需要 **Java 17 或更高版本**。
---
## 许可证
免费使用，禁止二次分发。未经授权，不得转载、转售、重新上传、重新打包或发布修改版本。
---
## 获取帮助
如需查阅完整文档，请访问**文档（Documentation）**标签页，内含安装说明、配置示例、命令与权限、占位符及排错指南。
如遇问题，请通过以下渠道寻求支持，**请勿在评价区反馈 Bug**：
- 讨论（Discussion）标签页
- 私信（Private Messages）
[/MD]