Description
MasuHolograms is a server-side hologram mod for Minecraft Forge 1.18.2. Create floating text, items, player heads, entities and player NPCs that players see with a plain vanilla client: no client mod required.
Holograms are drawn with fake entities sent through packets, so they cost the server almost nothing and never touch your world. #PLAYER NPC lines use the optional Taterzens mod for real NPCs with skins.
Full documentation: MasuHolograms Wiki (commands, line types, colors, animations, placeholders, click actions, configuration, developer API and ready-to-paste recipes).
Features
- Fully server-side: players join with a vanilla client
- Line types: text, items (
#ICON:, with NBT), player heads (#HEAD:,#SMALLHEAD:), entities (#ENTITY:) and player NPCs (#PLAYER:, with Taterzens) - Multi-page holograms: every player browses their own page with clicks
- Click actions: messages, player and console commands, teleports, sounds, permission gates and page navigation
- Placeholders: player and server values (
{player},{online},{tps}…), page numbers, Vault Hunters stats and leaderboards, and your own through the API - Colors:
&codes, hex colors, gradients and rainbow text - File-based animations: typewriter, wave, burn, scroll, color cycling and frames, all editable JSON
- Lectern holograms: players write a Hologram Book, put it on a lectern and get their own hologram (safe text only, per-player limits, stored per world)
- Damage and healing popups
- Crash-safe storage: atomic saves with a
.bakof the previous version - Developer API and Forge events for other mods
Requirements
- Minecraft 1.18.2, Forge 40.x (built against 40.3.11), Java 17
- Install on the server only (also works in singleplayer)
Optional:
- Taterzens 1.9.6 to 1.9.x for
#PLAYER:NPC lines - Vault Hunters (any version) for the Vault Hunters placeholders and leaderboards
- LuckPerms or another Forge permissions mod to grant view permissions,
PERMISSIONactions and lectern limits to players who are not operators
Quick Start
/mh hologram create welcome &6Welcome to the Server!
/mh line add welcome 1 &7Online: &a{online}&7/&a{max_players}
/mh line add welcome 1 #ICON:DIAMOND
/mh page add welcome &bThis is page 2!
/mh page addaction welcome 1 RIGHT NEXT_PAGE
/mh page addaction welcome 2 RIGHT NEXT_PAGE
This creates a hologram named welcome above you with a live player count, a floating diamond and a second page you reach by right-clicking. Page, line and action numbers start at 1. More in the Quick Start Guide and the Examples & Recipes.
Commands
Root command /masuholograms, aliases /mh and /holo.
/mh hologram,/mh line,/mh page: create, edit and configure holograms, lines, pages and click actions (op level 2)/mh list,/mh near [radius],/mh stats,/mh reload: find holograms, see the mod's cost, reload files (op level 2)/mh feature: turn the lectern, damage and healing features on or off (op level 2)/mh getbook,/mh editbook,/mh guide: the Hologram Book for lectern holograms (everyone)
Upgrading to 1.3.0
1.3.0 is a big stability and safety update and loads your existing hologram files unchanged. Lectern holograms move into the world folder (imported once, old files kept as .migrated), and icons, heads and entities now stack in line order, so older holograms with such lines may sit higher. Read Upgrading to 1.3.0 before you replace the jar, especially if you reset your world at the same time.
Support
Questions, bug reports and suggestions: join the Discord. Common problems are covered in Troubleshooting.
Originally inspired by DecentHolograms (Bukkit), rebuilt from the ground up for Forge.



