Quests

Every tool has its own quests. They give players a goal beyond just earning, and they pay a currency reward straight onto the tool.

Two kinds of quest

Quest chain

A fixed list in order. Finish one quest to unlock the next. This is the long-term goal for the tool.

Daily quests

A pool that refreshes once a day. Clear all of them for an extra bonus on top of each reward.

How a quest is set up

Each tool's quests live in quests/<tool>_quests.yml. A quest has a target action and a goal count. For example "break 500 stone" or "catch 20 fish".

The target is an uppercase material, entity, or item name. You can also use the word ANY to count every action that fits.

How players progress

Quest progress is saved on the tool, next to its currency and upgrades. Rewards go to the tool's balance, not to a Vault economy.

Play with the tool

Mining, fighting, or fishing adds to the quest count.

Finish the quest

The player gets a message when a quest is done.

With quests.require-claim on, rewards wait for the player. A "Claim Rewards" button in the tool's Quests menu shows how many rewards are waiting and the total. The player clicks it to add the total to the tool's balance.

Turn quests.require-claim off to pay each reward the moment its quest is done, with no button to click.

The daily reset

The daily quests roll over at the reset time and timezone you set under quests.daily in config.yml. When the day changes, the daily quests refresh and the player is told.

To test the rollover fast, set the reset time to one minute ahead and wait.

See Configuration for the quests.daily keys.