Skip to main content

Rewards

EpicAchievements offers a bunch of built-in reward types:

tip

You can use the {player} and {uuid} placeholders in all rewards.

RewardDescriptionRequired arguments
pointsGive achievement points to a player
Points are used to unlock rewards!
amount
action_barSend an action bar messagemessage
broadcastBroadcast a message to the servermessage
commandExecute a console commandcommand
experience_levelsGive experience levels to a playeramount
experienceGive experience points to a playeramount
itemGive an item to a playeritem
messageSend a message to a playermessage
titleSend a title to a playertitle subtitle

Plugin Hooks

PluginRewardDescriptionRequired arguments
VaultvaultGive money to a playeramount
PlayerPointsplayer_pointsGive points to a playeramount

Customizing reward descriptions

Reward descriptions displayed in menus can be customized to override the default description defined in rewards.yml:

rewards:
- type: points
amount: 10
# Override the default description
# The {amount} placeholder is available
description: "&8+ &7A nice gift!"

The reward leveling system

Using the points earned by completing achievements, players can unlock rewards.
Below is an example configuration:

tip

You can use the {level} placeholder to get the current level.
Math expressions and functions are supported!

rewards.yml
# Default descriptions for rewards.
# You can hide a description for a reward by deleting it.
reward-descriptions:
# <reward-id>: "<description>"
points: "&8+&e{amount} &7Achievement Points"
vault: "&8+&e{amount} &7Coins"
experience: "&8+&e{amount} &7Experience"
experience_levels: "&8+&e{amount} &7Experience Levels"
player_points: "&8+&e{amount} &7Coins"
# Reward leveling system.
levels:
# A range of levels
1-50:
# Points required to unlock the reward. Math expressions are supported!
required-points: "{level} * 100"
# A list of rewards
rewards:
- type: vault
amount: "{level} * 100"
# Item displayed when the reward is locked
locked:
material: "COAL"
name: "&cAchievement Reward"
lore:
- "&8Level {level}"
- "&7Required Points: &e{points}"
- ""
- "&7Rewards:"
- "{rewards}"
- ""
- "&cYou can't claim this yet!"
# Item displayed when the reward has been claimed
claimed:
material: "GOLD_NUGGET"
name: "&aAchievement Reward"
lore:
- "&8Level {level}"
- "&7Required Points: &e{points}"
- ""
- "&7Rewards:"
- "{rewards}"
- ""
- "&aYou have already claimed this reward!"
# Item displayed when the reward has not been claimed
unclaimed:
material: "GOLD_NUGGET"
name: "&eAchievement Reward"
lore:
- "&8Level {level}"
- "&7Required Points: &e{points}"
- ""
- "&7Rewards:"
- "{rewards}"
- ""
- "&eClick to claim this reward!"
glow: true
# Other levels can be added below