Skip to content

Troubleshooting

Common problems and where to look. For lectern holograms see also the Lectern Holograms troubleshooting.

A Hologram Does Not Show

  • Stand near it and run /mh near: it lists the holograms around you. /mh hologram info <name> shows its position, dimension, range and flags.
  • It may be disabled: /mh hologram enable <name>.
  • You may be out of its display range (48 blocks by default, /mh hologram setdisplayrange).
  • It or one of its lines may have a view permission you do not have (/mh hologram setpermission, /mh line setpermission). Without a permissions mod only operators pass these.
  • Text appears about 2 blocks above the hologram's position (see Creating Holograms): look up.
  • A line that failed while rendering is turned off until /mh reload, with one error in the server log; /mh stats counts these lines.

A Hologram Did Not Load

  • The server log names every file that could not be read. A file with a JSON error is skipped, or loaded from its .bak when that one is readable; see Storage & Backups.
  • Two files holding the same hologram name: only one is loaded and the log names both.
  • A hologram in a dimension that does not exist on this server is not loaded.

Clicks Do Nothing

  • The page needs actions: /mh page actions <hologram> <page> lists them.
  • Stand within clickRange (6 blocks by default) and aim at the text, not below it.
  • Clicks closer together than clickCooldownTicks (5 ticks) count once.
  • The DISABLE_ACTIONS flag on the hologram turns all clicks off.
  • An action chain stops at the first action that fails, such as a PERMISSION check. See Click Actions.

My Edits to a File Do Not Show

  • Run /mh reload after editing files by hand.
  • A config.json or lang.json with a JSON error is ignored (the defaults are used) and the error is logged; your file is left as it is.
  • A hologram changed in game during the last second is written first and wins over your edit. Make no changes in game between editing the file and reloading.
  • /mh reload is refused while a hologram could not be saved (for example a full disk); the server log says which.

Text Looks Wrong

  • Spaces are gone: Minecraft collapses repeated and trailing spaces in commands typed in game. Use the server console or edit the hologram file for text that needs them.
  • &l or other codes show as text in an animation: wave and burn color every character, so codes inside them do not work. See Colors and Formatting.
  • Bold does not work: a color code clears the formatting before it, so write the color first (&6&l). Gradient and rainbow text cannot be bold. See Colors & Formatting.
  • A placeholder shows as text: check its spelling and that the hologram or line has no DISABLE_PLACEHOLDERS flag. Vault Hunters placeholders need Vault Hunters installed.