> For the complete documentation index, see [llms.txt](https://nukegh05t.gitbook.io/deliveryboard/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nukegh05t.gitbook.io/deliveryboard/deliveryboard-wiki/formatting-string/reward-string.md).

# Reward String

All available things about giving rewards.

Reward syntax consists 3 or 4 parts , each part is separated by `@` character.\
\
The first part defines the type of reward. Can be `item` (Item) or `comm` (Command).

### Item Reward

`item` type is used to reward a Vanilla minecraft item directly. It has 4 parts. The first part is `item` as it defines that it is an Item Reward.\
\
The 2nd part is the Material Name. This must match the name from [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html).\
The 3rd part is the amount of item to give. The max amount is the max stack size of that item.\
\
*And the last part is the reward weight(This is ONLY applicable for rewards from `random-reward-pool`).*\
\
To give the player 10 Apples, the string will be: `item@APPLE@10` and `item@APPLE@10@1` for `random-reward-pool` rewards with a weight of 1.

### Command Reward

`comm` type is used to execute a command on successful completion. It has 2 parts. The first part is `comm` as it defines that it is an Item Reward.\
\
The 2nd part is the command that is going to be run without slash(`/`).\
\
*And the last part is the reward weight(This is ONLY applicable for rewards from `random-reward-pool`).*\
\
To give the player 10 Experience levels, the string will be: `comm@xp add {PLAYER_NAME} 10 levels` and `comm@xp add {PLAYER_NAME} 10 levels@5` for `random-reward-pool` rewards with a weight of 5.

`{PLAYER_NAME}` is a placeholder that is replaced by the player's name before executing the command. Check [Placeholders](/deliveryboard/deliveryboard-wiki/placeholders.md)for available placeholders and their usage.
