# CEAddon-Menu: 自动菜单生成器,适用于 CraftEngine
**需要 Paper 1.21.x | CraftEngine 的插件**
CEAddon-Menu 是一个轻量级的 CraftEngine [插件](https://modrinth.com/plugin/craftengine),它可以自动生成包含所有 CraftEngine 项目的 GUI 菜单——无需手动设置 categories.yml。
## 🧩 特性
- 从您的 CraftEngine YAML 文件自动生成 GUI 菜单
- 读取 CraftEngine 的原生 YAML 文件以获取项目数据
- 使用 CraftEngine API,确保最小到零冲突
- 默认情况下忽略资源包目录、categories.yml 和 templates.yml。您可以在 **config.yml** 中添加更多。
## ❌ 限制
- 需要 Paper 1.21.x – 不保证与 Spigot 或其他分支的兼容性。
## 💬 命令
- **/cea menu**: 打开自动生成的包含 CraftEngine 项目的 GUI。GUI 按目录和 YAML 文件来源组织。
- **/cea get **: 给予一个特定的 CraftEngine 项目。两者均提供标签完成功能 和 以方便使用。
## ⚙️ 配置
```
# 在读取 CraftEngine 文件时,应该忽略哪些目录?
excluded-directories:
- "resourcepack"
- "default"
- "internal"
# 在读取 CraftEngine 文件时,应该忽略哪些文件?
excluded-files:
- "templates.yml"
- "categories.yml"
# 在读取 CraftEngine 文件时,读取哪些顶层键?
# 更多信息,每个配置文件(yaml 文件)都有顶层键,例如 `items`、`images` 等。
# 如果您使用子键,例如 `items#misc` 或 `items#food`,请确保包含这些。
keys-to-read:
- "items"
- "items#misc"
- "images"
```
## 🛣️ 路线图
- ~~添加对自定义图像的支持~~ 在 1.0.3 版本中添加
- ~~添加对表情符号的支持~~ 在 1.0.3 版本中添加
## 📥 安装
1. 安装 CraftEngine 并确保其正常工作。
2. 将 CEAddonMenu.jar 文件放入您的 /plugins 文件夹中。
3. 启动服务器——就这些了!
## 💬 反馈或建议?
随时通过 GitHub 或 Discord 报告问题或提出功能请求!
- [Github 仓库](https://github.com/jcnp97/CEAddon-Menu)
- [报告问题](https://github.com/jcnp97/CEAddon-Menu/issues)