EZ Hologram

EZ Holograms Plugin

A powerful and user friendly Minecraft plugin for creating, managing, customizing, and animating holograms in your server.

Features

- Easy to use graphical interface for hologram creation and management - Support for multiple text lines and advanced formatting - Item display functionality (including in animations) - Animation management: cycle through text and/or items with configurable speed - Animation management: - Hologram movement and copying - Animation management: rename/change animations via UI, with YAML sync - Persistent storage of holograms and animations

Installation

1. Download the plugin JAR file 2. Place it in your server's `plugins` folder 3. Restart your server 4. The plugin will automatically create configuration files

Configuration

- Hologram settings are stored in `holograms.yml` - Animation settings are stored in `animations.yml`

Commands

Main Commands

- `/ezhologram` (aliases: `/ezh`, `/hologram`) - Opens the main hologram management interface - Requires permission: `ezholograms.use` - `/ezhologram reload` (alias: `/ezh reload`) - Reloads the holograms configuration - Requires permission: `ezholograms.reload` - Usage: `/ezhologram reload` or `/ezh reload` - `/ezhologram debug <name>` - Shows debug info for a hologram - `/ezhologram recreate <name>` - Recreates a hologram at its current location

Creating Holograms

1. Use `/ezhologram` command to open the UI 2. Click "Create Hologram" button 3. In the creation menu: - Add text lines using "Add Text" - Create new lines with "Add New Line" - Change text color with "Add Color" - Display items with "Add Item" - Add animated lines with "Add Animation" 4. After completing your hologram: - Click "Create Hologram" - Enter a unique name for your hologram - The hologram will appear at the center of the block you are standing on

Special Formatting Codes

Use these special codes in your hologram text or animation frames:

Text Formatting

- `!bold` or `|bold` - Makes text bold - `!italics` or `|italics` - Makes text italic - `!underlined` or `|underlined` - Adds underline - `!glow` or `|glow` - Adds glowing effect

Line Breaks

- `!nl` or `|nl` - Creates a new line

Colors

- `!color.colorname` or `|color.colorname` Available colors: - black, darkblue, darkgreen, darkaqua - darkred, darkpurple, gold, gray - darkgray, blue, green, aqua - red, lightpurple, yellow, white

Items

- `!item.itemname` or `|item.itemname` Example: `!item.diamond_sword`

Animations

- `!animation.animationname` or `|animation.animationname` - Animation frames can be any text or item line (including formatting, color, and `!item.`) - Frames are cycled at the configured interval (in ticks) - Example animation frame list: ``` !item.diamond !item.emerald !color.red Animated Text! !item.stick ```

Editing Holograms

1. Open the main UI with `/ezhologram` 2. Click "Edit Hologram" 3. Select the hologram to edit 4. Edit options: - Edit entire hologram text - Word-level and line-level editing: - Left-click to edit individual words - Right-click to edit entire line - Apply formatting to specific words - Add or edit animation lines and frames - Rename/change animations (updates YAML and all references) 5. Additional options: - Move hologram to new coordinates - Copy hologram with new name - Cancel editing at any time with the Cancel button

Removing Holograms

1. Use `/ezhologram` command 2. Click "Remove Hologram" 3. Select the hologram to remove 4. The hologram will be permanently deleted

Examples

Simple Welcome Hologram

``` Welcome to the server! ```

Multi-line Colored Hologram

``` !color.blue Welcome !color.gold to our awesome server !color.aqua Enjoy your stay! ```

Hologram with Items

``` !color.yellow Available Items: !item.diamond_sword !item.diamond_pickaxe ```

Animated Hologram (Text and Items)

``` !animation.example ``` Where `example` is an animation defined with frames like: ``` !item.diamond !item.emerald !color.red Animated Text! !item.stick ```

Styled Hologram

``` Welcome !bold This text is bold !italics This text is italic !underlined This text is underlined !glow This text glows ```

Complex Hologram

``` !color.blue Welcome !nl !color.green to the server !nl you can create anything you want !item.iron_pickaxe !nl ENJOY! ```

Troubleshooting

- If holograms or animations aren't showing up, check your permissions - Make sure you have the latest version of the plugin - If editing isn't working, try reloading the plugin - If items in animations show as text, check your animation frame syntax - If spacing looks wrong, make sure you are using the latest version

License

All Rights Reserved