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
&ror&f(/mh line addwithout 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:.
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:.
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:
0= South,90= West,180= North,270= East- Line facing of
-1inherits the hologram facing
Entity Scaling
If entityScaleAttribute is configured in config.json, entity lines can be scaled:
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).
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
displayRangesetting - 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.
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:
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:
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.