# AdvancementRewards
**通过完成成就奖励玩家游戏内货币。**
### 概述:
AdvancementRewards 是一个轻量级且高度可定制的 Minecraft 插件，它通过完成特定成就奖励玩家游戏内货币。 它与 Vault 集成，可以与 EssentialsX 和 CMI 等流行的经济插件无缝协作。 服务器管理员可以通过简单的配置文件配置每个成就的奖励，从而完全控制游戏进度系统。
---
## 🌐 在 SoulSteal 上试试 AdvancementRewards!
如果您想了解 **AdvancementRewards** 的实际应用，请访问 **SoulSteal.me**，这是一个以社区为中心的 **生命值盗取 SMP** 服务器，提供原版 Minecraft 游戏体验。 在游玩过程中，探索进度和奖励。
### 服务器详情:
- **名称**: SoulSteal SMP
- **IP**: `SoulSteal.me`
- **Java & Bedrock 支持**: 1.9.x – 1.21.x
---
## 📋 特性:
- **自定义成就奖励**: 为每个 Minecraft 成就配置特定的奖励。
- **Vault 集成**: 与任何 Vault 兼容的经济插件协同工作。
- **可配置奖励**: 使用 `config.yml` 文件轻松调整奖励。
---
## 🎮 工作原理:
1. 玩家完成成就。
2. 如果成就列在配置中，他们将获得奖励。
3. AdvancementRewards 检查玩家是否已经领取过该奖励。 如果没有，则奖励他们。
4. 如果已领取奖励，则不会给予任何额外的奖励。
---
## ⚙️ 配置:
该插件会生成一个 `config.yml` 文件，您可以通过该文件定义哪些成就奖励玩家以及他们获得的货币数量。
### 示例 `config.yml`:
```yaml
# 设置特定成就的奖励
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` 文件：
```yaml
minecraft:adventure/adventuring_time: 300.0
```
---
## 🚀 安装:
1. 下载 **AdvancementRewards.jar** 并将其放在服务器的 `plugins` 文件夹中。
2. 重新启动服务器以生成默认的 `config.yml` 文件。
3. 修改 `config.yml` 文件以自定义成就奖励。
4. 重新启动服务器或使用 `/ar reload` 命令重新加载插件。
---
## 🛠 命令:
- **/ar reload**: 在不重新启动服务器的情况下重新加载插件配置。
---
## 🛡 权限:
| 权限 | 描述 | 默认 |
|-------------------------|------------------------------------------|------------|
| `advancementrewards.reload` | 允许玩家重新加载插件配置 | `op` |
---
## 💾 数据存储:
每个玩家的进度保存在 `playerdata` 文件夹中的各自文件中，从而防止玩家多次领取同一成就的奖励。
---
## 💡 用途:
- **生存服务器**: 奖励玩家在挖掘钻石或进入地狱等关键里程碑。
- **角色扮演或进度服务器**: 集成成就里程碑的奖励，以增强游戏进度。
- **活动服务器**: 跟踪玩家在活动期间的进度，并根据特定成就奖励他们。
---
## 🔧 兼容性:
- **Minecraft 版本**: 1.16.x – 1.21.x (未来版本支持)
- **依赖项**: 需要 **Vault** 和兼容的经济插件，如 **EssentialsX**。
---
## 📥 立即下载:
立即使用 **AdvancementRewards** 增强您的服务器的成就系统。
---