转载 开源 游戏模式 进度获得 v1.4

[MD]
# 进度获得（AdvancementsGain）

AdvancementsGain 是一款 Minecraft Spigot 插件，可在玩家完成自定义成就时发放可配置奖励，包括经验值、经济货币（Vault）、物品、药水效果等。

本插件与 AdvancementsCore 配合使用，专为其自定义成就系统设计。源代码和发行版托管于 GitHub。

---

## 功能特性

- 玩家完成自定义成就时自动发放奖励
- 奖励类型完全可配置：经验值、货币（Vault）、物品、药水效果、命令
- 每个成就支持同时配置多种奖励
- 与 AdvancementsCore 联动，响应自定义成就触发事件
- Vault 为软依赖，可选安装——无经济插件时同样正常运行
- 采用轻量化、高性能的事件系统
- 开源免费

---

## 安装

### 前置要求

- Minecraft 1.17 至 1.21（支持 Paper 和 Spigot）
- Java 17+
- AdvancementsCore（必须）
- Vault（可选，用于货币奖励）

### 安装步骤

1. 从 [Releases](https://github.com/SoimKiyo/AdvancementsGain/releases) 页面下载 AdvancementsGain.jar。
2. 将插件文件放入服务器的 `plugins/` 目录。
3. 若尚未安装，安装 AdvancementsCore（必须）。
4. 若需要货币奖励，安装 Vault 及经济插件（如 EssentialsX）（可选）。
5. 启动服务器，编辑 config.yml 配置奖励内容。
6. 使用 /advancementsgain `reload` 命令重载配置。

---

## 配置

config.yml 文件用于为每个成就定义奖励规则。

### 配置示例

```yaml
# ==============================
# AdvancementsGain - Config
# ==============================
#
# ➤ 每个成就在 `rewards:` 下定义，需指定唯一 ID（如 "achievement_1"）。
# ➤ `mode:` 决定奖励发放对象：
# - "team" → 整个队伍均获得奖励
# - "player" → 仅完成成就的玩家获得奖励
# ➤ 可用奖励类型：
# - `xp:` 发放的经验值数量
# - `money:` 发放的货币数量（需要 Vault）
# - `items:` 物品列表，格式为 `ITEM:quantity:meta1:meta2`
# - `effects:` 效果列表，格式为 `EFFECT:duration:amplifier`
# - `commands:` 执行的命令列表（`{player}` 将替换为玩家名称）
#
# ➤ 通用奖励：无论完成哪个成就，始终发放此处定义的奖励。
# ==============================

general_rewards:
xp: 50
money: 20
items: ["IRON_INGOT:2", "GOLD_NUGGET:5"]
effects: ["LUCK:120:1"]
commands: ["say {player} received a general reward!"]

rewards:
achievement_break_diamond_ore:
mode: "player"
xp: 200
money: 100
items: ["DIAMOND:5", "IRON_PICKAXE:1:EFFICIENCY_3:UNBREAKING_2"]
effects: ["HASTE:120:2"]
commands: ["say {player} has mined their first diamond ore!"]

achievement_full_netherite_armor:
mode: "player"
xp: 500
money: 300
items: ["NETHERITE_INGOT:2", "TOTEM_OF_UNDYING:1"]
effects: ["RESISTANCE:300:2", "STRENGTH:300:2"]
commands: ["say {player} is now a true Netherite warrior!"]
```

---

## 命令与权限

| 命令 | 说明 | 权限节点 |
|------|------|----------|
| /advancementsgain reload | 重载插件配置 | `advancementsgain.admin` |

---

## 支持与联系

如遇问题，可通过以下方式获取帮助：

- 在 [GitHub Issues](https://github.com/SoimKiyo/AdvancementsGain/issues) 提交 Issue
- 在 SpigotMC 讨论页发帖求助
- 加入 Discord 服务器直接获取支持：[Join US](https://discord.gg/Q42XFEyUH5)
[/MD]