Rewards

Rewards

A quest lists its rewards under rewards. The list can be empty.

All types

Type	Fields	What the player gets
justquests:give_item	item, count	Items, dropped at their feet if the inventory is full
justquests:loot_table	loot_table	The items of a loot table
justquests:xp	amount	Experience points
justquests:effect	effect, seconds (default 30), amplifier (default 0)	A potion effect
justquests:message	message	A chat message, as text or a per-language map
justquests:title	title, subtitle (optional), fade_in (10), stay (70), fade_out (20)	A title on screen. The times are in ticks.
justquests:command	command	A command run for the player. {player} becomes their name.
justquests:choice	options	One reward of their choice when they claim
justquests:money	amount	Money through an economy plugin (plugin only, see Server Plugin)

Examples

"rewards": [
  { "type": "justquests:give_item", "item": "minecraft:diamond", "count": 2 },
  { "type": "justquests:xp", "amount": 100 },
  { "type": "justquests:effect", "effect": "minecraft:speed", "seconds": 60, "amplifier": 1 },
  { "type": "justquests:loot_table", "loot_table": "minecraft:chests/simple_dungeon" },
  { "type": "justquests:command", "command": "give {player} minecraft:cookie 1" },
  { "type": "justquests:title", "title": "Well done!", "subtitle": "Quest complete" }
]

A choice of rewards

The player picks one option when claiming. A quest can have one choice.

{
  "type": "justquests:choice",
  "options": [
    { "type": "justquests:give_item", "item": "minecraft:diamond", "count": 2 },
    { "type": "justquests:give_item", "item": "minecraft:emerald", "count": 8 },
    { "type": "justquests:xp", "amount": 200 }
  ]
}

In the quest book the player clicks an option, then Claim. In the chat they use /quest claim <id> <number>, starting at 1.

Claiming or paying out at once

By default a finished quest waits until the player claims its rewards. With "claimRewards": false in Settings, rewards are paid out at once. Quests with a choice always wait, because the player has to pick. A quest without rewards is simply done.