Skip to content

Line Types

MasuHolograms supports six types of hologram lines. Each type is identified by a prefix in the line content.

Text Lines

The default line type. Any content without a special prefix becomes a text line.

/mh line add myHolo 1 &6Hello World
/mh line add myHolo 1 Welcome to the server
/mh line add myHolo 1 <RAINBOW>Rainbow Text</RAINBOW>

Default height: 0.3

Text lines support all color codes, placeholders, and animations.

Special Text Features

  • Empty text line (spacer): set the content to just a color code such as &r or &f (/mh line add without content adds the text "Blank Line")
  • Use {player} to show the viewer's name
  • Use animations for dynamic effects: {#ANIM:typewriter}text{/#ANIM}

Icon Lines

Display a floating item. Prefix with #ICON:.

/mh line add myHolo 1 #ICON:DIAMOND
/mh line add myHolo 1 #ICON:minecraft:diamond_sword
/mh line add myHolo 1 #ICON:GOLDEN_SWORD !ENCHANTED

Default height: 0.6

Item Formats

Format Example Description
Material name #ICON:DIAMOND Simple material lookup
Namespaced ID #ICON:minecraft:diamond_sword Full resource location
With enchant glint #ICON:DIAMOND_SWORD !ENCHANTED Adds enchantment shimmer
With NBT #ICON:mymod:gem{CustomModelData:3} NBT in {...} is applied to the item (SNBT, like /give)

Item names are case-insensitive and get minecraft: when they have no namespace.

  • An unknown item shows as a barrier and is named in a warning in the server log (once per reload). The line commands also warn in chat.
  • NBT that cannot be read is left off (the item shows without it), with a warning.

The item floats and rotates naturally (vanilla dropped item behavior).

Head Lines

Display a player head (skull). Prefix with #HEAD:.

/mh line add myHolo 1 #HEAD:Steve
/mh line add myHolo 1 #HEAD:Notch

Default height: 0.75

Head Formats

Format Example Description
Player name #HEAD:Steve Shows that player's skin (loaded by name from Mojang on the player's side)
Base64 texture #HEAD:eyJ0ZXh0dXJ... Direct texture value (from sites like minecraft-heads.com)

The mod automatically detects the format:

  • Short strings (32 characters or less, or containing a space) are treated as player names
  • Long strings (more than 32 characters without spaces) are treated as base64 texture values

Small Head Lines

Same as Head lines but rendered smaller. Prefix with #SMALLHEAD:.

/mh line add myHolo 1 #SMALLHEAD:Steve

Default height: 0.6

Uses a small armor stand, making the head about half the size of a normal head line.

Entity Lines

Display any Minecraft entity. Prefix with #ENTITY:.

/mh line add myHolo 1 #ENTITY:minecraft:pig
/mh line add myHolo 1 #ENTITY:ARMOR_STAND
/mh line add myHolo 1 #ENTITY:minecraft:zombie

Default height: 1.0

Entity Formats

Format Example Description
Namespaced (lowercase) #ENTITY:minecraft:pig Standard format
Short name (any case) #ENTITY:PIG Auto-prefixed with minecraft:

An entity id that does not exist shows nothing.

An entity stands at the bottom of its line's band (1.0 by default). For tall mobs, raise the line height (for example /mh line height myHolo 1 2 2.0 for a zombie) so the mob does not reach into the line above; see Mixing Line Types.

Entity Facing

Entities face the direction set by the hologram or line facing:

/mh hologram setfacing myHolo 180
/mh line setfacing myHolo 1 1 90
  • 0 = South, 90 = West, 180 = North, 270 = East
  • Line facing of -1 inherits the hologram facing

Entity Scaling

If entityScaleAttribute is configured in config.json, entity lines can be scaled:

/mh line setscale myHolo 1 1 2.0

This requires a mod that provides a size attribute (e.g., Vault Hunters provides the_vault:generic.size_scale).

Player Lines

Display a real NPC with a player skin. Prefix with #PLAYER:. Requires the Taterzens mod, version 1.9.6 to 1.9.x (Forge refuses to start with another installed version).

/mh line add myHolo 1 #PLAYER:Notch
/mh line add myHolo 1 #PLAYER:{vh_top_level_name:1}

Default height: 2.3

The NPC stands in its own band, like icons, heads and entities: its Taterzens name tag sits clear of the line above it.

Lines saved before 1.3.0

Player lines saved before 1.3.0 keep their old height of 2.0, so the NPC's name tag can touch the line above. Raise it with /mh line height <hologram> <page> <line> 2.3.

The player name supports static values and server-wide placeholders such as leaderboard names. Good examples:

Content Result
#PLAYER:Notch Notch's skin for everyone
#PLAYER:{vh_top_level_name:1} The current #1 Vault Hunters player

Do not use {player} in PLAYER lines

{player} resolves to a different name for each viewer, but the NPC is a single entity shared by everyone. It takes the name resolved for one viewer (the first player who saw it, then the next one when that player leaves) and everyone else sees that same NPC. Use {player} in text lines for per-viewer names instead.

Requires Taterzens

#PLAYER: lines delegate to the Taterzens mod for NPC creation and skin fetching. If Taterzens is not installed, PLAYER lines are silently invisible; all other line types continue to work normally. If the installed Taterzens does not match, the error is logged once and PLAYER lines stay off until restart.

Global NPC

Unlike other line types, a PLAYER line creates a real server-side NPC entity rather than per-player packets. This means:

  • All nearby players see the same NPC - one skin, one entity, visible to everyone nearby
  • The NPC is visible within Minecraft's entity tracking range (roughly 64 blocks) regardless of the hologram's displayRange setting
  • Skin is fetched automatically and asynchronously by Taterzens via Mojang's API
  • Per-viewer personalisation (e.g. showing each player their own skin) is not supported
  • The NPC is not saved with the world: it is spawned while the hologram is shown, and a copy left in saved chunk data is removed when its chunk loads
  • Clicking the NPC does not run the page's click actions

Forced Look

When enabled, the NPC continuously rotates to face the nearest player.

/mh line forcedlook myHolo 1 1 true
/mh line forcedlook myHolo 1 1 false

This uses Taterzens' built-in FORCED_LOOK movement mode. When disabled, the NPC stands still facing its spawn direction.

NPC Scaling

Player lines support the same scaling as entity lines when entityScaleAttribute is configured:

/mh line setscale myHolo 1 1 0.5

The scale is applied directly to the NPC as a server-side entity attribute (not a packet trick), so it affects all players who can see the NPC.

Line Type Summary

Prefix Type Height Rendering
(none) Text 0.3 Invisible marker armor stand with custom name
#ICON: Icon 0.6 Armor stand + item entity (passenger)
#HEAD: Head 0.75 Armor stand with helmet equipment
#SMALLHEAD: Small Head 0.6 Small armor stand with helmet
#ENTITY: Entity 1.0 Fake entity of specified type
#PLAYER: Player 2.3 Taterzens NPC with player skin (requires Taterzens)

Text, icon and head heights come from the default*Height keys of config.json; the values above are their defaults.

Mixing Line Types

Lines stack top-down in the order they are written, like in other hologram mods (bottom-up when the hologram's downOrigin is true). Every line takes a band of its own height:

  • A text line sits at the top of its band.
  • An icon, head, entity or player NPC stands at the bottom of its band, so its band height is the room it gets.

So an icon under a text line appears below that text, and the next line starts below the icon. To give a line more or less room, change its height with /mh line height; to shift it sideways, use /mh line offsetx and offsetz. A height of 0 makes the next line overlap this one.

Upgrading from 1.2.x

Before 1.3.0, icons, heads and entities were drawn at the line's position instead of at the bottom of their band. A hologram saved with 1.2.x that holds such lines (on their own or mixed with text) can therefore appear higher than before. Move the hologram down with /mh hologram move, or lower the line heights with /mh line height, until it sits where you want it.

Changing Line Types

You can change a line's type at any time by setting new content with a different prefix:

/mh line set myHolo 1 1 &6Text line
/mh line set myHolo 1 1 #ICON:EMERALD

If the line still had the old type's default height, it takes the new type's default height (for example 0.3 to 0.6 when a text line becomes an icon). A height you set yourself is kept.