DailyRewardsGUI - Increase player retention - 每日奖励GUI - 提升玩家留存

DailyRewards 是一款为玩家提供每日登录奖励的插件。玩家连续登录的天数越多，获得的奖励就越好。它支持高度自定义的奖励、GUI界面，并能与Citizens NPC集成，为服务器增添活跃度和玩家粘性。

💡重要须知

不支持 1.8.* 版本。

• 运行环境要求：需要 Java 8+ 和 Spigot 1.9+ 或更高版本。
• 数据库支持：支持 MySQL 和 SQLite。
• 依赖插件：如需绑定NPC打开GUI，需要安装 Citizens 插件，并对NPC使用 /trait dailyrewards 指令。

🎮核心功能

• 连续登录奖励：奖励与连续登录天数挂钩，天数越多奖励越丰厚。
• 高度可定制：可设置从1到54天不等的连续奖励周期。
• 自动化与高性能：完全自动化运行，数据自动保存，性能高效。
• 灵活的奖励系统：

- 奖励数量无限制。

- 可执行控制台命令、OP命令或玩家命令。

- 可发送自定义消息。

• GUI界面：提供完全可自定义的GUI界面，可动态显示奖励状态。
• 领取时机控制：

- 可设置奖励在午夜后刷新（可选）。

- 可自定义奖励领取的时间间隔。

• 便捷功能：

- 支持玩家加入时自动打开GUI（可关闭）。

- 可绑定Citizens NPC来打开奖励GUI。

- 玩家数据定期自动保存。

🔧指令与权限

指令列表

• /dailyreward

- **功能**：打开每日奖励GUI。

- **所需权限**：`dailyrewards.user`

• /dailyreward help

- **功能**：显示指令列表。

- **所需权限**：`dailyrewards.user`

• /dailyreward reload

- **功能**：重载插件配置文件。

- **所需权限**：`dailyrewards.admin`

权限列表

• dailyrewards.user：允许玩家使用基础指令并领取奖励。
• dailyrewards.admin：允许管理员重载插件配置。

✨配置详解

以下为 config.yml 的核心配置项说明。

数据与存储

data:
  auto-save: 15 # 自动保存玩家数据的间隔时间（分钟）
storage:
  type: sqlite # 数据库类型，可选 sqlite 或 mysql
  # 若使用mysql，需填写以下信息
  username: none
  password: none
  host: none
  database: none
purge:
  enabled: false # 是否启用数据清理
  days: 60 # 清理多少天前的数据

选项设置

options:
  auto-open:
    enabled: true # 玩家加入时自动打开GUI
    only-when-have: true # 仅在玩家有可领取奖励时自动打开
  days-row: 7 # 连续奖励的总天数周期

奖励配置

奖励按天数（如 '1', '2'）进行配置，每个奖励可设置：

• lore: 在GUI中显示的描述文本。
• commands: 领取时执行的命令列表。
• messages: 领取后发送给玩家的消息。

**命令格式说明**

• 'console: <cmd>'：以控制台身份执行命令。
• 'op: <cmd>'：以OP身份执行命令。
• '<cmd>'：以玩家身份执行命令。
• 可使用变量 %player% 代表玩家名。

**配置示例（第1天奖励）**

'1':
  lore:
    - '&7Come back every day to'
    - '&7receive even better rewards!'
    - ''
    - '&e&lRewards:'
    - '&6- $500'
    - '&6- x2 Diamonds'
  commands:
    - 'console: eco give %player% 500'
    - 'console: give %player% diamond 2'
  messages:
    - '&aCongratulations! You got reward for join %day%st day in a row!'

GUI界面配置

可自定义GUI标题、大小、物品材质、名称和描述。

• days-positions: 指定奖励物品栏的槽位。
• days-display: 根据奖励状态（可领取available、已领取taken、未解锁locked、等待中next）配置不同的显示物品。
• items: 配置GUI背景装饰物品。

❓使用提示

• 在奖励命令中，使用 %player% 变量来指代领取奖励的玩家。
• 在 lore 和 messages 中，可以使用 %day% 变量来显示当前天数，插件会自动处理序数后缀（如st, nd, rd, th）。
• 确保为奖励命令中涉及的其他插件（如经济插件）安装了正确的依赖。
• 修改配置文件后，可使用 /dailyreward reload 重载使更改生效。