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

{name}              Simple placeholder
{name:argument}     Placeholder with argument

Placeholders are resolved every updateInterval ticks (default: 20 = every second).

Player Placeholders

Placeholder	Description	Example Output
`{player}`	Player's username	`Steve`
`{displayname}`	Player's display name (may include colors)	`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}

/mh line add info 1 &8Page {page} of {pages}

Disabling Placeholders

Per Hologram

/mh hologram addflag myHolo DISABLE_PLACEHOLDERS

Per Line

/mh line addflag myHolo 1 1 DISABLE_PLACEHOLDERS

When placeholders are disabled, text like {player} displays literally as {player}.

Placeholders Inside Animations

By default, placeholders inside animation tags are not resolved. To enable this:

In config.json:

{
  "allowPlaceholdersInsideAnimations": true
}

Then:

{#ANIM:typewriter}Welcome {player}!{/#ANIM}

Will type out "Welcome Steve!" instead of "Welcome {player}!".