Quest Rewards

Rewards are optional items or commands given when a viewer quest completes.

Turn on Has Reward in Minecraft: Start Viewer Quest to add rewards.

Reward types

Item Reward

Gives an item to the Minecraft player when the quest completes.

Fields:

• Item ID: item to give, like minecraft:diamond.
• Amount: item amount.
• Item Data: optional item data for names, lore, enchantments, components, NBT, or modded data.
• Reward Visibility: whether the reward is shown before completion.

Item reward examples

Plain item reward

Reward Type: Item Reward
Item ID: minecraft:diamond
Amount: 3
Item Data:

Basic named item reward for Minecraft 1.21.1

Reward Type: Item Reward
Item ID: minecraft:stick
Amount: 1
Item Data: [custom_name='{"text":"Bonk Stick","color":"gold"}']

Advanced item reward for Minecraft 1.21.1

Reward Type: Item Reward
Item ID: minecraft:stick
Amount: 1
Item Data: [custom_name='{"text":"Bonk Stick","color":"gold"}',lore=['{"text":"Won from a viewer quest","color":"gray"}'],enchantments={levels:{"minecraft:knockback":2}}]

Command Reward

Runs a Minecraft command from the server when the quest completes.

Fields:

• Display Name: readable reward text shown in quest UI and variables.
• Command: command to run.
• Reward Visibility: whether the reward is shown before completion.

Example:

Reward Type: Command Reward
Display Name: Receive 5 levels
Command: xp add $minecraftQuestPlayerName 5 levels

Random rewards

When Random Reward is enabled, one reward row is picked when the quest completes.

Each reward row can have:

• Weight: higher weight means more likely.
• Show Percentage: shows the calculated chance in the questbook.