Placeholders

zDailyQuests ships a PlaceholderAPI expansion so quest info can show up anywhere placeholders work, chat, scoreboards, tab lists, holograms and more.

The expansion registers itself automatically when PlaceholderAPI is on the server. You will see this line in the console on boot:

[zDailyQuests] Hooked into PlaceholderAPI, %zdailyquests_...% placeholders are live.

If PlaceholderAPI is not installed, the plugin skips the hook quietly and everything else runs as normal. The placeholders simply will not resolve.

Note

%quest% on its own is not one of these. It is an internal token used only inside the plugin’s own chat messages in lang.yml, so it will never resolve in an external plugin. Use the %zdailyquests_...% placeholders below for anything outside the plugin.

Summary placeholders

Placeholder	Returns	Example
%zdailyquests_completed%	quests done in the current set	3
%zdailyquests_total%	quests in the set	5
%zdailyquests_bonus%	the all-five bonus state: ready, claimed or locked	ready
%zdailyquests_time_left%	time until the set resets	5h 32m

Per-quest placeholders

Each quest slot has its own set. n starts at 1 and goes up to your quests-per-player.

Placeholder	Returns	Example
%zdailyquests_quest_n_name%	the quest’s display name	Destroyer I
%zdailyquests_quest_n_progress%	current progress, whole number	240
%zdailyquests_quest_n_target%	the goal amount	500
%zdailyquests_quest_n_status%	the phase: not-started, in-progress, completed-unclaimed or completed	in-progress

So %zdailyquests_quest_1_name% is the first quest’s name, %zdailyquests_quest_2_progress% is the second quest’s progress, and so on.

Caution

A slot number past the end of a player’s set (or any read before their data has finished loading) returns an empty string, never an error.

Testing them

With PlaceholderAPI installed, use its parse command on yourself:

/papi parse me %zdailyquests_completed%
/papi parse me %zdailyquests_quest_1_name%

The value should match what you see when you open /dq.

Related pages

The Menu Resize, restyle and lay out the quest board.

Messages & Language The %quest% and other in-message tokens.

Commands Every command and permission.