PlaceholderAPI

KoraQuest registers the PlaceholderAPI identifier:

koraquest

PlaceholderAPI must be installed and enabled before the expansion is registered.

General placeholders

Placeholder	Description
%koraquest_active_count%	Total active quests
%koraquest_completed_daily%	Completed quests in the current Daily cycle
%koraquest_daily_total%	Number of quests in the current Daily pool
%koraquest_daily_remaining%	Remaining uncompleted Daily quests
%koraquest_reset_time%	Remaining time for the Daily cycle
%koraquest_streak%	Current Daily streak
%koraquest_best_streak%	Best Daily streak
%koraquest_perfect_weeks%	Number of Perfect Weeks
%koraquest_catchup_tokens%	Available catch-up tokens
%koraquest_season_level%	Current Seasonal level
%koraquest_season_xp%	Current Seasonal experience
%koraquest_season_next_level_xp%	XP threshold for the next level

Cycle placeholders

Replace <cycle> with daily, weekly, monthly, seasonal, or a custom cycle ID.

Placeholder	Description
%koraquest_<cycle>_total%	Total quests in the current pool
%koraquest_<cycle>_completed%	Completed quests in that cycle
%koraquest_<cycle>_remaining%	Remaining quests
%koraquest_<cycle>_active%	Active quests
%koraquest_<cycle>_reset_time%	Time until the next reset
%koraquest_<cycle>_cycle_id%	Current internal cycle instance ID

Examples:

%koraquest_weekly_active%
%koraquest_monthly_reset_time%
%koraquest_seasonal_completed%

Quest placeholders

Replace <id> with a quest ID from quests.yml.

Placeholder	Description
%koraquest_quest_<id>_progress%	Current player progress
%koraquest_quest_<id>_required%	Required amount
%koraquest_quest_<id>_percent%	Completion percentage from 0 to 100
%koraquest_quest_<id>_status%	AVAILABLE, ACTIVE, READY, COMPLETED or UNAVAILABLE
%koraquest_quest_<id>_cycle%	Quest cycle ID

Example:

%koraquest_quest_daily_break_stone_progress%
%koraquest_quest_daily_break_stone_percent%
%koraquest_quest_daily_break_stone_status%

Using external placeholders

When PlaceholderAPI is installed, placeholders from other plugins can be used inside:

• Quest titles
• Quest lore
• Reward commands
• GUI text
• Messages and broadcasts

Example:

title: '&e%player_name%''s Mining Quest'
lore:
  - '&7Balance: &a%vault_eco_balance_formatted%'
rewards:
  - 'broadcast %player_name% completed %quest_name%!'

Note

KoraQuest placeholders read already-cached player data and do not perform blocking database queries from scoreboard or hologram update threads. A player whose data is not loaded may temporarily return zero or UNAVAILABLE until their data is cached.