Skip to content

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:

/mh hologram create myHologram

The hologram appears 1.5 blocks above your feet with a single "Blank Line" text line.

To create with initial content:

/mh hologram create myHologram &6Welcome!

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:

config/masuholograms/holograms/myHologram.json

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):

Line 1  ← hologram position (Y)
Line 2  ← Y - 0.3
Line 3  ← Y - 0.6

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:

Line 1  ← Y + 0.6
Line 2  ← Y + 0.3
Line 3  ← hologram position (Y)

Toggle with:

/mh hologram downorigin myHologram true

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 offsetx and /mh line offsetz to shift individual lines horizontally

Naming Rules

  • Hologram names must be unique
  • Names cannot contain spaces
  • Names are case-insensitive (Shop and shop are 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