Hologram Commands
All hologram management commands are under /mh hologram.
Creating & Deleting
create
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
Permanently deletes a hologram, its data file and the file's .bak backup. This cannot be undone.
clone
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:
rename
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 (
shoptoShop) is refused, because names are case-insensitive. - Lectern holograms are named after their lectern and cannot be renamed.
Moving & Positioning
movehere
Moves a hologram to your current position (Y + 1.5 blocks), in your current dimension.
move
Moves a hologram to exact coordinates.
Example:
center
Centers a hologram on the current block by setting X and Z to .5 coordinates. Useful for aligning holograms to block centers.
align
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:
teleport
Teleports you to the hologram's position.
Configuration
setfacing
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= West180= North270= East
downorigin
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
Sets the maximum distance (in blocks) at which players can see this hologram. Range: 1-256 (default: 48).
setupdaterange
Sets the maximum distance at which placeholders and animations update for this hologram. Range: 1-256 (default: 48).
setupdateinterval
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
Sets a permission required to see this hologram. Omit the permission argument to clear it.
Examples:
addflag / removeflag
Add or remove hologram flags. See Flags for all available flags.
Example:
Information
info
Displays all hologram settings in chat with clickable elements to edit each property. Unknown flag names from the file are listed separately.
near
The same as /mh near: lists the holograms near you, nearest first.
Visibility
enable / disable
Enables or disables a hologram. Disabled holograms are invisible to all players but retain their data.
update
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.