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.

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

Holograms are saved as JSON files in config/masuholograms/holograms/. Each hologram is one file:

config/masuholograms/holograms/myHologram.json

You can edit these files manually and run /mh reload to apply changes, but using commands is recommended.

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:

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

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-sensitive
  • Use descriptive names like spawn_welcome, shop_menu, rules_board