# Rewards

Rewards feature allows you to reward players in a dungeon when a specific event occurs with Variables and custom item support.

Rewards configurations located in the /rewards/ directory inside a dungeon's folder.

To give a reward, use the give_reward Script Action.

# Creation

Adding rewards to a dungeon is simple:

Run the /ada reward create <dungeonId> <name> command. Where dungeonId is dungeon ID, name is reward ID.

Add some items to a reward:

Hold an item in the main hand.
Run the /ada reward additem <dungeonId> <rewardId> command. Where dungeonId is dungeon ID, reward is reward ID.
Repeat for all other items.

To configure the rest of reward settings, you have to go to a reward's configuration file.

Sets reward display name. This name is returned by the %reward_name% internal placeholder.

Name: Gold

Sets reward description. This text is returned by the %reward_description% internal placeholder.

Description:
- 'One gold bar'
- 'and nothing more.'

Sets commands to execute when reward is given to a player.

Commands:
- eco give %player_name% 50
- tell %player_name% Here is some money!

You can use Variables, internal Dungeon and Dungeon Player placeholders, and PlaceholderAPI here.