AxRewards - 轻量级奖励插件

AxRewards 是一款轻量级的每日/每周奖励插件，允许你自定义任意冷却时长的奖励。它配置简单，支持多服务器同步与多种数据库，并提供了高度可自定义的 GUI 界面。

💡核心特性

• 简单配置：只需几分钟即可完成设置。
• 多服务器支持：无需 Redis 即可实现跨服同步。
• 数据库支持：兼容 H2、SQLite、MySQL 和 PostgreSQL。
• 自动更新 GUI：界面每秒自动刷新，无需玩家重新打开。
• 权限锁定奖励：可创建仅限特定等级或权限玩家领取的奖励。
• 冷却系统：领取冷却时间可按秒自定义。
• 可自定义 GUI：可修改所有物品，并能为 GUI 添加装饰元素。
• 占位符支持：支持 PlaceholderAPI。
• 颜色格式：支持所有主流颜色格式（如 MiniMessage、Legacy 等）。

🎮技术信息

• 支持的 Minecraft 版本：1.20.2 - 1.21.11
• 必需的 Java 版本：21 或更高
• 源代码：https://github.com/Artillex-Studios/AxRewards

🔧获取支持

如需委托定制、技术支持或其他任何帮助，请联系开发者。

💡简介

AXRewards 是一款功能强大的奖励插件，允许服务器管理员为玩家设置多种类型的奖励，例如每日登录奖励、在线时长奖励、投票奖励等。它提供了高度可定制的界面和灵活的配置选项，帮助您轻松创建和管理各种激励系统，以提升玩家的活跃度和参与感。

🎮主要功能

• 多种奖励类型：支持每日登录奖励、在线时长奖励、投票奖励、首次加入奖励等多种类型。
• 高度可定制：完全可配置的 GUI 界面、音效、消息和奖励内容。
• 进度保存：玩家数据自动保存，即使服务器重启也不会丢失进度。
• PlaceholderAPI 支持：兼容 PlaceholderAPI，可在消息和 GUI 中使用各种变量。
• 多语言支持：内置多语言系统，方便国际化。
• Vault 集成：支持经济奖励（需要 Vault 和经济插件）。
• 可扩展的奖励：除了物品，还可以给予经验、金钱、命令执行等。

🔧命令与权限

玩家命令

• /rewards - 打开主奖励菜单。
• /daily - 打开每日奖励菜单。
• /vote - 打开投票奖励菜单。
• /playtime - 打开在线时长奖励菜单。

管理员命令

• /axrewards - 主管理命令。

- `/axrewards help` - 显示帮助信息。

- `/axrewards reload` - 重载插件配置。

- `/axrewards version` - 查看插件版本。

- `/axrewards reset <玩家> <奖励类型>` - 重置指定玩家的奖励进度。

- `/axrewards give <玩家> <奖励类型>` - 手动给予玩家指定奖励。

主要权限

• axrewards.command.rewards - 使用 /rewards 命令的权限。
• axrewards.command.daily - 使用 /daily 命令的权限。
• axrewards.command.vote - 使用 /vote 命令的权限。
• axrewards.command.playtime - 使用 /playtime 命令的权限。
• axrewards.admin - 使用所有管理员命令的权限。

✨安装与设置

要求

• Spigot、Paper 或兼容的 Minecraft 服务端（1.13+）。
• Java 17 或更高版本。

依赖项（可选但推荐）

• Vault - 用于经济奖励功能。
• PlaceholderAPI - 用于在消息和 GUI 中使用变量。

安装步骤

• 将 AXRewards 的 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件将自动生成配置文件和文件夹。
• 根据您的需求编辑 config.yml 和位于 plugins/AXRewards/ 目录下的其他配置文件。
• 使用 /axrewards reload 重载配置或重启服务器使更改生效。

⭐配置奖励

奖励配置位于 plugins/AXRewards/rewards/ 目录下，每种奖励类型都有独立的 YAML 文件。

配置示例（每日奖励）

以下是一个简单的每日奖励配置示例

# 奖励名称（用于内部识别）
daily-reward:
  # 显示名称（支持颜色代码）
  display-name: "&a每日登录奖励"
  # 奖励类型：DAILY, VOTE, PLAYTIME, FIRST_JOIN
  type: DAILY
  # 重置时间（每日奖励在何时重置）
  reset-time: "00:00"
  # 奖励GUI的标题
  gui-title: "&8每日奖励"
  # 奖励物品列表
  rewards:
    day1:
      # 第几天
      day: 1
      # 显示的物品
      display-item:
        material: STONE
        name: "&7第一天奖励"
        lore:
          - "&7登录第一天即可领取！"
      # 实际给予玩家的奖励
      rewards:
        - "give %player% stone 10"
        - "eco give %player% 100"

奖励类型说明

• DAILY：每日登录奖励，可设置连续登录周期。
• VOTE：投票奖励，通常与投票插件联动。
• PLAYTIME：在线时长奖励，根据累计在线时间发放。
• FIRST_JOIN：首次加入服务器奖励。

❓常见问题

• 如何添加新的奖励类型？

在 plugins/AXRewards/rewards/ 目录下创建一个新的 YAML 配置文件，并按照示例格式编写。

• 如何修改 GUI 界面？

编辑对应奖励配置文件中的 gui-title、display-item 等部分，支持颜色代码和物品材质。

• 奖励没有正常发放？
• 检查控制台是否有错误信息。
• 确认玩家是否有领取权限。
• 检查奖励配置中的命令格式是否正确。
• 确认经济或物品奖励所需的依赖插件（如 Vault）是否正常安装。

• 如何重置所有玩家的奖励进度？

目前没有单一命令。您可以手动删除 plugins/AXRewards/data/ 目录下的玩家数据文件，或者使用 /axrewards reset <玩家> <奖励类型> 逐个重置。

• 支持哪些占位符？

插件内置了一些占位符（如 %player%），并支持 PlaceholderAPI 的所有变量。您可以在配置文件的文本部分使用它们。

🔧获取帮助与支持

• 官方文档：访问 https://docs.artillex-studios.com/axrewards.html 获取最新信息。
• Discord 支持：加入 Artillex Studios 的 Discord 服务器获取社区帮助。
• 问题报告：如果您发现漏洞或有功能建议，请在官方 GitHub 仓库或支持渠道提交。