Skip to content

Utility Commands

General-purpose commands that don't fit into other categories. All of them except getbook, editbook and guide need op level 2.

help

/mh help

Lists the most used commands; click one to put it in your chat box.

near

/mh near [radius]

Lists the holograms in your dimension within radius blocks of you (default 16, maximum 256), nearest first, with their distance. At most 15 are listed; a smaller radius narrows it down.

  • Hover a name for its position, page count, whether it is disabled and, for a lectern hologram, its owner.
  • Click a name for /mh hologram info, or [TP] to teleport to it.

/mh hologram near [radius] does the same.

stats

/mh stats

Shows what the mod holds and what it costs:

  • Holograms (and how many are enabled), pages, lines, and lines disabled after an error (see the server log for those)
  • Viewers, viewer re-shows and active damage/healing popups
  • The click index size and how often it was rebuilt
  • Live #PLAYER NPCs and saved NPC copies discarded at chunk load
  • The mod's average and maximum work per server tick (in microseconds) and the hologram packets sent, over the last 200 ticks

reload

/mh reload

Reloads everything from disk:

  • config.json - main configuration
  • lang.json - player messages
  • Animation files - all JSON files in config/masuholograms/animations/
  • Hologram data - all hologram files (admin holograms and this world's lectern holograms)
  • Features - each feature is turned on or off as config.json says, undoing /mh feature enable/disable

Changes made in game but not yet written are saved first. If those saves do not finish in time, the reload is aborted and nothing changes (the server log says why). Placeholders registered by other mods stay registered. After a reload, every viewer starts on page 1 again.

Use this after editing config files, animation files or hologram files by hand.

list

/mh list [page]

Lists all admin holograms with pagination (10 per page). Shows enabled status, name, dimension and coordinates; click an entry for its info.

plist

/mh plist [page]

Lists all lectern (player) holograms of the current world with pagination. Shows enabled status, name, owner, dimension and coordinates.

version

/mh version

Displays the mod name and version number.

getbook

/mh getbook

Gives you a Hologram Book, a special writable book that can be placed in lecterns to create player holograms. Refused while lectern holograms are disabled in config.json.

Permission: masuholograms.lectern.getbook (default: all players)

See Lectern Holograms for details.

editbook

/mh editbook

Turns the signed Hologram Book in your main hand back into an editable one, keeping its pages (as plain text with your & codes). Edit it and sign it again.

Permission: masuholograms.lectern.editbook (default: all players)

guide

/mh guide

Shows a guide explaining how to use lectern holograms, with a clickable /mh editbook. The text comes from the guide key of lang.json.

Permission: masuholograms.lectern.guide (default: all players)