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

This plugin is licensed under the MIT License.