# EZ Holograms Plugin
A powerful and user-friendly Minecraft plugin for creating, managing, and customizing holograms in your server.
## Features
- Easy to use graphical interface for hologram creation and management
- Support for multiple text lines and special formatting
- Item display functionality
- Word-level text editing
- Hologram movement and copying
- Persistent storage of holograms
## 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
The plugin uses `hologarms.yml` for configuration settings. You can modify:
- Hologram settings
## 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`
## 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"
4. After completing your hologram:
- Click "Create Hologram"
- Enter a unique name for your hologram
- The hologram will appear at your current location
## Special Formatting Codes
Use these special codes in your hologram text:
### 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`
## 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 editing:
- Left-click to edit individual words
- Right-click to edit entire line
- Apply formatting to specific words
5. Additional options:
- Move hologram to new coordinates
- Copy hologram with new name
## 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
```
### 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 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
## License
This plugin is licensed under the MIT License.
