Placeholders
The placeholders zQuestRank provides, and known-good placeholders from other plugins to use in quests and requirements.
Needs PlaceholderAPI installed. Placeholders work in three ways: zQuestRank exposes its own for other plugins (scoreboards, tab, holograms), it reads other plugins' numeric placeholders for PLACEHOLDER quests and requirements, and it fills in any placeholder you put inside menu text (rank and quest names, lore, description).
Placeholders zQuestRank provides
| Placeholder | Shows |
|---|---|
%zquestrank_rank% | The player's current rank number (starting at 1) |
%zquestrank_rank_name% | The current rank's display name |
%zquestrank_quests_completed% | Completed quest count in the current rank |
%zquestrank_quests_total% | Total quest count in the current rank |
Example for a scoreboard line: Rank %zquestrank_rank% (%zquestrank_quests_completed%/%zquestrank_quests_total%).
Placeholders in names and lore
Any %...% placeholder dropped into a rank or quest display-name, lore or description line gets filled in live for the player looking at the menu. Handy for showing a balance, a job level, the player's name, or a custom emoji right inside a name.
display-name: "&aRank II %vault_eco_balance_formatted%"This is also how custom emojis (ItemsAdder and similar) go into a menu name. The chat shortcut like :20: only works in chat, not in the menu, so use the emoji's placeholder instead. For ItemsAdder that is %img_<name>%:
display-name: "&aRank II %img_20%"Check it with /papi parse me %img_20% in game (swap 20 for your emoji name). Without PlaceholderAPI, names show exactly as typed, nothing breaks. See Colors for more.
Placeholders from other plugins
Any placeholder that resolves to a plain number works in a PLACEHOLDER quest or requirement. These are known to work:
| Plugin | Placeholder | Value |
|---|---|---|
| EcoJobs | %ecojobs_<jobid>% (for example %ecojobs_miner%) | Level in that job |
| EcoJobs | %ecojobs_<jobid>_current_xp% | Current XP in that job |
| EcoJobs | %ecojobs_total_job_level% | All job levels added up |
| SuperiorSkyblock2 | %superior_island_level_raw% | Island level, unformatted |
| VotingPlugin | %votingplugin_points% | Current vote points |
| VotingPlugin | %votingplugin_alltimetotal% | All-time vote count |
| ScrollQuest | %scrollquest_completed% | Completed scroll quests |
The EcoJobs <jobid> is whatever your server named the job: the file name (without .yml) in plugins/EcoJobs/jobs/. A job displayed as "Miner" is not necessarily miner internally. Also, EcoJobs placeholders do not appear in /papi ecloud; the plugin registers them directly, so there is nothing to download, they just work.
Prefer raw or unformatted variants. A placeholder that prints 1,900,000 or 1.9M is meant for display; the raw number is what a quest can count. Formatted playtime placeholders like 1d 2h 3m do not work at all, but playtime does not need one: the PLAYTIME_HOURS requirement reads the server's own statistics directly.
Testing a placeholder
Before putting a placeholder into ranks.yml, check it in game:
/rank admin placeholder %ecojobs_miner% SteveThis shows the raw text the placeholder returns for that player and the number zQuestRank reads from it, exactly what a quest or requirement will see. Leave the player name off to test on yourself. PlaceholderAPI's own /papi parse me %ecojobs_miner% works too.
If either says the placeholder did not resolve (or prints it back unchanged), the name is wrong or the providing plugin is missing; zQuestRank treats it as 0 and warns once in the console.