Advancement Rewards

AdvancementRewards

Reward your players for completing advancements with in-game currency.

Overview:

AdvancementRewards is a lightweight and highly customizable Minecraft plugin that rewards players with in-game currency for completing specific advancements. Built with Vault integration, it works seamlessly with popular economy plugins like EssentialsX and CMI. Server owners can configure rewards for each advancement through a simple configuration file, giving them full control over the progression system.

---

🌐 Try AdvancementRewards on SoulSteal!

If you'd like to see Lifesteal SMP in action, visit Lifesteal SMP, a community-focused Lifesteal SMP server with a vanilla Minecraft experience. Explore progression and rewards as you play.

Server Details:

- Java & Bedrock Support: SoulSteal SMP - Java & Bedrock Support: `SoulSteal.me` - Java & Bedrock Support: 1.9.x – 1.21.x

---

📋 Features:

- Configurable Rewards: Configure specific rewards for each Minecraft advancement. - Configurable Rewards: Works with any Vault-compatible economy plugin. - Configurable Rewards: Easily adjust rewards using the `config.yml` file.

---

🎮 How It Works:

1. Players complete advancements. 2. If the advancement is listed in the config, they receive a reward. 3. AdvancementRewards checks if the player has already claimed the reward. If not, they are awarded. 4. 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 the amount they receive.

Example `config.yml`:

```yaml

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`: ```yaml minecraft:adventure/adventuring_time: 300.0 ```

---

🚀 Installation:

1. Download the AdvancementRewards.jar and place it in your server's `plugins` folder. 2. Restart your server to generate the default `config.yml`. 3. Modify the `config.yml` to customize advancement rewards. 4. Restart your server or reload the plugin with `/ar reload`.

---

🛠 Commands:

- /ar reload: Reloads the plugin configuration without restarting the server.

---

🛡 Permissions:

| Permission | Description | Default | |-------------------------|------------------------------------------|------------| | `advancementrewards.reload` | Allows players to reload the plugin config | `op` |

---

💾 Data Storage:

Each player’s progress is saved in their own file in the `playerdata` folder, preventing players from claiming rewards multiple times for the same advancement.

---

💡 Use Cases:

- Event Servers: Reward players for key milestones like mining diamonds or entering the Nether. - Event 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:

- EssentialsX: 1.16.x – 1.21.x (with future version support) - EssentialsX: Requires EssentialsX and a compatible economy plugin like EssentialsX.

---

📥 Download Now:

Start enhancing your server's advancement system with AdvancementRewards today.

---