Installation
Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.18.2 |
| Forge | 40.x (built against 40.3.11) |
| Java | 17 |
MasuHolograms is server-side only. Players connecting to your server do not need any client mod installed - holograms are rendered entirely through network packets.
Installing the Mod
- Download the latest
masuholograms-x.x.x.jarfrom the releases page - Place the JAR file in your server's
mods/folder - Start (or restart) your server
- The mod will generate its configuration files in
config/masuholograms/
Directory Structure
After first startup, the following files and folders are created:
config/masuholograms/
├── config.json # Main configuration
├── lang.json # Player-facing messages
├── animations/ # Animation JSON files
│ ├── typewriter.json
│ ├── wave.json
│ ├── burn.json
│ ├── scroll.json
│ ├── colors.json
│ └── example_frames.json
└── holograms/ # Admin holograms (global, survive world resets)
└── my_hologram.json
<world>/masuholograms/ # Lectern (player) holograms of this world
├── lectern-tracker.json
└── players/<owner uuid>/lectern_Steve_100_65_200.json
Every save keeps the previous file as .bak. See Storage & Backups for details and for upgrading lectern holograms from before 1.3.0.
Optional Dependencies
Taterzens
If Taterzens is installed, #PLAYER: lines become available. Taterzens creates real server-side NPCs and handles player skin fetching automatically. Without it, PLAYER lines are silently invisible; all other line types work normally.
MasuHolograms needs Taterzens 1.9.6 to 1.9.x; Forge refuses to start with another installed Taterzens version.
Vault Hunters
If Vault Hunters (the_vault) is installed, MasuHolograms automatically detects it and registers Vault Hunters placeholders (levels, stats, reputation, bounties, leaderboards). No additional configuration is needed, and any Vault Hunters version can start with it; see Vault Hunters Placeholders for what happens when a placeholder does not match your version.
LuckPerms
If LuckPerms (or another Forge permissions mod) is installed, MasuHolograms uses it for:
- Hologram/line visibility permissions - show or hide holograms based on permission nodes
PERMISSIONclick actions - gate actions behind a permission- Lectern hologram limits - control how many holograms each player can create
- Lectern player commands - deny
getbook,editbook,guideor placing books
Admin commands always need op level 2. Without a permissions mod, hologram/line permissions, PERMISSION actions and limit nodes are granted to operators (op level 2) only; see Permissions.
Verifying Installation
After starting the server, run /mh version to confirm the mod is loaded. You should see the mod name and version number.
Run /mh list to see all loaded admin holograms (empty on first install).