Placeholders
DrakoDungeons registers an internal PlaceholderAPI expansion when PlaceholderAPI is installed and enabled. Every placeholder begins with %drakodungeons_ and ends with %.
Leaderboards
Leaderboard positions are 1-based. Replace # with a number from 1 through 500 and replace <currency> with a configured currency ID such as money, souls, essence, shards, or credits.
%drakodungeons_rebirth_pos_#%
Rebirth count held by the player at position #
%drakodungeons_rebirth_pos_#_name%
Name of the player at rebirth position #
%drakodungeons_rebirth_pos_current%
Current viewer's position on the rebirth leaderboard
%drakodungeons_<currency>_pos_#%
Compact balance held at position # for that currency
%drakodungeons_<currency>_pos_#_name%
Name of the player at currency position #
%drakodungeons_<currency>_pos_current%
Current viewer's position for that currency
For example:
%drakodungeons_rebirth_pos_1%
%drakodungeons_rebirth_pos_1_name%
%drakodungeons_rebirth_pos_current%
%drakodungeons_souls_pos_1%
%drakodungeons_souls_pos_1_name%
%drakodungeons_souls_pos_current%The existing currency_ and balance_ prefixes are also accepted, so %drakodungeons_currency_souls_pos_1% and %drakodungeons_balance_souls_pos_1% are aliases for %drakodungeons_souls_pos_1%.
Only currencies with leaderboard: true support leaderboard placeholders. Missing positions and players not yet present in storage return 0; a missing _name entry returns an empty string. Rebirth ties are ordered by sword kills and then UUID. Currency ties are ordered by UUID.
Leaderboard data is loaded asynchronously and cached for 30 seconds. This keeps PlaceholderAPI lookups off the server thread. A first lookup made before its asynchronous load completes returns the same 0 or empty-string fallback and fills on a later PlaceholderAPI refresh.
Currency balances
%drakodungeons_currency_<id>%
Compact balance for the viewer
%drakodungeons_currency_<id>_raw%
Unabbreviated balance for the viewer
%drakodungeons_balance_<id>%, %drakodungeons_balance_<id>_raw%, %drakodungeons_<id>%, and %drakodungeons_<id>_raw% are supported aliases for configured currency IDs.
Sword
%drakodungeons_sword_level%
Sword level
%drakodungeons_sword_xp%
Compact current sword XP
%drakodungeons_sword_xp_raw%
Unabbreviated current sword XP
%drakodungeons_sword_xp_required%
Compact XP needed for the next level
%drakodungeons_sword_xp_required_raw%
Unabbreviated XP needed for the next level
%drakodungeons_sword_xp_percent%
Progress toward the next sword level
%drakodungeons_sword_damage%
Compact sword damage
%drakodungeons_sword_damage_raw%
Unabbreviated sword damage
%drakodungeons_sword_critical_chance%
Critical chance as a percentage number
%drakodungeons_sword_critical_damage%
Critical damage multiplier
%drakodungeons_sword_prestige%
Sword prestige count
%drakodungeons_sword_crystal_slots%
Available crystal slots
%drakodungeons_sword_attacks%
Compact lifetime sword attacks
%drakodungeons_sword_attacks_raw%
Unabbreviated lifetime sword attacks
%drakodungeons_sword_attack_rate%
Sword attacks per second, including /s
%drakodungeons_sword_attribute_level%
Combined sword attribute level
%drakodungeons_sword_kills%
Lifetime sword kills
Rebirth and progression
%drakodungeons_rebirth%
Viewer rebirth count
%drakodungeons_progression_zone%
Active or recommended zone ID
%drakodungeons_progression_stage%
Active or recommended stage number
%drakodungeons_progression_stage_id%
Active or recommended stage ID
%drakodungeons_progression_percent%
Overall completed-stage percentage
%drakodungeons_stage_progress%
Current stage completion percentage
%drakodungeons_stage_money_earned%
Compact Money earned for the current stage
%drakodungeons_stage_money_earned_raw%
Unabbreviated Money earned for the current stage
%drakodungeons_stage_money_required%
Compact Money required by the current stage
%drakodungeons_stage_money_required_raw%
Unabbreviated Money required by the current stage
%drakodungeons_stage_completed%
true when the current stage is complete
%drakodungeons_zone_unlocked%
true when the selected zone is unlocked
Active session
%drakodungeons_session_active%
Whether the viewer has an active dungeon session
%drakodungeons_session_zone%
Active zone ID
%drakodungeons_session_stage%
Active stage number
%drakodungeons_session_stage_id%
Active stage ID
%drakodungeons_session_area%
Active grinding area ID
%drakodungeons_session_grinding%
Whether automatic attacks are active
%drakodungeons_session_target%
Current target mob ID
%drakodungeons_session_target_health%
Compact current target health
%drakodungeons_session_target_health_raw%
Unabbreviated current target health
%drakodungeons_session_target_max_health%
Compact maximum target health
%drakodungeons_session_target_health_percent%
Current target health percentage