Skip to content

Hologram Flags

Flags modify how a hologram or individual line behaves. They can be set at the hologram level (affects all lines) or on specific lines. DISABLE_UPDATING and DISABLE_ACTIONS only work on the hologram, and /mh line addflag refuses them.

Available Flags

Flag Effect
DISABLE_PLACEHOLDERS Prevents {...} placeholder resolution. Text like {player} shows literally.
DISABLE_UPDATING Stops the periodic refresh. Placeholders keep the values they had when the player started seeing the hologram and line permissions are not re-checked; animations keep running.
DISABLE_ANIMATIONS Prevents {#ANIM:...} and &u animation processing. Animation syntax shows literally.
DISABLE_ACTIONS Prevents click actions from executing. Clicks are silently ignored.

Setting Flags

On a Hologram

/mh hologram addflag myHolo DISABLE_PLACEHOLDERS
/mh hologram removeflag myHolo DISABLE_PLACEHOLDERS

Hologram-level flags affect all lines on all pages.

On a Line

/mh line addflag myHolo 1 1 DISABLE_ANIMATIONS
/mh line removeflag myHolo 1 1 DISABLE_ANIMATIONS

Line-level flags only affect that specific line. Only DISABLE_PLACEHOLDERS and DISABLE_ANIMATIONS can be set on a line; /mh line addflag refuses the other two and names the hologram command instead. A line that carries one of them from an older file ignores it, and /mh line removeflag still removes it.

In a hologram file, flag names are matched exactly as listed above. An unknown name (a typo, lower case, or a flag from a newer version) is kept in the file and does nothing; the server log names it when the hologram loads. See Storage & Backups.

Use Cases

Static Holograms

If a hologram has no placeholders that need to change, add DISABLE_UPDATING to skip the placeholder refresh. Lines without placeholders, animations or a line permission are never refreshed anyway, so this only matters for lines with placeholders.

/mh hologram addflag rules DISABLE_UPDATING

Display Literal Braces

If you need to show literal {text} in a hologram without it being interpreted as a placeholder:

/mh hologram addflag code_example DISABLE_PLACEHOLDERS

Prevent Interaction

Disable click actions on a hologram (e.g., temporarily):

/mh hologram addflag shop DISABLE_ACTIONS

Lectern Holograms

Player-created lectern holograms get DISABLE_PLACEHOLDERS and DISABLE_ANIMATIONS when they are created (config lecternHolograms.disablePlaceholders and disableAnimations, both true by default). Players cannot change this; the book text rules strip placeholder and animation syntax anyway.

Viewing Flags

Use /mh hologram info <name> to see which flags are active on a hologram.

Use /mh line info <holo> <page> <line> to see flags on a specific line.