EZ-Hologram

By
WILD_DRS
Bukkit Plugins

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

# 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.