Skip to content

Vault Hunters Placeholders

When the Vault Hunters mod (the_vault) is installed alongside MasuHolograms, additional placeholders are automatically registered for VH player statistics and leaderboards.

Info

Vault Hunters integration is fully automatic. If the mod is present, placeholders are available. If it's not installed, these placeholders simply don't exist; no errors or configuration needed.

Version Compatibility

MasuHolograms starts with any Vault Hunters version; there is no version bound. The placeholders are written against current Vault Hunters releases. If one of them does not match the installed version (a class or method it needs is missing), that placeholder turns itself off until the next restart with one line in the server log, and its {token} shows as written. The other placeholders keep working. If the placeholders cannot be registered at all, that is logged once and holograms work without them.

Player Stat Placeholders

These placeholders show stats for the viewing player by default. Add a player name as an argument to look up another player's stats.

Vault Stats

Placeholder Description Example
{vh_level} Vault level (uncapped, can exceed 100) 142
{vh_exp} Current vault XP 85000

Skill Points

Placeholder Description Example
{vh_unspent_skill} Unspent skill points 3
{vh_unspent_knowledge} Unspent knowledge points 5
{vh_unspent_expertise} Unspent expertise points 2
{vh_spent_skill} Total spent skill points 45
{vh_spent_knowledge} Total spent knowledge points 30
{vh_spent_expertise} Total spent expertise points 15

God Reputation

Placeholder Description Range
{vh_rep_idona} Idona reputation 0-50
{vh_rep_tenos} Tenos reputation 0-50
{vh_rep_velara} Velara reputation 0-50
{vh_rep_wendarr} Wendarr reputation 0-50

Bounties

Placeholder Description Example
{vh_bounties} Total completed bounties 27

Looking Up Other Players

Add a player name as an argument to view another player's stats:

{vh_level:Steve}         Steve's vault level
{vh_rep_idona:Notch}     Notch's Idona reputation
{vh_bounties:Alex}       Alex's completed bounties

This works for both online and offline players. An offline player's name is looked up in the background (the server's profile cache, without blocking the server); until it is known the placeholder shows ?, and a name that cannot be found is tried again after 5 minutes.

Usage Examples

Personal stats board:

/mh line set vh_stats 1 1 &6Your Vault Stats
/mh line add vh_stats 1 &7Level: &a{vh_level}
/mh line add vh_stats 1 &7XP: &e{vh_exp}
/mh line add vh_stats 1 &7Unspent Skills: &b{vh_unspent_skill}
/mh line add vh_stats 1 &7Bounties: &d{vh_bounties}

Player comparison:

/mh line set compare 1 1 &6Steve's Stats
/mh line add compare 1 &7Level: &a{vh_level:Steve}
/mh line add compare 1 &7Bounties: &d{vh_bounties:Steve}

Leaderboard Placeholders

Leaderboard placeholders rank all players and let you display top N lists. Each stat has a value placeholder and a name placeholder.

Use :N to specify the rank (1 = first place, 2 = second, etc.).

Available Leaderboards

Value Placeholder Name Placeholder Ranked By
{vh_top_level:N} {vh_top_level_name:N} Vault level
{vh_top_exp:N} {vh_top_exp_name:N} Vault XP
{vh_top_bounties:N} {vh_top_bounties_name:N} Completed bounties
{vh_top_rep_idona:N} {vh_top_rep_idona_name:N} Idona reputation
{vh_top_rep_tenos:N} {vh_top_rep_tenos_name:N} Tenos reputation
{vh_top_rep_velara:N} {vh_top_rep_velara_name:N} Velara reputation
{vh_top_rep_wendarr:N} {vh_top_rep_wendarr_name:N} Wendarr reputation

Replace N with the rank number: :1 for first, :2 for second, etc.

Return Values

  • Value placeholder returns the stat value as a number (e.g., 142)
  • Name placeholder returns the player's name (e.g., Steve)
  • If the rank doesn't exist (e.g., :10 but only 5 players), value returns 0 and name returns -
  • A rank that is not a number (for example {vh_top_level:abc}) returns ?
  • A player who is offline and not in the server's profile cache is shown by the first 8 characters of their UUID

Leaderboard Caching

Leaderboard data is cached and refreshes every 30 seconds. This is to avoid expensive recalculations on every tick. The cache includes every player Vault Hunters has data for (not just online players) whose value is above 0.

Example: Top 5 Vault Level Leaderboard

/mh hologram create vh_leaderboard

/mh line set vh_leaderboard 1 1 &6&l=== Top Vault Levels ===
/mh line add vh_leaderboard 1 &e1. &f{vh_top_level_name:1} &7- Level &a{vh_top_level:1}
/mh line add vh_leaderboard 1 &e2. &f{vh_top_level_name:2} &7- Level &a{vh_top_level:2}
/mh line add vh_leaderboard 1 &e3. &f{vh_top_level_name:3} &7- Level &a{vh_top_level:3}
/mh line add vh_leaderboard 1 &e4. &f{vh_top_level_name:4} &7- Level &a{vh_top_level:4}
/mh line add vh_leaderboard 1 &e5. &f{vh_top_level_name:5} &7- Level &a{vh_top_level:5}

Example: Top 3 Bounty Hunters

/mh hologram create bounty_board

/mh line set bounty_board 1 1 &d&l=== Bounty Hunters ===
/mh line add bounty_board 1 &6[p] &f{vh_top_bounties_name:1} &7- &d{vh_top_bounties:1} bounties
/mh line add bounty_board 1 &6[p] &f{vh_top_bounties_name:2} &7- &d{vh_top_bounties:2} bounties
/mh line add bounty_board 1 &6[p] &f{vh_top_bounties_name:3} &7- &d{vh_top_bounties:3} bounties

Example: God Reputation Rankings

/mh hologram create rep_board

/mh line set rep_board 1 1 &6&l=== Idona's Champions ===
/mh line add rep_board 1 &e1. &f{vh_top_rep_idona_name:1} &7- &c{vh_top_rep_idona:1} rep
/mh line add rep_board 1 &e2. &f{vh_top_rep_idona_name:2} &7- &c{vh_top_rep_idona:2} rep
/mh line add rep_board 1 &e3. &f{vh_top_rep_idona_name:3} &7- &c{vh_top_rep_idona:3} rep

Multi-Page VH Leaderboard

Create a multi-page leaderboard with different stats on each page:

# Page 1 - Vault Levels
/mh hologram create vh_board
/mh line set vh_board 1 1 &6&l=== Vault Levels ===
/mh line add vh_board 1 &e1. &f{vh_top_level_name:1} &7- &a{vh_top_level:1}
/mh line add vh_board 1 &e2. &f{vh_top_level_name:2} &7- &a{vh_top_level:2}
/mh line add vh_board 1 &e3. &f{vh_top_level_name:3} &7- &a{vh_top_level:3}
/mh line add vh_board 1 &8Page {page}/{pages} - Right click for next

# Page 2 - Bounties
/mh page add vh_board &d&l=== Bounty Hunters ===
/mh line add vh_board 2 &e1. &f{vh_top_bounties_name:1} &7- &d{vh_top_bounties:1}
/mh line add vh_board 2 &e2. &f{vh_top_bounties_name:2} &7- &d{vh_top_bounties:2}
/mh line add vh_board 2 &e3. &f{vh_top_bounties_name:3} &7- &d{vh_top_bounties:3}
/mh line add vh_board 2 &8Page {page}/{pages} - Right click for next

# Page 3 - Reputation
/mh page add vh_board &c&l=== Idona's Favorites ===
/mh line add vh_board 3 &e1. &f{vh_top_rep_idona_name:1} &7- &c{vh_top_rep_idona:1}
/mh line add vh_board 3 &e2. &f{vh_top_rep_idona_name:2} &7- &c{vh_top_rep_idona:2}
/mh line add vh_board 3 &e3. &f{vh_top_rep_idona_name:3} &7- &c{vh_top_rep_idona:3}
/mh line add vh_board 3 &8Page {page}/{pages} - Right click for next

# Navigation
/mh page addaction vh_board 1 RIGHT NEXT_PAGE
/mh page addaction vh_board 1 LEFT PREV_PAGE
/mh page addaction vh_board 2 RIGHT NEXT_PAGE
/mh page addaction vh_board 2 LEFT PREV_PAGE
/mh page addaction vh_board 3 RIGHT NEXT_PAGE
/mh page addaction vh_board 3 LEFT PREV_PAGE