# EZ Holograms 插件
一个功能强大且用户友好的 Minecraft 插件，用于创建、管理、自定义和在服务器上动画化全息图。
## 功能
- 用于全息图创建和管理的易于使用的图形界面
- 支持多行文本和高级格式
- 项目显示功能（包括动画）
- **动画全息图行:** 以可配置的速度循环文本和/或项目
- **单词级别和行级别文本编辑**
- 全息图移动和复制
- **动画管理:** 通过 UI 重命名/更改动画，并进行 YAML 同步
- 全息图和动画的持久存储
## 安装
1. 下载插件 JAR 文件
2. 将其放入服务器的 `plugins` 文件夹中
3. 重新启动服务器
4. 插件将自动创建配置文件
## 配置文件
- 全息图设置存储在 `holograms.yml` 中
- 动画设置存储在 `animations.yml` 中
## 命令
### 主要命令
- `/ezhologram` (别名: `/ezh`, `/hologram`)
- 打开主要全息图管理界面
- 需要权限: `ezholograms.use`
- `/ezhologram reload` (别名: `/ezh reload`)
- 重新加载全息图配置文件
- 需要权限: `ezholograms.reload`
- 用法: `/ezhologram reload` 或 `/ezh reload`
- `/ezhologram debug `
- 显示全息图的调试信息
- `/ezhologram recreate `
- 在全息图当前位置重新创建全息图
## 创建全息图
1. 使用 `/ezhologram` 命令打开 UI
2. 点击 “创建全息图” 按钮
3. 在创建菜单中:
- 使用 “添加文本” 添加文本行
- 使用 “添加新行” 创建新行
- 使用 “添加颜色” 更改文本颜色
- 使用 “添加项目” 显示项目
- 使用 “添加动画” 添加动画行
4. 完成全息图后:
- 点击 “创建全息图”
- 为全息图输入一个唯一的名称
- 全息图将出现在你站立的方块中心
## 特殊格式代码
在全息图文本或动画帧中使用这些特殊代码：
### 文本格式
- `!bold` 或 `|bold` - 使文本加粗
- `!italics` 或 `|italics` - 使文本斜体
- `!underlined` 或 `|underlined` - 添加下划线
- `!glow` 或 `|glow` - 添加发光效果
### 换行
- `!nl` 或 `|nl` - 创建新行
### 颜色
- `!color.colorname` 或 `|color.colorname`
可用颜色:
- black, darkblue, darkgreen, darkaqua
- darkred, darkpurple, gold, gray
- darkgray, blue, green, aqua
- red, lightpurple, yellow, white
### 项目
- `!item.itemname` 或 `|item.itemname`
示例: `!item.diamond_sword`
### 动画
- `!animation.animationname` 或 `|animation.animationname`
- 动画帧可以是任何文本或项目行（包括格式、颜色和 `!item.`)
- 帧以配置的间隔（以 tick 为单位）循环播放
- 示例动画帧列表:
```
!item.diamond
!item.emerald
!color.red Animated Text!
!item.stick
```
## 编辑全息图
1. 使用 `/ezhologram` 命令打开主要 UI
2. 点击 “编辑全息图”
3. 选择要编辑的全息图
4. 编辑选项:
- 编辑整个全息图文本
- 单词级别和行级别编辑:
- 左键单击编辑单个单词
- 右键单击编辑整行
- 对特定单词应用格式
- 添加或编辑动画行和帧
- 重命名/更改动画（更新 YAML 和所有引用）
5. 其他选项:
- 将全息图移动到新坐标
- 使用新名称复制全息图
- 可以随时使用“取消”按钮取消编辑
## 删除全息图
1. 使用 `/ezhologram` 命令
2. 点击 “删除全息图”
3. 选择要删除的全息图
4. 全息图将被永久删除
## 示例
### 简单的欢迎全息图
```
Welcome to the server!
```
### 多行彩色全息图
```
!color.blue Welcome
!color.gold to our awesome server
!color.aqua Enjoy your stay!
```
### 带项目的全息图
```
!color.yellow Available Items:
!item.diamond_sword
!item.diamond_pickaxe
```
### 动画全息图（文本和项目）
```
!animation.example
```
其中 `example` 是一个定义有帧的动画:
```
!item.diamond
!item.emerald
!color.red Animated Text!
!item.stick
```
### 样式化全息图
```
Welcome
!bold This text is bold
!italics This text is italic
!underlined This text is underlined
!glow This text glows
```
### 复杂全息图
```
!color.blue Welcome !nl
!color.green to the server !nl
you can create anything you want !item.iron_pickaxe !nl
ENJOY!
```
## 故障排除
- 如果全息图或动画未显示，请检查您的权限
- 确保您拥有插件的最新版本
- 如果编辑不工作，请尝试重新加载插件
- 如果动画中的项目显示为文本，请检查您的动画帧语法
- 如果间距看起来不对，请确保您使用的是最新版本
## 协议
保留所有权利