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 (<red>, <bold>).
• 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 <id> <text> - Creates a new hologram at your exact eye level.
• /holo delete <id> - Permanently removes a hologram.
• /holo list - Lists the IDs of all active holograms on the server.
• /holo tp <id> - Teleports you directly to a specific hologram.
• /holo movehere <id> - Snaps an existing hologram to your current eye-level location.

2. Line Editing Commands

• /holo addline <id> <text> - Adds a new line of text to the bottom of the hologram.
• /holo setline <id> <line#> <text> - Overwrites an existing line with new text.
• /holo removeline <id> <line#> - Deletes a specific line and shifts the rest up.
• /holo swaplines <id> <line1> <line2> - Swaps the position of two lines.

3. Display & Interactivity

• /holo setscale <id> <size> - Changes the physical size of the text/items. Default is 1.0.
• /holo setclick <id> <cmd> - 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 <id> 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 (<green>, <bold>, <#FF0000>).