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) - **Animated hologram lines:** cycle through text and/or items with configurable speed - **Word level and line level text editing** - 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