PlaceholderAPI
PlaceholderAPI is optional. Use these in other plugins; Dungeon does not create holograms.
Server
Section titled “Server”| Placeholder | Returns |
|---|---|
%dungeon_element% |
today’s boss element, lowercase |
%dungeon_element_title% |
the same, capitalised |
%dungeon_element_tomorrow% |
tomorrow’s element, lowercase |
%dungeon_element_tomorrow_title% |
the same, capitalised |
%dungeon_players_today% |
how many distinct players entered a dungeon today |
%dungeon_clears_today% |
how many distinct players killed today’s boss |
%dungeon_level_cap% |
the configured dungeon level cap |
Player
Section titled “Player”Player counters return blank without a viewer. New accounts return zero for empty counters.
| Placeholder | Returns |
|---|---|
%dungeon_level% |
current level |
%dungeon_xp% |
lifetime experience |
%dungeon_xp_needed% |
experience left to the next level |
%dungeon_progress% |
whole percent through the current level |
%dungeon_difficulty% |
the difficulty band their level allows, from 1 |
%dungeon_runs% |
lifetime runs entered |
%dungeon_clears% |
lifetime boss clears |
%dungeon_souls% |
souls held |
%dungeon_shards% |
soul shards held |
%dungeon_runs_today% |
entries used today |
%dungeon_runs_left% |
entries left today |
%dungeon_rank_level% |
their place on the level board |
%dungeon_rank_runs% |
their place on the runs board |
%dungeon_level_colour% |
their rank colour, bare #RRGGBB |
%dungeon_level_color% |
the same, spelled the other way |
%dungeon_level_mini% |
<#RRGGBB>34, MiniMessage, for FancyHolograms |
%dungeon_level_legacy% |
§x§F§F§3§B§4§E34, the old Spigot escape |
Leaderboards
Section titled “Leaderboards”N is 1–10. Missing rows are blank. Boards cache for 45 seconds.
| Placeholder | Returns |
|---|---|
%dungeon_top_level_N% |
Name - 34 |
%dungeon_top_level_N_name% |
just the name |
%dungeon_top_level_N_value% |
just the level |
%dungeon_top_runs_N% |
Name - 212 |
%dungeon_top_runs_N_name% |
just the name |
%dungeon_top_runs_N_value% |
just the count |
Do not wrap the rank colour in another colour tag. levels.cap defaults to 100; capstone players can show level 101.
Achievements
Section titled “Achievements”| Placeholder | Returns |
|---|---|
%dungeon_achievements_earned% |
how many achievements the player holds |
%dungeon_achievements_total% |
how many exist |
%dungeon_achievement_rank_xp% |
earned achievement Rank XP |
%dungeon_achievement_points% |
alias for earned achievement Rank XP |
%dungeon_achievement_rank_xp_total% |
total Rank XP on offer |
%dungeon_achievement_points_total% |
alias for total Rank XP on offer |
%dungeon_emblem% |
the chosen emblem icon, or blank |
%dungeon_emblem_tier% |
its tier |
%dungeon_emblem_colour% |
its colour |
Achievement totals are server-wide and work without a viewer.
Quest footer for TAB
Section titled “Quest footer for TAB”| Placeholder | Returns |
|---|---|
%dungeon_tab_active% |
true when a quest footer is available, otherwise false |
%dungeon_tab_quests% |
multiline mission and Hunter contract progress with legacy colours |
The footer is available while the viewer is in their dungeon world. It refreshes every 10 ticks and expires after five seconds without an update. Without a viewer or a current footer, tab_quests is blank and tab_active is false. TAB owns the header and footer layout.
Unknown names remain raw placeholder text.