Built-in Placeholders
Placeholders are dynamic text values that resolve per-player and update automatically. They use the {name} syntax inside hologram lines.
Placeholder Syntax
Placeholders are resolved when a player starts seeing the hologram and then every updateInterval ticks (default: 20 = every second), for viewers within the hologram's update range.
- A placeholder name that is not registered stays in the text as written.
- A placeholder that throws an error keeps its token in the text; the error is logged once per placeholder.
- Decimal numbers always use a dot (
18.5), whatever the server's locale.
Player Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
{player} |
Player's username | Steve |
{displayname} |
Player's display name, as plain text | Steve |
{x} |
Player X coordinate (1 decimal) | 123.4 |
{y} |
Player Y coordinate (1 decimal) | 64.0 |
{z} |
Player Z coordinate (1 decimal) | -200.1 |
{health} |
Current health (1 decimal) | 18.5 |
{max_health} |
Maximum health (1 decimal) | 20.0 |
{food} |
Hunger level (0-20) | 20 |
{level} |
XP level | 42 |
{ping} |
Latency in milliseconds | 45 |
Server Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
{online} |
Current online player count | 5 |
{max_players} |
Maximum player slots | 20 |
{tps} |
Server TPS (1 decimal, max 20.0) | 19.8 |
{world} |
Viewer's current dimension | minecraft:overworld |
Page Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
{page} |
Viewer's current page (1-indexed) | 1 |
{pages} |
Total page count | 3 |
Info
Page placeholders are special - they resolve based on which page each viewer is currently seeing. Player A on page 1 sees "Page 1/3" while Player B on page 2 sees "Page 2/3" at the same time.
Per-Player Resolution
All placeholders resolve individually for each viewer. This means:
{player}shows each viewer their own name{health}shows each viewer their own health{ping}shows each viewer their own latency
This makes it possible to create personalized holograms that show different information to each player.
Usage Examples
Welcome Board
/mh line set welcome 1 1 &6Welcome, {player}!
/mh line add welcome 1 &7Health: &c{health}&7/&c{max_health}
/mh line add welcome 1 &7Level: &a{level}
/mh line add welcome 1 &7Ping: &e{ping}ms
Server Status
/mh line set status 1 1 &6Server Status
/mh line add status 1 &7Players: &a{online}&7/&a{max_players}
/mh line add status 1 &7TPS: &a{tps}
/mh line add status 1 &7Your World: &b{world}
Page Navigation
Disabling Placeholders
Per Hologram
Per Line
When placeholders are disabled, text like {player} displays literally as {player}.
Placeholders Inside Animations
By default the animation runs on the raw text and placeholders are resolved in each frame afterwards, so a placeholder only works when the animation keeps it whole (colors, frames): typewriter shows half-typed tokens, and wave and burn break them apart. To resolve placeholders before animating:
In config.json:
Then:
Will type out "Welcome Steve!" instead of "Welcome {player}!".