HeroHolograms

# HeroHolograms A modern, lightweight Minecraft plugin built for Paper (26.1+) that leverages the latest `TextDisplay`, `ItemDisplay`, and `Interaction` entities to create stunning, lag-free holograms. Unlike older plugins that rely on invisible armor stands, HeroHolograms uses pure display entities for better performance and pixel-perfect scaling. It features full **MiniMessage** support, interactive clickable holograms, animated floating items, and a built-in migration tool for DecentHolograms! --- ## ✨ Features * **Modern Display Entities:** Zero armor stands. Uses optimized 26.1+ Text and Item displays. * **MiniMessage Formatting:** Full support for hex codes (`<#FF0000>`), gradients, and standard tags (``, ``). * **Clickable Actions:** Bind server commands to holograms so players can run them just by left/right-clicking. * **Floating Items:** Attach items or blocks to holograms, complete with an optional spinning animation. * **PlaceholderAPI Support:** Fully integrates with PAPI to display live stats (updates dynamically). * **DecentHolograms Converter:** Instantly migrate your old DecentHolograms configurations with a single command, automatically translating legacy `&` colors to MiniMessage tags. --- ## 🔒 Permissions HeroHolograms keeps it simple. There is only **one** permission node required to use the plugin. * `heroholograms.admin` * **Description:** Grants full access to all `/holo` commands. * **Default:** Op only. --- ## 🛠️ Commands & Usage All commands start with `/holo`. To view the help menu in-game, simply type `/holo`. ### 1. Management Commands * `/holo create ` - Creates a new hologram at your exact eye level. * `/holo delete ` - Permanently removes a hologram. * `/holo list` - Lists the IDs of all active holograms on the server. * `/holo tp ` - Teleports you directly to a specific hologram. * `/holo movehere ` - Snaps an existing hologram to your current eye-level location. ### 2. Line Editing Commands * `/holo addline ` - Adds a new line of text to the bottom of the hologram. * `/holo setline ` - Overwrites an existing line with new text. * `/holo removeline ` - Deletes a specific line and shifts the rest up. * `/holo swaplines ` - Swaps the position of two lines. ### 3. Display & Interactivity * `/holo setscale ` - Changes the physical size of the text/items. Default is `1.0`. * `/holo setclick ` - Forces a player to run a command when they click the hologram. Do not include the `/` in the command. (e.g., `/holo setclick spawn_npc spawn`) * `/holo setitem hand/clear [line#] [animated true/false]` - Displays the item you are currently holding in your main hand within the hologram. --- ## 🔄 Migrating from DecentHolograms If you are switching to HeroHolograms from DecentHolograms, you do not need to manually recreate all your text displays! 1. Ensure your `plugins/DecentHolograms/holograms/` folder still exists on the server. 2. Run the command: `/holo dh convert` 3. HeroHolograms will automatically scan the folder, grab the coordinates, and rebuild them. 4. **Color Translation:** The plugin will instantly find legacy color codes (like `&a`, `&l`, `&#FF0000`) and convert them perfectly into MiniMessage format (``, ``, `<#FF0000>`).