📰PlaceHolders

Placeholder
Description

%zquests_name_<quest-name>%

Displays the name of the quest. Returns "Unknown" if the quest ID is not valid.

%zquests_description_<quest-name>%

Displays the description of the quest. Returns "Unknown" if the quest ID is not valid.

%zquests_thumbnail_<quest-name>%

Displays the thumbnail material for the quest. Returns "PAPER" if the quest ID is not valid.

%zquests_type_<quest-name>%

Displays the type of the quest (e.g., BLOCK_BREAK, BLOCK_PLACE). Returns "Unknown" if invalid.

%zquests_objective_<quest-name>%

Displays the objective (goal) of the quest for the given quest ID.

%zquests_is_completed_<quest-name>%

Indicates whether the quest is completed by the player (true or false).

%zquests_is_active_<quest-name>%

Indicates whether the quest is active for the player (true or false).

%zquests_progress_bar_<quest-name>%

Displays a progress bar representing the player's progress towards completing the quest.

%zquests_progress_<quest-name>%

Displays the current progress (e.g., number of blocks broken) of the quest for the player.

%zquests_lore_line_<quest-name>%

Displays a formatted line showing the progress towards completing the quest.

%zquests_group_name_<group id>%

Returns the display name of the group

%zquests_group_count_<group id>%

Displays the number of quests in the group

%zquests_group_finish_<group id>%

Displays the number of completed quests in the group

%zquests_group_percent_<group id>%

Displays the percentage of completed quests in the group

%zquests_group_total_percent_<group id>%

Displays the percentage of completed and ongoing quests, providing a more precise progress value than the placeholder above

%zquests_favorite_quests%

Displays the list of favorite quests

In the config.yml file you can configure the placeholder %zquests_lore_line_<quest-name>%, %zquests_favorite_quests% and %zquests_progress_bar_<quest-name>%.

# Progress bar settings:
# icon: The character used to display the completed progress.
# not-completed-icon: The character used to display the uncompleted progress.
# progress-color: The color of the progress bar that is already completed.
# color: The color of the progress bar for sections not yet completed.
# size: The total length of the progress bar, representing the complete goal.
progress-bar:
  icon: '|'
  not-completed-icon: '|'
  progress-color: "#0ff216"
  color: "#828282"
  size: 30
  
# Lore line placeholders:
# active: The format for an active quest's progress in the lore, including placeholders for the progress bar, progress, and goal.
# complete: The format for a completed quest in the lore, indicating completion with a checkmark symbol.
lore-line-placeholder:
  active: "%progress-bar% &8- &6%progress%&8/&f%goal% &c✘"
  complete: "%progress-bar% &8- &6%progress%&8/&f%goal% &a✔"  
  
# Allows creating a placeholder that will group multiple favorite quests.
# This can be used in a scoreboard or an inventory.
placeholder-favorite:
  # The number of favorite quests to display
  limit: 3
  # The message to display when there are no favorite quests
  empty: "&cNo favorite quests"
  # The result for each quest, you can use the following placeholders:
  # %quest-name% - The name of the quest
  # %quest-display-name% - The display name of the quest
  # %quest-description% - The description of the quest
  # %quest-thumbnail% - The icon of the quest
  # %quest-type% - The type of the quest
  # %quest-objective% - The objective of the quest
  # %quest-lore-line% - The placeholder lore-line-placeholder
  # %quest-progress-bar% - The progress bar of the quest
  # %quest-percent% - The percentage of the quest's progress
  # %quest-progress% - The progress of the quest
  # %quest-global-group-name% - The global group name of the quest
  result: "&f%quest-description%\n&8%quest-display-name%\n#fcd600%quest-progress%&8/&f%quest-objective%"
  # The string that will be placed between two quests
  between: "\n\n"  

Last updated