Skip to content

Installation

Requirements

Requirement Version
Minecraft 1.18.2
Forge 40.3.x or higher
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

  1. Download the latest masuholograms-x.x.x.jar from the releases page
  2. Place the JAR file in your server's mods/ folder
  3. Start (or restart) your server
  4. 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                   # Customizable messages
├── lectern-tracker.json        # Lectern hologram positions
├── animations/                 # Animation JSON files
│   ├── typewriter.json
│   ├── wave.json
│   ├── burn.json
│   ├── scroll.json
│   ├── colors.json
│   └── example_frames.json
└── holograms/                  # Hologram data files
    ├── my_hologram.json
    └── players/                # Player-created holograms
        └── Steve/
            └── lectern_Steve_100_65_200.json

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.

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.

LuckPerms

If LuckPerms is installed, MasuHolograms integrates with it for:

  • Hologram/line visibility permissions — show or hide holograms based on permission nodes
  • Lectern hologram limits — control how many holograms each player can create
  • Command permissions — fine-grained access control for admin commands

Without LuckPerms, permission checks fall back to operator status (op level 2).

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 holograms (empty on first install).