Creating Holograms
Holograms in MasuHolograms are floating displays made up of lines of text, items, heads, or entities. They exist purely as network packets: no real entities are created on the server (except the Taterzens NPC of a #PLAYER: line).
How Holograms Work
When you create a hologram, the server sends fake entity packets to nearby players. Each text line is an invisible armor stand with a custom name tag. Icon lines use an invisible armor stand with a mounted item entity. This means:
- No server-side entities - zero performance impact from entities
- Per-player rendering - each player can see different content (placeholders resolve per-viewer)
- No client mod needed - vanilla clients see holograms normally
Creating a Hologram
Stand at the desired location and run:
The hologram appears 1.5 blocks above your feet with a single "Blank Line" text line.
To create with initial content:
Hologram Structure
Hologram
├── Settings (name, position, facing, range, flags, permission)
├── Page 1
│ ├── Line 1 (text/icon/head/entity)
│ ├── Line 2
│ ├── Line 3
│ └── Click Actions (LEFT, RIGHT, SHIFT_LEFT, SHIFT_RIGHT)
├── Page 2
│ ├── Line 1
│ └── Click Actions
└── ...more pages
Every hologram has:
- A unique name (used in all commands)
- A position in the world (dimension + coordinates)
- One or more pages, each containing one or more lines
- Optional flags, permissions, and click actions
Hologram Data Files
Admin holograms are saved as JSON files in config/masuholograms/holograms/, shared by every world. Each hologram is one file:
Every save keeps the previous version as myHologram.json.bak. You can edit these files manually and run /mh reload to apply changes, but using commands is recommended. See Storage & Backups for lectern hologram storage, backups and the file format.
Line Stacking
Lines stack vertically from the hologram's position. The stacking direction is controlled by downOrigin:
Default (downOrigin = false)
Line 1 sits at the hologram position, additional lines stack downward (text lines shown; every line takes its own height, see Mixing Line Types):
Where the text appears
The position is the hologram's anchor, not where the letters are drawn: a text line shows like a name tag, about 2 blocks above its line position (other line types are placed to match). So /mh hologram create (anchor 1.5 blocks above your feet) shows the first line roughly 3 to 3.5 blocks above your feet, and /mh hologram move <name> <x> <y> <z> puts the first text line about 2 blocks above y.
Inverted (downOrigin = true)
The last line sits at the hologram position, lines stack upward:
Toggle with:
Positioning Tips
- Use
/mh hologram movehere <name>to quickly reposition - Use
/mh hologram center <name>to snap to block center (X.5, Z.5) - Use
/mh hologram align <name> Y <other>to match heights between holograms - Use
/mh line offsetxand/mh line offsetzto shift individual lines horizontally
Naming Rules
- Hologram names must be unique
- Names cannot contain spaces
- Names are case-insensitive (
Shopandshopare the same hologram); the case you used is kept for display and the file name - Names starting with
lectern_are reserved for lectern holograms - Use descriptive names like
spawn_welcome,shop_menu,rules_board