原创 开源 工具 菜单插件支持1.20.1-1.21.4 1.0.0

# StarUI 插件

StarUI是一个Minecraft插件，允许玩家创建和编辑自定义UI界面。玩家可以将物品放入UI中，关闭UI后会自动保存，且UI内的物品无法取出。

## 功能特点
- 支持54格大箱子UI
- 在编辑模式下可以自由取出和移动物品
- 关闭UI自动保存
- 支持自定义UI名称和描述
- 支持配置点击特定物品执行的指令
- 支持1.20.1-1.21.4版本
- 兼容Bukkit和Paper服务器

## 安装方法
1. 下载插件的JAR文件
2. 将JAR文件放入服务器的plugins文件夹中
3. 重启服务器
4. 插件会自动生成配置文件和菜单文件夹

## 使用方法

### 基本命令
- `/starui create <UIID>`: 创建新UI
- `/starui view <UIID>`: 编辑现有UI（可以拖动物品到UI内）
- `/starui open <UIID>`: 打开UI（仅查看，不可拖动物品）
- `/starui reload`: 重载插件
- `/starui setname <UIID> <名称>`: 设置UI名称
- `/starui setlore <UIID> <行1> [行2] [...]`: 设置UI描述
- `/starui addcommand <UIID> <指令>`: 已废弃（全局指令功能已移除）
- `/starui removecommand <UIID> <索引>`: 已废弃（全局指令功能已移除）
- `/starui additemcommand <UIID> <槽位> <指令>`: 为UI中特定槽位的物品添加指令
- `/starui removeitemcommand <UIID> <槽位> <索引>`: 移除UI中特定槽位物品的指令

### 配置UI
1. 使用 `/starui create <UIID>` 命令创建新UI
2. 或者使用 `/starui view <UIID>` 命令编辑现有UI
3. 将物品拖入UI中，可以自由取出和调整位置（仅编辑模式下）
4. 关闭UI后会自动保存
5. 使用 `/starui additemcommand <UIID> <槽位> <指令>` 为特定槽位的物品添加指令

### 查看UI
1. 使用 `/starui open <UIID>` 命令打开UI
2. 在查看模式下，无法拖动物品到UI内或调整物品位置
3. 点击UI中的物品时，只会执行该物品槽位关联的指令（如果有）

### 指令执行逻辑
- 物品指令：使用 `/starui additemcommand` 添加的指令只会在点击对应槽位的物品时执行
- 全局指令功能已移除，现在只有点击设置了指令的物品才会执行指令
- 如果某个物品没有设置指令，则点击时不会执行任何指令

### 重载插件
- 使用 `/starui reload` 命令可以重新加载插件配置和所有菜单，无需重启服务器

### 高级配置
菜单配置文件位于 `plugins/StarUI/menu` 目录下，每个UI对应一个YAML文件。
可以编辑这些文件来配置：
- UI名称
- UI描述（lore）
- 点击UI执行的全局指令
- UI中的物品
- 物品槽位对应的指令（在itemCommands部分）

## 配置文件
`plugins/StarUI/config.yml` 包含插件的基本设置，可以根据需要修改。

## 权限
- `starui.use`: 允许使用基本命令（默认开启）
- `starui.edit`: 允许编辑UI
- `starui.create`: 允许创建新UI
- `starui.admin`: 管理员权限，包含所有其他权限

## 示例
创建一个名为"test"的UI并添加物品指令：
1. 运行命令 `/starui create test`
2. 放入物品并关闭UI
3. 在 `plugins/StarUI/menu` 目录下会生成 `test.yml` 文件
4. 编辑 `test.yml` 文件来自定义UI名称、描述和全局指令
5. 使用 `/starui additemcommand test 10 say 你点击了槽位10的物品!` 为槽位10的物品添加指令

编辑现有UI：
1. 运行命令 `/starui view test`
2. 修改UI内容并关闭UI
3. 更改会自动保存

查看UI：
1. 运行命令 `/starui open test`
2. 查看UI内容，但无法进行编辑

重载插件：
1. 运行命令 `/starui reload`
2. 插件会重新加载配置和所有菜单

## 注意事项
- 在查看模式下（使用/starui open命令）UI内的物品无法取出
- 在编辑模式下（使用/starui create或/starui view命令）可以自由取出和移动物品
- 确保服务器版本在1.20.1-1.21.4之间
- 本插件支持Bukkit和Paper服务器，不保证兼容其他服务端类型

## 反馈与建议
如有任何问题或建议，请在GitHub仓库提交Issue。
GitHub仓库https://github.com/miluo-awa/StarUI