Skip to content

Hologram Commands

All hologram management commands are under /mh hologram.

Creating & Deleting

create

/mh hologram create <name> [content]

Creates a new hologram at your current position. The hologram spawns 1.5 blocks above your feet.

Parameter Description Default
name Unique hologram name (no spaces, case-insensitive) Required
content First line content "Blank Line" (config defaultText)

Names starting with lectern_ are reserved for lectern holograms and refused. An #ICON: line naming an unknown item or unreadable NBT gets a warning in chat.

Examples:

/mh hologram create welcome
/mh hologram create shop &6Shop Menu
/mh hologram create info #ICON:BOOK

delete

/mh hologram delete <name>

Permanently deletes a hologram, its data file and the file's .bak backup. This cannot be undone.

clone

/mh hologram clone <name> <newName>

Creates a copy of an existing hologram at your current position, in your dimension (1.5 blocks above your feet; run from the console, the copy is placed at the original's position). Everything is copied: the hologram's settings (enabled state, facing, down origin, ranges, update interval, permission, flags), every page with its click actions, and every line with its own settings (height, offsets, facing, scale, forced look, permission, flags).

The new name must be free and must not start with lectern_.

Example:

/mh hologram clone welcome welcome_copy

rename

/mh hologram rename <name> <newName>

Renames a hologram. The data file is also renamed (the new file is written before the old one is deleted).

  • The new name must be free and must not start with lectern_.
  • A rename that only changes the case (shop to Shop) is refused, because names are case-insensitive.
  • Lectern holograms are named after their lectern and cannot be renamed.

Moving & Positioning

movehere

/mh hologram movehere <name>

Moves a hologram to your current position (Y + 1.5 blocks), in your current dimension.

move

/mh hologram move <name> <x> <y> <z>

Moves a hologram to exact coordinates.

Example:

/mh hologram move welcome 100.5 65.0 -200.5

center

/mh hologram center <name>

Centers a hologram on the current block by setting X and Z to .5 coordinates. Useful for aligning holograms to block centers.

align

/mh hologram align <name> <axis> <otherHologram>

Aligns one hologram's position to match another hologram on the specified axes. The axis argument is any combination of X, Y and Z.

Axis Effect
X Match X coordinate
Y Match Y coordinate
Z Match Z coordinate
XZ Match both X and Z
XYZ Match all coordinates

Example:

/mh hologram align shop_title XZ shop_items

teleport

/mh hologram teleport <name>

Teleports you to the hologram's position.

Configuration

setfacing

/mh hologram setfacing <name> <angle>

Sets the hologram's rotation angle in degrees. Only #ENTITY lines turn to face it (lines with their own facing keep it); text, icon, head and #PLAYER lines are not rotated.

  • 0 = South (default)
  • 90 = West
  • 180 = North
  • 270 = East

downorigin

/mh hologram downorigin <name> <true|false>

Controls how lines stack vertically.

Value Behavior
false (default) Line 1 at the top, lines stack downward
true Last line at the bottom (origin), lines stack upward

setdisplayrange

/mh hologram setdisplayrange <name> <range>

Sets the maximum distance (in blocks) at which players can see this hologram. Range: 1-256 (default: 48).

setupdaterange

/mh hologram setupdaterange <name> <range>

Sets the maximum distance at which placeholders and animations update for this hologram. Range: 1-256 (default: 48).

setupdateinterval

/mh hologram setupdateinterval <name> <interval>

Sets how often (in ticks) placeholders refresh. Range: 1-1200 (default: 20 = every second). A value below 1 in a hologram file is raised to 1 when it loads.

Lower values = more responsive but higher server load. 20 ticks (1 second) is a good balance.

setpermission

/mh hologram setpermission <name> [permission]

Sets a permission required to see this hologram. Omit the permission argument to clear it.

Examples:

/mh hologram setpermission vip_area my.server.vip
/mh hologram setpermission vip_area

addflag / removeflag

/mh hologram addflag <name> <flag>
/mh hologram removeflag <name> <flag>

Add or remove hologram flags. See Flags for all available flags.

Example:

/mh hologram addflag welcome DISABLE_PLACEHOLDERS

Information

info

/mh hologram info <name>

Displays all hologram settings in chat with clickable elements to edit each property. Unknown flag names from the file are listed separately.

near

/mh hologram near [radius]

The same as /mh near: lists the holograms near you, nearest first.

Visibility

enable / disable

/mh hologram enable <name>
/mh hologram disable <name>

Enables or disables a hologram. Disabled holograms are invisible to all players but retain their data.

update

/mh hologram update <name>

Forces a full re-render of the hologram: removes its entities from every viewer, and the next visibility check (within a second) shows it again, on page 1. Useful if a client shows a stale hologram.