Description
# 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) and NeoForge (1.21.1).
For full details, see the [Wiki](https://github.com/EliteScouter/EliteHolograms/wiki).
## New in this release
* **MiniMessage & Gradients** – Full Kyori MiniMessage support means you can use gradients, hex colors, and advanced formatting in every hologram line.
* **Item Holograms** – `/eh createitem ` spawns a floating item (armor stand head) above the caption, ideal for shops or showcases.
* **Animated Lines** – `/eh animateline ` rotates text automatically for countdowns, tips, etc.
* **Scoreboard Reliability** – Scoreboard holograms no longer duplicate entries on restart; they reload clean data each time and store configs under `config/eliteholograms/scoreboard_holograms.json`.
## Key Features
* **Persistent Holograms** – Survive restarts with synchronous saves on shutdown.
* **Easy Commands + Tab Completion** – Intuitive syntax with Brigadier suggestions everywhere.
* **Multi-Line Management** – Add, insert, remove, and set text lines (including MiniMessage formatting).
* **Position Control** – Create at your location, teleport to holograms, and adjust vertically (`/eh movevertical`).
* **Item & Scoreboard Holograms** – Display floating items or top-player leaderboards with customizable update intervals.
* **Animated Text** – Per-line animation support for rotating messages.
* **Advanced Permissions** – Works with **LuckPerms** and **FTB Ranks**, OP level 2 fallback, granular nodes like `eliteholograms.create`, `eliteholograms.edit`, etc.
* **Built-in Placeholder System** – Real-time server/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, NeoForge 1.21.1 (client not required for players).
## Quick Command Reference
* `/eh create `
* `/eh createitem `
* `/eh addline|setline|insertline|removeline ...`
* `/eh animateline `
* `/eh movehere `, `/eh teleport `
* `/eh movevertical ` (e.g., `up 1.5`)
* `/eh createscoreboard [topCount] [updateInterval]`
* `/eh list`, `/eh near [page]`, `/eh info `, `/eh delete `, `/eh reload`
## Placeholder Highlights
### 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 addline motd Welcome %player%! Your rank is %player_rank%.`
## Permissions Overview
* Integrates with **LuckPerms** & **FTB Ranks**; OP fallback.
* Key nodes: `eliteholograms.create`, `eliteholograms.delete`, `eliteholograms.edit`, `eliteholograms.list`, `eliteholograms.info`, `eliteholograms.near`, `eliteholograms.teleport`, `eliteholograms.admin`.
* See the [Permissions Guide](https://github.com/EliteScouter/EliteHolograms/blob/main/PERMISSIONS.md) for setup.
_Screenshot:_


Designed for Forge 1.19.2 / 1.20.1 and NeoForge 1.21.1.