Introduction

LiteHD is a feather-light Minecraft server plugin designed for Paper/Bukkit 1.20.1 and newer versions. It offers a straightforward way to create, manage, and personalize holographic displays, supporting both text and item visuals. Say goodbye to complex setups and hello to easy, beautiful holograms!


✨ Core Features

• Effortless Management: Create and manage holograms with simple, intuitive commands.
• Custom Line Heights: Precisely control the vertical spacing between each line of your hologram.
• Item Displays: Showcase Minecraft items directly within your holograms.
• PlaceholderAPI Ready: Dynamically display server or player information using PlaceholderAPI placeholders (toggleable in config).
• Live Refresh: Holograms automatically update their content, keeping placeholders current (refresh interval is configurable).
• Self-Healing: Automatically restores any hologram entities that might go missing.
• Clean & Tidy: No lingering hologram entities after server restarts or plugin removal. All holograms are reloaded from `data.yml`.
• Highly Configurable: Customize all settings and messages via easy-to-edit configuration files.
• Full Color Support: Use traditional `&` color codes and modern `#RRGGBB` hex color codes for vibrant text.
• Modern Technology: Utilizes Minecraft 1.20+'s Display Entities (TextDisplay and ItemDisplay) for optimal performance and appearance.
• Display Properties: Supports text alignment (e.g., centered) and shadow effects.
• Good View Distance: Holograms are visible from up to 48 blocks away by default.

Getting Started: Installation

1. Download the latest `LiteHD.jar` file.
2. Place the `LiteHD.jar` file into your server's `plugins` folder.
3. Restart your server or load the plugin using a plugin manager.
4. Use `/lhd help` in-game to see available commands.

Commands

All commands require the `litehd.use` permission (OPs have this by default).



Permissions



Customizing Your Holograms

All hologram content, including lines, items, and line heights, is managed within the `data.yml` file located in your `/plugins/LiteHD/` folder. After making changes to `data.yml`, use ` /lhd reload` to apply them.

Defining Hologram Structure (in `data.yml`)
Here's the basic format for a hologram in `data.yml`:
Custom Line Heights
You can add a `height: <value>` line to control the spacing *above* the line it's defined for (or, effectively, the space below the *previous* line).

• Default height for a text line (if `height` is not specified for the line below it): `0.3`
• Default height for an item line (if `height` is not specified for the line below it): `0.5`

Example:
Displaying Items
To show an item, use the format `ICON: MINECRAFT_ITEM_ID` on a line in your `data.yml`.

• Use valid Minecraft Item IDs (e.g., `DIAMOND`, `CHEST`, `ENCHANTED_BOOK`).
• If an invalid item ID is provided, a STONE block will be displayed as a fallback.

Example:
Using Color Codes
LiteHD supports both classic and modern color codes:

• **Classic `&` codes:** `&a` (green), `&c` (red), `&l` (bold), etc.
• **Hex `#RRGGBB` codes:** `#FF0000` (red), `#00FF00` (green), `#3498DB` (a nice blue), etc.

Example:
PlaceholderAPI Integration
If you have PlaceholderAPI installed and `placeholder-support` is enabled in `config.yml`, you can use any PAPI placeholders in your hologram text.
Example:

Configuration Files
All configuration files are located in the `/plugins/LiteHD/` folder.

1. `config.yml`
Main plugin settings.
2. `message.yml`
Customize plugin messages, like command feedback and error messages.
Example Snippet:
3. `debugmessage.yml`
Customize messages shown when `debug: true` is set in `config.yml`.
Example Snippet:
4. `data.yml`
This is where all your hologram data (locations, lines, items, heights) is stored.
Refer to the " Customizing Your Holograms" section above for detailed examples and format. Remember to use ` /lhd reload` after editing this file.


Dependencies

• **Required:** PaperMC (or a Paper fork like Pufferfish, Purpur) / Spigot (Bukkit) server software, version **1.20.1 or newer**. This is crucial as LiteHD uses Display Entities introduced in Minecraft 1.19.4 and heavily utilized from 1.20 onwards.
• **Optional:** PlaceholderAPI - Required if you want to use placeholders like `%player_name%` in your holograms. Can be disabled in `config.yml`.

Important Notes & Technical Tidbits

• Hologram entities are designed to be temporary in-game; their definitions are always loaded from `data.yml` on server start or plugin reload.
• If you remove the LiteHD plugin, all its hologram entities will be cleanly removed from the world, leaving no residue.
• Always use `/lhd reload` after making manual changes to `data.yml` or other configuration files to see your changes live.
• Holograms automatically refresh to update PAPI placeholders. The refresh speed is configurable in `config.yml`.
• The plugin includes a system to detect and restore any lost hologram entities, ensuring they remain visible.
• LiteHD leverages Minecraft's modern Display Entities (specifically `TextDisplay` and `ItemDisplay`) for efficient and visually appealing holograms.