Advancement Rewards

插件

· 作者 Venle

一个插件,当玩家完成进度时,会奖励他们 Vault 经济货币。

0 本站下载 0 关注 更新于 5 个月前

最新 1.1.0 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

AdvancementRewards

为完成进度目标(advancements)的玩家提供奖励——金钱、物品,或两者兼有。

注意:

  • 自定义物品功能正在开发中。

概述:

AdvancementRewards 是一款可定制的 Minecraft 插件,可为玩家完成任何进度目标(包括原版、数据包添加的进度以及模组/插件添加的进度)时提供金钱、物品或两者兼有的奖励。金钱发放通过 Vault(支持 EssentialsX、CMI 及其他提供者)实现;仅发放物品的设置则无需任何依赖项。你可以从 config.yml 进行配置,使用游戏内命令,或通过可视化的拖拽式网页编辑器(/ar config)进行操作——让你对进度系统拥有完全的控制权。


? 功能特性:

  • 金钱与物品奖励:为任意进度目标授予游戏内货币、物品(支持自定义名称和描述文本),或两者兼有。
  • 支持所有进度:原版进度、数据包进度以及模组/插件添加的进度均受支持。
  • 网页编辑器:通过 /ar config 在浏览器中使用拖拽界面编辑奖励——无需编写 YAML 文件。
  • 游戏内命令:添加、删除、列出和浏览进度目标,无需触碰配置文件。
  • Vault 经济系统:兼容任何 Vault 提供者(如 EssentialsX、CMI……);可在配置中选择具体提供者。
  • 仅物品模式:若只发放物品,则无需安装 Vault 即可运行。

? 工作原理:

  1. 玩家完成进度目标。
  2. 如果该进度目标在配置文件中已定义,玩家将收到奖励。
  3. AdvancementRewards 会检查玩家是否已领取该奖励。若未领取,则予以发放。
  4. 若奖励已被领取,则不再发放额外奖励。

⚙️ 配置方法:

插件会生成一个 config.yml 文件,允许你定义哪些进度目标给予奖励以及奖励内容(金钱、物品或两者兼有)。

config.yml 示例:

# 为特定进度目标设置奖励
advancement-rewards:
  minecraft:story/mine_diamond: 500.0
  minecraft:story/enter_the_nether: 300.0
  minecraft:end/kill_dragon: 1000.0
  minecraft:adventure/hero_of_the_village: 700.0
  minecraft:nether/summon_wither: 1000.0
  • advancement-rewards:定义哪些进度目标给予奖励,并为每个进度目标设置游戏内货币的数量。

添加新进度目标:

要添加新的进度目标,只需编辑 config.yml:

minecraft:adventure/adventuring_time: 300.0

物品与组合奖励(丰富格式):

奖励也可以是一个包含可选 money 字段和 items 列表的区块。物品支持设置数量(amount)、名称(name)和描述文本(lore)(均接受 & 颜色代码):

advancement-rewards:
  # 仅金钱(简单格式)
  minecraft:story/mine_diamond: 500.0

# 金钱 + 物品
  minecraft:end/kill_dragon:
    money: 1000.0
    items:
      - material: DRAGON_HEAD
        amount: 1
        name: "&5屠龙者战利品"
        lore:
          - "&7证明你击败了末影龙"
      - material: DIAMOND
        amount: 5

经济提供者和更新通知也是可配置的:

economy:

provider: auto      # 自动 | Essentials | CMI | <自定义 Vault 提供者>
notify-update: true

存储(仅限 config.yml):

认领数据(记录每位玩家已兑换的进度)默认存储在 SQLite 中;如需共享或多服务器环境,请切换至 MariaDB。此配置仅在此处设置——切勿通过 Web 编辑器修改。首次启动时会自动导入旧的 playerdata/*.yml 文件。

storage:
  type: sqlite        # sqlite | mariadb
  mariadb:            # 仅在 type: mariadb 时使用
    host: localhost
    port: 3306
    database: advancementrewards
    username: root
    password: ""

? 安装步骤:

  1. 下载 AdvancementRewards.jar 并将其放入服务器的 plugins 文件夹中。
  2. 重启服务器以生成默认的 config.yml 配置文件。
  3. 修改 config.yml 文件来自定义进度奖励。
  4. 重启服务器或使用 /ar reload 命令重载插件。

? 命令:

所有命令均以 /ar 开头:

  • /ar config:打开拖拽式网页编辑器(会生成一个专属链接)。
  • /ar list [page]:列出已配置的进度奖励。
  • /ar advancements [filter] [page]:浏览服务器上的所有进度(原版/数据包/模组)。
  • /ar add <advancement> money <amount>:添加金钱奖励。
  • /ar add <advancement> item <material> [amount]:添加物品奖励。
  • /ar remove <advancement>:移除某个进度的奖励。
  • /ar reload:重新加载配置和消息。

? 网页编辑器:

在游戏中运行 /ar config 以获取指向 ar.venle.website 上拖拽式编辑器的专属链接。直观地排列金钱和物品奖励,然后点击 Push to server(推送到服务器)——更改将在服务端重新验证并实时生效。关闭标签页即结束会话。

  • 该链接是个人专用且有时效性的——请勿分享。
  • 你的服务器通过自动生成的 plugins/AdvancementRewards/identity.yml 进行标识——这是一个私钥。请妥善保管;仅当需要重置为新身份时才删除它。
  • 每次通过网页应用更改前,都会将备份写入 config.yml.bak,因此推送操作始终可逆。

? 权限:

权限 描述 默认值
ar.reload 重载配置和消息 op
ar.edit 查看、查询和编辑奖励(命令 + Web 编辑器) op
ar.admin 加入时接收更新通知 op

? 数据存储:

领取记录(每位玩家已兑换的进度目标)保存在数据库中,以确保奖励不会被重复领取。默认使用 SQLite —— 无需任何配置;同时支持 MariaDB,适用于共享或多服务器网络环境(在 config.yml 中设置)。从旧版本升级?首次启动时会自动导入现有的 playerdata/*.yml 文件。


? 应用场景:

  • 生存服务器:奖励玩家在关键里程碑上的成就,例如挖掘钻石或进入下界。
  • RPG 或进度服务器:集成对进度里程碑的奖励,以增强游戏玩法的推进感。
  • 活动服务器:追踪玩家在活动期间取得的进展,并根据特定成就给予奖励。

? 兼容性:

  • 平台:Paper、Purpur、Spigot、Bukkit 和 Folia —— 单个 JAR 文件,无需额外配置。若存在 Folia 的区域化调度器,将自动使用它。
  • Minecraft 版本:1.18 – 26.1.2(支持服务器所使用的任何 Java 版本——17 及以上)。在较旧版本中,当服务器未提供图标/标题时,/ar advancements 浏览器会回退到使用普通进度名称显示——所有功能仍可正常运行。
  • 依赖项:需要 Vault 和一个经济插件(EssentialsX/CMI)以实现金钱奖励。仅物品奖励的配置无需任何依赖项。数据库驱动程序已内置——无需安装。

? 立即下载:

立即使用 AdvancementRewards 增强您服务器的进度系统。


你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源