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.,
:10but only 5 players), value returns0and 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