# 🏠 ECHomeGUI
**ECHomeGUI** 是一个 **Spigot / Paper** 服务器插件，通过 **完全可定制的图形界面** 将 *家系统* 提升到新的水平，非常适合生存服务器、SMP 或希望以现代和用户友好的方式管理玩家家的网络。
适用于 **Minecraft 1.16 → 1.21.8**，并完全支持兼容的分叉版本（Purpur 等）。
> 🔎 此项目是 **对原始 TechnoVision 插件的分支**，已更新和扩展，适用于 Minecraft 的现代版本，具有改进的性能和新的自定义功能。
---
## ✨ 主要特性
- 📂 **完整的 GUI 菜单**，用于创建、管理和传送至家。
- 🖼️ **可定制的图标**，用于每个家（选择你自己的方块/物品）。
- 🎨 **灵活的配置**，在 `config.yml` 和 `lang.yml` 中进行配置，支持 HEX 颜色。
- 🔒 **高级权限系统**，以限制操作或授予管理员控制权。
- 🎵 **可配置的声音和粒子**，用于传送、创建和删除家。
- 📌 **额外的 GUI 按钮**: 返回菜单、关闭物品栏或运行命令。
- ⏱️ **传送冷却时间和取消**，当移动或受到伤害时。
- ⚡ **标题、副标题和动作条支持**，无需侵入性前缀。
- 🛠️ **完全兼容 EssentialsX**（可选）。
- 🚀 **轻量级和优化**: 设计用于避免性能影响。
---
## 📖 主要命令
- `/home` → 打开你的家的菜单。
- `/home <玩家|家>` → 传送至特定家或打开另一个玩家的菜单。
- `/homegui reload` → 在不重启服务器的情况下重新加载配置。
- `/homeadmin <玩家|重新加载>` → 管理员工具，用于管理其他玩家的家。
---
## 🔑 权限
- `homegui.admin` → 完整访问 `/homeadmin`。
- `homegui.admin.reload` → 重新加载配置。
- `homegui.admin.view` → 查看和管理其他玩家的家。
---
## ⚙️ 快速配置
- **主 GUI**
- `gui-main-header`: 菜单标题。
- `size`: 物品栏大小。
- `home-slots`: 家槽位位置。
- `filler-item`: 用于空置位置的填充物品。
- `create-home-button`: 用于创建新家的按钮。
- **家**
- `title-home`: 每个家的名称和颜色。
- `home-lore`: 附加信息，带有占位符，例如 `{world}`、`{location}`、`{player}`。
- **其他**
- `extra-buttons`: 可定制的按钮 (`command:`、`close`、`empty`)。
- **聊天**
- 提示玩家输入家庭名称。
- 输入 `"cancel"` 以中止。
- **消息**
- 可以在 `lang.yml` 中完全编辑。
- 支持 `&` 和 HEX 颜色 (`&#rrggbb`)。
- **效果**
- 自定义所有关键操作的声音和粒子。
---
## 🎮 示例流程
1. 玩家使用 `/home` 打开 GUI。
2. 选择一个空槽并创建一个新家。
3. 在聊天中输入一个名称（例如：`main_base`）。
4. 直接从 GUI 自定义家庭图标。
5. 左键单击 → 立即传送。
---
## 🔧 依赖
- **可选:** [EssentialsX](https://essentialsx.net/) (与经典 `/home` 命令集成)。