Elite Holograms

# Elite Holograms **Elite Holograms** is a lightweight, server-side or single-player Minecraft mod for creating, managing, and customizing floating text (holograms). Perfect for server info, leaderboards, waypoints, dynamic stats, instructions, and decorative text. Inspired by Advanced Holograms. Supports Forge (1.19.2, 1.20.1), Fabric (1.20.1), and NeoForge (1.21.1, 26.1, 26.2). The Fabric build requires **Fabric API**. The Forge and NeoForge builds need nothing extra. For full details, see the [Wiki](https://github.com/EliteScouter/EliteHolograms/wiki). ## New in 1.2.0 * **Fabric 1.20.1 edition** – Elite Holograms now runs on Fabric with the same feature set as the Forge 1.20.1 build: holograms, fixed holograms, item holograms, animated lines, scoreboard leaderboards, themes, backlights, placeholders, and every command. It requires Fabric API, is server-side only, and reads the same hologram config format, so a world can move between the Forge and Fabric builds without converting anything. * **NeoForge 26.2 edition** – Full feature parity on Minecraft 26.2, built against NeoForge 26.2.0.57 on Java 25. * **Fixed Holograms** – Holograms can be anchored to a rotation instead of always turning to face the viewer. A *fixed* hologram reads like a sign hung on a wall and looks the same to everyone, which is what you want for anything mounted flat against a build. Add `fixed` to any create command, aim it with `/eh setrotation [pitch]`, or switch an existing one over with `/eh convert fixed`. Player-facing stays the default and nothing you already built changes. *Requires Minecraft 1.20.1 or newer, so it is not available on the Forge 1.19.2 build.* * **Centred backlights** – A hologram sitting near a block edge used to be lit noticeably off to one side, because light blocks can only occupy whole block cells. The light column now widens onto the neighbouring cell when needed, keeping the glow centred on the text. * **Fixed: hologram lines could show each other's text** – Different hologram entity types were handing out overlapping network IDs, which made the client apply one line's text to another. ## Also new since 1.0 * **Backlights** – `/eh backlight [height 1-10]` raises a column of full-bright `minecraft:light` blocks behind a hologram so it stays readable at night. Backlights follow the hologram when it moves, persist across restarts, and never overwrite player builds (only air and water cells are lit). * **Scoreboard Themes** – Restyle leaderboards with named themes. Ships with `default`, `ocean`, `blood`, `mono`, `gold`, and `rainbow`, all editable in `config/eliteholograms/scoreboard_themes.json`. Add your own to match your server brand. * **`/eh settheme `** – Re-skin an existing scoreboard instantly, no need to recreate it. Both arguments tab-complete. * **Live reload** – `/eh reload` refreshes scoreboard themes from disk without a server restart. * **Smarter tab completion** – The `` argument suggests every objective registered on the server, and `[theme]` suggests the available theme names. ## Key Features * **MiniMessage & Gradients** – Full Kyori MiniMessage support for gradients, hex colors, rainbows, and rich formatting on every line. Legacy `&` codes work too. * **Persistent Holograms** – Survive restarts with synchronous saves on shutdown. * **Easy Commands + Tab Completion** – Intuitive syntax with Brigadier suggestions for IDs, objectives, themes, and display types. * **Multi-Line Management** – Add, insert, remove, and set individual text lines. * **Item Holograms** – `/eh createitem ` spawns a floating item above the caption, ideal for shops and showcases. * **Scoreboard Leaderboards** – Display the top players from any objective with custom row counts, refresh intervals, and themes. Online and offline players are included, and time and number objectives are auto-formatted. * **Animated Lines** – `/eh animateline ` rotates text on a timer for countdowns, tips, and announcements. * **Backlights** – Light holograms at night without touching the surrounding build. * **Fixed Holograms** – Anchor a hologram to a rotation so it reads like a wall sign (1.20.1 and newer). * **Position Control** – Create at your location or at explicit coordinates, teleport to any hologram, and nudge vertically with `/eh movevertical`. * **Advanced Permissions** – Works with **LuckPerms** and **FTB Ranks**, with OP level 2 fallback and granular nodes. * **Built-in Placeholder System** – Real-time server and player stats without external APIs. * **Nearby Discovery** – `/eh near` shows holograms around you. * **Performance-Optimized** – Separate manager thread, graceful shutdown, minimal overhead. * **Cross-Platform & Server-Side Only** – Forge 1.19.2, Forge 1.20.1, Fabric 1.20.1, NeoForge 1.21.1, NeoForge 26.1, and NeoForge 26.2. Players join with a vanilla client, and the mod also works on its own in single-player. ## Quick Command Reference Every create command takes an optional `fixed` or `facing` keyword immediately after the subcommand. Leave it out and you get a player-facing hologram, which is the default. **Creating** * `/eh create ` – create a hologram at your location * `/eh createat [text...]` – create one at explicit coordinates * `/eh createitem ` – create one with a floating item on top * `/eh createscoreboard [topCount] [interval] [theme]` – create a leaderboard from a scoreboard objective **Lines** * `/eh addline`, `/eh setline`, `/eh insertline`, `/eh removeline` – manage individual lines * `/eh animateline ` – animate a line on a timer **Appearance** * `/eh settheme ` – restyle an existing scoreboard hologram * `/eh backlight [height 1-10]` – toggle a light column behind a hologram * `/eh convert fixed|face` – switch a hologram between fixed and player-facing * `/eh setrotation [pitch]` – aim a fixed hologram (yaw 0 south, 90 west, 180 north, 270 east) **Position** * `/eh movehere ` – move a hologram to you * `/eh movevertical ` – nudge it up or down, e.g. `up 1.5` * `/eh teleport ` – teleport to a hologram **Browsing and admin** * `/eh list`, `/eh near [page]`, `/eh info ` – browse and inspect holograms * `/eh delete ` – remove a hologram * `/eh reload` – reload holograms and themes from storage ## Placeholder Highlights No external API needed. Placeholders update in real time, including per-viewer player values. ### Server-Wide * `%players%`, `%maxplayers%`, `%tps%`, `%uptime%`, `%memory%`, `%server_time%` ### Player-Specific * `%player%`, `%player_rank%`, `%player_health%`, `%player_level%`, `%player_world%`, `%player_coords%`, `%player_gamemode%` *Example:* ``` /eh create welcome Welcome %player%! /eh addline welcome &7Your rank: &e%player_rank% /eh addline welcome &7Online: &a%players%&7/&a%maxplayers% TPS: &a%tps% ``` ## Permissions Overview * Integrates with **LuckPerms** and **FTB Ranks**, falling back to OP level 2 when neither is present. Console and command blocks always have full access. * Key nodes: `eliteholograms.create`, `eliteholograms.delete`, `eliteholograms.edit`, `eliteholograms.list`, `eliteholograms.info`, `eliteholograms.near`, `eliteholograms.teleport`, `eliteholograms.backlight`, `eliteholograms.admin`. * See the [Permissions Guide](https://github.com/EliteScouter/EliteHolograms/blob/main/PERMISSIONS.md) for group setups and examples. ## Installation 1. Download the build matching your loader and Minecraft version. 2. Drop the JAR into your `mods` folder. Your single-player instance, modpack, or server all work the same way. 3. **Fabric only:** also install Fabric API. The Fabric build will not load without it. 4. *(Optional)* Install LuckPerms or FTB Ranks for granular permissions on a server. 5. Launch the game or restart the server, then run `/eh create` to get started. *Screenshot:*   Designed for Forge 1.19.2 / 1.20.1, Fabric 1.20.1, and NeoForge 1.21.1 / 26.1 / 26.2.