AdvancementRewards
为完成进度目标(advancements)的玩家提供奖励——金钱、物品,或两者兼有。
注意:
概述:
AdvancementRewards 是一款可定制的 Minecraft 插件,可为玩家完成任何进度目标(包括原版、数据包添加的进度以及模组/插件添加的进度)时提供金钱、物品或两者兼有的奖励。金钱发放通过 Vault(支持 EssentialsX、CMI 及其他提供者)实现;仅发放物品的设置则无需任何依赖项。你可以从 config.yml 进行配置,使用游戏内命令,或通过可视化的拖拽式网页编辑器(/ar config)进行操作——让你对进度系统拥有完全的控制权。
? 功能特性:
- 金钱与物品奖励:为任意进度目标授予游戏内货币、物品(支持自定义名称和描述文本),或两者兼有。
- 支持所有进度:原版进度、数据包进度以及模组/插件添加的进度均受支持。
- 网页编辑器:通过
/ar config 在浏览器中使用拖拽界面编辑奖励——无需编写 YAML 文件。
- 游戏内命令:添加、删除、列出和浏览进度目标,无需触碰配置文件。
- Vault 经济系统:兼容任何 Vault 提供者(如 EssentialsX、CMI……);可在配置中选择具体提供者。
- 仅物品模式:若只发放物品,则无需安装 Vault 即可运行。
? 工作原理:
- 玩家完成进度目标。
- 如果该进度目标在配置文件中已定义,玩家将收到奖励。
- AdvancementRewards 会检查玩家是否已领取该奖励。若未领取,则予以发放。
- 若奖励已被领取,则不再发放额外奖励。
⚙️ 配置方法:
插件会生成一个 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: ""
? 安装步骤:
- 下载 AdvancementRewards.jar 并将其放入服务器的
plugins 文件夹中。
- 重启服务器以生成默认的
config.yml 配置文件。
- 修改
config.yml 文件来自定义进度奖励。
- 重启服务器或使用
/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 增强您服务器的进度系统。
AdvancementRewards
Reward your players for completing advancements — with money, items, or both.
NOTE:
- Custom items are work in progress.
Overview:
AdvancementRewards is a customizable Minecraft plugin that rewards players with money, items, or both for completing advancements — vanilla, datapack, or mod/plugin-added alike. Money payouts use Vault (EssentialsX, CMI, and other providers); item-only setups need no dependencies. Configure rewards from config.yml, with in-game commands, or visually in the drag-and-drop web editor (/ar config) — giving you full control over the progression system.
? Features:
- Money & item rewards: Grant in-game currency, items (with custom names & lore), or both for any advancement.
- Any advancement: Vanilla, datapack, or mod/plugin-added — all supported.
- Web editor: Edit rewards from a drag-and-drop browser UI with
/ar config — no YAML required.
- In-game commands: Add, remove, list, and browse advancements without touching files.
- Vault economy: Works with any Vault provider (EssentialsX, CMI, …); pick the provider in config.
- Item-only mode: Runs without Vault if you only hand out items.
? How It Works:
- Players complete advancements.
- If the advancement is listed in the config, they receive a reward.
- AdvancementRewards checks if the player has already claimed the reward. If not, they are awarded.
- If a reward has already been claimed, no additional rewards are given.
⚙️ Configuration:
The plugin generates a config.yml that allows you to define which advancements reward players and what they receive (money, items, or both).
Example config.yml:
# Set rewards for specific advancements
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: Define which advancements give rewards and set the amount of in-game currency for each.
Adding New Advancements:
To add a new advancement, simply edit the config.yml:
minecraft:adventure/adventuring_time: 300.0
Item & combined rewards (rich form):
A reward can also be a section with optional money and an items list. Items support an
amount, a name, and lore (both accept & colour codes):
advancement-rewards:
# money only (simple form)
minecraft:story/mine_diamond: 500.0
# money + items
minecraft:end/kill_dragon:
money: 1000.0
items:
- material: DRAGON_HEAD
amount: 1
name: "&5Dragon Slayer's Trophy"
lore:
- "&7Proof you bested the Ender Dragon"
- material: DIAMOND
amount: 5
The economy provider and update notifications are also configurable:
economy:
provider: auto # auto | Essentials | CMI | <custom Vault provider>
notify-update: true
Storage (config.yml only):
Claim data (which advancements each player already redeemed) is stored in SQLite by
default; switch to MariaDB for shared/multi-server setups. Configured here only — never
via the web editor. Legacy playerdata/*.yml files are imported automatically on first start.
storage:
type: sqlite # sqlite | mariadb
mariadb: # used only when type: mariadb
host: localhost
port: 3306
database: advancementrewards
username: root
password: ""
? Installation:
- Download the AdvancementRewards.jar and place it in your server's
plugins folder.
- Restart your server to generate the default
config.yml.
- Modify the
config.yml to customize advancement rewards.
- Restart your server or reload the plugin with
/ar reload.
? Commands:
All under /ar:
- /ar config: Open the drag-and-drop web editor (gives you a personal link).
- /ar list [page]: List configured advancement rewards.
- /ar advancements [filter] [page]: Browse every advancement on the server (vanilla/datapack/mod).
- /ar add <advancement> money <amount>: Add a money reward.
- /ar add <advancement> item <material> [amount]: Add an item reward.
- /ar remove <advancement>: Remove an advancement's rewards.
- /ar reload: Reload the configuration and messages.
? Web Editor:
Run /ar config in-game to get a personal link to a drag-and-drop editor at ar.venle.website. Arrange money and item rewards visually, then hit Push to server — changes are re-validated server-side and applied live. The session ends when you close the tab.
- The link is personal and short-lived — don't share it.
- Your server is identified by an auto-generated
plugins/AdvancementRewards/identity.yml — a private key. Keep it; delete it only to reset to a new identity.
- A backup is written to
config.yml.bak before every web apply, so a push is always reversible.
? Permissions:
| Permission |
Description |
Default |
ar.reload |
Reload the configuration and messages |
op |
ar.edit |
View, query, and edit rewards (commands + web editor) |
op |
ar.admin |
Receive update notifications on join |
op |
? Data Storage:
Claim history (which advancements each player has already redeemed) is kept in a database so rewards can never be claimed twice. SQLite is used by default — zero setup — and MariaDB is supported for shared or multi-server networks (set in config.yml). Upgrading from an older version? Your existing playerdata/*.yml files are imported automatically on first start.
? Use Cases:
- Survival Servers: Reward players for key milestones like mining diamonds or entering the Nether.
- RPG or Progression Servers: Integrate rewards for advancement milestones to enhance gameplay progression.
- Event Servers: Track player progress during events and reward them based on specific achievements.
? Compatibility:
- Platforms: Paper, Purpur, Spigot, Bukkit, and Folia — one jar, no extra setup. Folia's regionised scheduler is used automatically where present.
- Minecraft Version: 1.18 – 26.1.2 (runs on whatever Java your server uses — 17 and up). On older versions the
/ar advancements browser falls back to plain advancement names where the server doesn't expose icons/titles — everything still works.
- Dependencies: Vault + an economy plugin (EssentialsX/CMI) for money rewards. Item-only setups need no dependencies. The database drivers are bundled in — nothing to install.
? Download Now:
Start enhancing your server's advancement system with AdvancementRewards today.
评论 0
登录后参与评分
还没有评论,来抢沙发吧