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.
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 (offline players are resolved via the server's profile cache).
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- - If no data is available, returns
?
Leaderboard Caching
Leaderboard data is cached and refreshes every 30 seconds. This is to avoid expensive recalculations on every tick. The cache includes all players who have ever joined the server (not just online players).
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