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 AdvancementRewards in action, visit SoulSteal.me, a community-focused Lifesteal SMP server with a vanilla Minecraft experience. Explore progression and rewards as you play.

Server Details:

• Name: SoulSteal SMP
• IP: SoulSteal.me
• Java & Bedrock Support: 1.9.x – 1.21.x

---

📋 Features:

• Custom Advancement Rewards: Configure specific rewards for each Minecraft advancement.
• Vault Integration: 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:

# 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

---

🚀 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:

• 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:

• Minecraft Versions: 1.16.x – 1.21.x (with future version support)
• Dependencies: Requires Vault and a compatible economy plugin like EssentialsX.

---

📥 Download Now:

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

---