Skip to content

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 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}
/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 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:

{
  "allowPlaceholdersInsideAnimations": true
}

Then:

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

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