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 statscounts 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
.bakwhen 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_ACTIONSflag on the hologram turns all clicks off. - An action chain stops at the first action that fails, such as a
PERMISSIONcheck. See Click Actions.
My Edits to a File Do Not Show
- Run
/mh reloadafter editing files by hand. - A
config.jsonorlang.jsonwith 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 reloadis 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.
&lor other codes show as text in an animation:waveandburncolor 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_PLACEHOLDERSflag. Vault Hunters placeholders need Vault Hunters installed.