Quests and Rewards
About 547 wordsAbout 2 min
This page lists every quest type and reward type that orders.yml accepts, and what the plugin counts for each one.
Quest types
break_block
quest:
mine_stone:
type: break_block
item: stone
amount: 16Counts one block every time the player breaks a block of the configured material. Cancelled break events do not count, and blocks placed by the player count like any other block.
place_block
quest:
build_wall:
type: place_block
item: dirt
amount: 8Counts one block every time the player places a block of the configured material.
mob_kill
quest:
hunt_zombies:
type: mob_kill
mob: zombie
amount: 5Counts one kill when the player kills the configured entity type. The killer is resolved from the damage source, so a kill with an arrow counts. A mob that dies without a player as the causing entity does not count.
fish
quest:
catch_cod:
type: fish
item: cod
amount: 1Counts one successful catch whose item matches the configured material. Failed reels and catches of another item do not count.
feed
quest:
feed_cows:
type: feed
mob: cow
amount: 2Counts one interaction when the player right-clicks the configured animal while holding a food that the animal accepts. The accepted food is fixed by the plugin:
| Entity | Accepted food |
|---|---|
cow, sheep, horse, llama | wheat |
pig, rabbit | carrot |
chicken, parrot | wheat_seeds |
fox | sweet_berries |
turtle | seagrass |
wolf | bone |
cat | cod or salmon |
Only these animals can be used in a feed quest. Right-clicking another animal, or holding another item, does not add progress.
Reward types
A reward list is read from top to bottom. Every entry uses ; as the separator:
reward:
- 'item;diamond;16'
- 'company_income;1500.0'
- 'money;100.0'
- 'experience;10'
- 'console_command;say %player% finished an order!'item
item;<material>;<amount>Gives the item to the player's inventory. An invalid material or amount skips that reward line. Make sure the player has enough inventory space before the order is completed.
company_income
company_income;<amount>Adds the amount to the company balance as company income. It fires the company income event, so it is included in the daily income and is taxed like other company income. See Company funds.
money
money;<amount>Deposits the amount into the player's balance through Vault.
experience
experience;<amount>Gives the player that amount of experience points.
console_command
console_command;<command>Runs the command as the console, with %player% replaced by the player's name. Write the command without a leading slash, for example say %player% finished an order!.
Because the entry is split on ;, a command cannot contain a semicolon. The console command is executed on completion but is not listed in the order menu's reward lines.
What the menu shows
The menu builds each order entry from the language file:
quest-progress— one progress line, filled with%action_description%,%target%,%progress_value%and%target_value%action-description.*— the action name, for exampleBreak block(s)rewards.item,rewards.company_income,rewards.money,rewards.experience— the reward labelsorder-finished— shown instead of progress when the order has been completedmenu.orders.items.order.display_nameand.lore— the order entry itself
%quest_progress% and %order_reward% are replaced with several lines at once, so a single placeholder line in the menu lore becomes one line per quest or reward.
See Menu Configuration for how menu files and language paths work.