# GeyserMenu
一个轻量级且简单的基岩版自定义表单插件。
## 最新版本：v1.2.0
### 更新内容
- 改进菜单类型和权限配置文档
- 优化菜单配置的说明
- 纠正文档中的术语（“基岭版”应统一更正为“基岩版”）
## 功能特性
### 基本功能
- 仅支持基岩版的玩家
- 支持多个菜单配置
- 支持无限级别的子菜单
- 支持 PlaceholderAPI 变量
- 支持两种类型的图标：
- Java 版物品 ID (使用 `icon_type: "java"`)
- 基岩版材质路径 (使用 `icon_type: "bedrock"`)
- 集成 BStats 统计功能 (可配置)
### 命令系统
- 支持三种命令执行模式：
- 玩家执行 (`execute_as: "player"`)
- 控制台执行 (`execute_as: "console"`)
- OP 权限执行 (`execute_as: "op"`)
### 命令列表
- `/gmenu` - 打开默认菜单
- `/gmenu help` - 显示帮助信息
- `/gmenu reload` - 重新加载配置文件 (需要权限: geysermenu.reload)
- `/gmenu open <玩家名称> <菜单名称>` - 为指定玩家打开菜单 (需要权限: geysermenu.open)
### 权限节点
- `geysermenu.use` - 允许使用菜单命令 (默认: true)
- `geysermenu.reload` - 允许重新加载配置文件 (默认: op)
- `geysermenu.open` - 允许为其他玩家打开菜单 (默认: op)
- `geysermenu.*` - 允许访问所有功能 (默认: op)
### 菜单配置
- 支持通过 config.yml 启用/禁用菜单
- 支持自定义菜单标题和按钮
- 支持自定义按钮图标和命令
- - 支持物品 ID 图标 (例如 `minecraft:diamond`)
- - 支持 URL 图标 (使用 `icon_type: "url"`)
- - 支持自定义路径图标 (使用 `icon_type: "path"` 和 `icon_path`)
- 支持菜单之间的相互导航
- 支持菜单副标题和描述
- 支持按钮描述文本
- 支持表单页脚文本
- 支持颜色代码 (使用 § 或 &)
- 支持多行文本 (使用 |- 语法)
## 图标支持
GeyserMenu 支持两种类型的图标：
1. Java 版物品 ID
```yaml
icon: "diamond_sword"
icon_type: "java"
```
2. 基岩版材质路径
```yaml
icon: "textures/items/diamond_sword"
icon_type: "bedrock"
```
所有支持的 Java 版物品 ID 都将自动映射到它们对应的基岩版材质路径。您可以在 config.yml 中添加或修改这些映射。
## 统计功能
GeyserMenu 集成了 BStats 统计功能，以收集匿名插件使用数据，帮助开发者了解插件的使用情况并提高其质量。
### 配置选项
```yaml
settings:
statistics:
# 是否启用 BStats 统计
enable-bstats: true
# 是否收集自定义统计数据
collect-custom-data: true
```
### 收集的数据
- 服务器版本和软件类型
- Java 版本信息
- 在线玩家数量
- 插件功能的使用情况
- 菜单配置统计
### 隐私保护
- 所有数据都是匿名的
- 不会收集敏感数据，例如服务器 IP 地址和玩家信息
- 可以在配置中随时禁用