Placeholders
PlaceholderAPI placeholders use the typewriter expansion, so every placeholder starts with %typewriter_. They need a player and return nothing without one.
Global
| Placeholder | Returns |
|---|---|
%typewriter_total_quests% | Number of distinct quests across all categories. |
%typewriter_total_completed% | Completed quests. |
%typewriter_total_in_progress% | In progress quests (also total_inprogress). |
%typewriter_total_not_started% | Not started quests (also total_notstarted). |
%typewriter_total_progress% | Completed over total, for example 15/42. |
Per category
<name> is the category value of a Quest Category, matched without regard to case. An unknown category returns 0.
| Placeholder | Returns |
|---|---|
%typewriter_category_<name>% | Number of quests, sub-categories included. |
%typewriter_category_<name>_completed% | Completed quests. |
%typewriter_category_<name>_in_progress% | In progress quests (also _inprogress). |
%typewriter_category_<name>_not_started% | Not started quests (also _notstarted). |
%typewriter_category_<name>_progress% | Completed over total, for example 3/10. |
Tracked quests
Indexes start at 1. The last tracked quest is the primary one shown by the official tracker. An index with no quest returns an empty string.
| Placeholder | Returns |
|---|---|
%typewriter_codex_tracked_count% | Number of tracked quests. |
%typewriter_codex_tracked_limit% | The maxTrackedQuests setting. |
%typewriter_codex_tracked_multi_enabled% | Whether multi-tracking is on. |
%typewriter_codex_tracked_has_any% | Whether at least one quest is tracked. |
%typewriter_codex_tracked_ids% | Comma-separated quest ids. |
%typewriter_codex_tracked_names% | Comma-separated quest names. |
%typewriter_codex_tracked_names_lines% | One quest name per line. |
%typewriter_codex_tracked_primary_id% | Id of the primary quest. |
%typewriter_codex_tracked_primary_name% | Name of the primary quest. |
%typewriter_codex_tracked_has_<quest_id>% | Whether that quest is tracked. |
%typewriter_codex_tracked_<n>_id% | Id of the n-th tracked quest. |
%typewriter_codex_tracked_<n>_name% | Display name. |
%typewriter_codex_tracked_<n>_status% | inactive, active or completed. |
%typewriter_codex_tracked_<n>_primary% | Whether it is the primary quest. |
%typewriter_codex_tracked_<n>_objective_count% | Number of visible objectives. |
%typewriter_codex_tracked_<n>_objectives% | Visible objectives, comma-separated. |
%typewriter_codex_tracked_<n>_objectives_lines% | Visible objectives, one per line. |
%typewriter_codex_tracked_<n>_priority% | Highest priority among the visible objectives. |
For menus, prefer TRACKED_QUEST_SLOT markers in a Category Menu with the category @tracked. Use these placeholders for headers, counters or text outside the menu.
Message variables
These are replaced inside the fields of the global settings, not by PlaceholderAPI.
| Variable | Available in | Replaced by |
|---|---|---|
{quest} | Tracking, inactive and completed messages | The quest display name. |
{completed}, {total} | categoryProgressMessage | Completed and total quests of the category. |
{max} | trackingLimitMessage | The maximum number of tracked quests. |
{category} | unknownCategoryMessage | The category name the player typed. |