# **EzShows - 打造沉浸式游戏内演出和活动**
EzShows 是一个强大且功能丰富的 Minecraft 插件，旨在帮助服务器所有者创建沉浸式和动态的游戏内演出、活动和体验。无论您是举办烟花表演、音乐会还是自定义活动，EzShows 都提供所有您需要的工具来吸引您的玩家。凭借与 OpenAudioMC 的无缝集成、可定制的效果以及直观的 GUI，EzShows 让您轻松将创意愿景变为现实。
---
## **功能**
- **演出管理**:
- 直接在游戏中创建、编辑和删除演出。
- 管理演出设置，例如区域名称、中心位置和动作距离。
- **动态效果**:
- 为您的演出添加烟花、粒子、喷泉、方块和文本显示。
- 使用颜色、运动、持续时间等详细选项自定义效果。
- **音频集成**:
- 与 OpenAudioMC 的无缝集成，实现同步音乐播放。
- 预加载附近玩家的音频，以确保演出期间的流畅播放。
- **音轨管理**:
- 使用直观的 GUI 创建、编辑和删除音轨。
- 管理音轨属性，例如名称、URL 和持续时间。
- **直观的 GUI**:
- 用于管理演出、音轨和效果的用户友好界面。
- 分页支持，用于处理大量的动作或音轨。
- **自动化**:
- 使用精确的基于滴答的时序安排动作和效果。
- 在所有动作和音频完成后自动停止演出。
---
## **命令**
以下是您可以在 EzShows 中使用的命令：
| **命令** | **描述** | **权限** |
|---------------------------|----------------------------------------------|----------------------|
| `/show create [名称]` | 创建一个新的演出。 | `ezshows.use` |
| `/show edit [名称]` | 编辑一个已有的演出。 | `ezshows.use` |
| `/show start [名称]` | 启动一个演出。 | `ezshows.use` |
| `/show stop [名称]` | 停止一个正在运行的演出。 | `ezshows.use` |
| `/show delete [名称]` | 删除一个演出。 | `ezshows.use` |
| `/show reloadtracks` | 从 `tracks.yml` 重新加载音轨。 | `ezshows.admin` |
| `/show reload` | 从 `data.yml` 重新加载所有演出。 | `ezshows.admin` |
---
## **安装步骤**
1. **安装插件**:
- 下载 `EzShows.jar` 文件并将其放入服务器的 `plugins` 文件夹中。
- 重新启动您的服务器以生成必要的配置文件 (`data.yml` 和 `tracks.yml`)。
2. **安装 OpenAudioMC (可选)**:
- 如果您想使用音频功能，请下载并在您的服务器上安装 OpenAudioMC。
- 确保 OpenAudioMC 已正确配置为音频播放。
3. **配置您的演出**:
- 使用 `/show create [名称]` 创建一个新的演出。
- 使用 `/show edit [名称]` 打开编辑器 GUI，并向您的演出添加效果、音乐和设置。
4. **添加音轨**:
- 使用音乐选择 GUI 创建和管理音轨。
- 添加音轨 URL、设置持续时间，并在将它们添加到您的演出之前预览音轨。
5. **启动您的演出**:
- 使用 `/show start [名称]` 启动您的演出，看看魔术发生！
---
## **如何使用 GUI**
- **演出编辑器**:
- 使用 `/show edit [名称]` 打开编辑器 GUI。
- 添加烟花、粒子、喷泉、方块和文本显示等效果。
- 使用颜色、运动和持续时间等详细选项自定义每个效果。
- **音乐选择**:
- 打开音乐选择 GUI 以管理音轨。
- 预览音轨、设置持续时间，并将它们分配给您的演出。
---
## **要求**
- **Minecraft 版本**: 兼容 1.16+ (已在 1.20 上测试)。
- **依赖项**: OpenAudioMC (需要音频功能)。
---
## **配置文件**
1. **`data.yml`**:
- 存储所有演出数据，包括动作、效果和设置。
- 插件安装时自动生成。
2. **`tracks.yml`**:
- 存储所有音轨数据，包括名称、URL 和持续时间。
- 插件安装时自动生成。
---
**支持**
如果您遇到任何问题或对 EzShows 有任何疑问，我们随时为您提供帮助！以下是获取支持的方法：
- **Discord**: 加入我们的社区 Discord 服务器，以获得实时支持和更新。
- **电子邮件**: 通过 [support@example.com] 联系我们以获得帮助。
- **文档**: 查阅我们的详细文档，了解设置指南和常见问题解答。
---
**已知问题**
- 音频播放需要安装和正确配置 OpenAudioMC。
- 使用有效的音轨 URL 以避免播放错误。
- 如果配置不当，某些效果可能无法按预期工作。
---
**为什么选择 EzShows？**
EzShows 的设计旨在尽可能简化游戏内演出和活动的创建过程。凭借其强大的功能、无缝的音频集成和用户友好的 GUI，EzShows 是服务器所有者的理想工具，他们希望为他们的玩家创建难忘的体验。
---
如果您想进一步完善它或添加更多细节，请告诉我！