AdvancementsGain

AdvancementsGain is a Minecraft Spigot plugin that allows custom achievements to grant configurable rewards such as XP, economy money (Vault), items, potion effects, and more.

This plugin is designed to work with custom achievements from AdvancementsCore. The source code and releases will be hosted on GitHub.


Features
✔️ Reward players when they complete custom achievements
✔️ Fully configurable rewards: XP, money (Vault), items, potion effects, commands
✔️ Supports multiple rewards per achievement
✔️ Works with AdvancementsCore to trigger custom achievements
✔️ Vault is optional (soft dependency) – works even without an economy plugin
✔️ Uses a lightweight and optimized event system
✔️ Open-source and free!


Installation
Requirements​

How to Install​

⚙️ Configuration
The config.yml file lets you define custom rewards for each achievement.

Example Configuration​

# ==============================
# AdvancementsGain - Config
# ==============================
#
# ➤ Each achievement is defined under `rewards:`, with a unique ID (e.g., "achievement_1").
# ➤ `mode:` determines who receives the reward:
# - "team" → The entire team gets the reward.
# - "player" → Only the player who completed the achievement gets the reward.
# ➤ Available reward types:
# - `xp:` Amount of experience points to grant.
# - `money:` Amount of money to grant (requires Vault).
# - `items:` List of items in format `ITEM:quantity:meta1:meta2`
# - `effects:` List of effects in format `EFFECT:duration:amplifier`
# - `commands:` List of commands executed (`{player}` is replaced with the player's name).
#
# ➤ General Rewards: These rewards are **always** given regardless of the achievement.
# ==============================

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!"]​

Commands & Permissions
Commands
Command Description Permission
/advancementsgain reload Reloads the plugin configuration advancementsgain.admin


Support & Contact
If you encounter issues, feel free to:
Open an issue on GitHub Issues
Ask for help on the SpigotMC Discussion page

For direct support, join the discord server : Join US.​

​