- 版权类型
- 转载
- 插件中文名
- GFMenu（Java 21 构建版）
- 插件英文名
- GFMenu
- 支持的核心 [服务端]
- Paper
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
## 简介
分类： 服务端插件 · Java 版多人游戏
# GFMenu（Java 21 构建版）
**分类：** 服务端插件 · Java 版多人游戏
---
GFMenu 是一款适用于 Bukkit、Spigot 和 Paper 1.21+ 的 GUI 菜单插件，操作简便，支持 TrMenu 和 DeluxeMenus 风格的 YAML 配置，提供游戏内可视化编辑、书本输入、玩家与控制台命令，以及中英文语言切换功能。
---
## 语言设置
管理员可在服务器运行时切换面向玩家的显示语言：
```
/gfmenu lang zh_CN
/gfmenu lang en_US
```
config.yml 默认使用 `zh_CN`。语言设置会影响命令反馈、权限错误提示、编辑器标题、书本编辑器及输入会话中的所有提示文本。插件数据目录中现有的语言文件可覆盖单条消息；更新后新增的内置语言键仍以默认值提供。
启用 `zh_CN` 时，物品设置页面会显示独立的书本，分别对应：**名称**、**描述**、**左键命令**、**右键命令**、**通用命令**。物品的材质和数量通过点击选中物品直接决定，无需手动输入 Minecraft 材质 ID。中文动作别名同样受支持，包括：`控制台命令:`、`玩家命令:`、`消息:`、`打开菜单:`、`书本:`、`关闭`。
---
## 编辑菜单
拥有 `gfmenu.admin` 权限的管理员可在游戏内编辑已加载的菜单：
```
/gfmenu edit <菜单名>
```
执行命令后会打开一个物品栏编辑器。可点击现有菜单槽位中的物品，也可从自己的背包中拿起一件物品并点击空槽位放入。随后会弹出第二个物品栏，包含名称、描述（Lore）、左键命令、右键命令和任意点击命令的独立书本。点击书本后在其中写入内容，完成后点击「完成」返回物品设置页面。
物品的材质、数量、发光效果和头颅所有者由所选物品决定。点击绿宝石「保存并返回」按钮可将当前物品写入并返回菜单编辑器。对其他槽位重复以上操作。在主菜单编辑器中按 Escape 键关闭时，已保存的更改会先写入磁盘，编辑器随后退出。
在命令书本中，每行写一条命令。普通行（如 `/warp rewards`）以点击该物品的玩家身份执行；若需要服务器执行命令，则使用 `console: give %player% diamond 1` 格式。
对于无法通过物品栏界面修改的字段，可使用以下命令行方式编辑：
```
/gfmenu edit <菜单名> title <标题文本>
/gfmenu edit <菜单名> permission <权限节点|none>
/gfmenu edit <菜单名> size <9-54>
/gfmenu edit <菜单名> item <槽位> <材质> [数量] [名称]
/gfmenu edit <菜单名> remove <槽位>
/gfmenu edit <菜单名> lore <槽位> <set|add|remove|clear> [文本|索引]
/gfmenu edit <菜单名> action <槽位> <left|right|all> <set|add|remove|clear> [动作|索引]
```
> `size` 参数仅适用于 DeluxeMenus 风格的菜单；TrMenu 风格菜单的大小由布局行数决定。
---
## 物品动作
动作按点击类型分别配置。`command:` 以点击玩家身份执行；`console:` 以服务器控制台身份执行。
**YAML 示例：**
```yaml
Icons:
A:
display:
material: DIAMOND
name: "&bRewards"
actions:
left:
- "command: warp rewards"
right:
- "console: give %player% diamond 1"
- "sound: ENTITY_PLAYER_LEVELUP-1-1"
```
支持的动作类型：`command:`、`console:`、`tell:`、`message:`、`chat:`、`menu:`、`sound:`、`close`、`catcher:`、`book:`。
> `op:` 会被视为 `console:` 处理，**不会**给予玩家临时 OP 权限。
---
## 书本输入动作
使用 `book:` 动作可向玩家打开一本可书写的书。玩家确认编辑后，所有页面内容将存入 `%book_input%` 变量，并依次执行 `end=` 中配置的后续动作。
**YAML 示例：**
```yaml
actions:
left:
- "book:feedback|prompt=&eWrite your feedback in the book.|end=console: feedback save %player% %book_input%|cancel=tell: &cFeedback cancelled."
```
也可通过编辑器命令直接添加此动作：
```
/gfmenu edit <菜单名> action <槽位> left add book:feedback|prompt=&eWrite your feedback.|end=console: feedback save %player% %book_input%
```
**安全提示：** 请将 `%book_input%` 作为受信任插件命令的参数使用，不要直接配置 `console: %book_input%` 这类将玩家输入作为完整控制台命令执行的动作，否则玩家可以借此执行任意服务器命令。
[/MD]
## 简介
分类： 服务端插件 · Java 版多人游戏
# GFMenu（Java 21 构建版）
**分类：** 服务端插件 · Java 版多人游戏
---
GFMenu 是一款适用于 Bukkit、Spigot 和 Paper 1.21+ 的 GUI 菜单插件，操作简便，支持 TrMenu 和 DeluxeMenus 风格的 YAML 配置，提供游戏内可视化编辑、书本输入、玩家与控制台命令，以及中英文语言切换功能。
---
## 语言设置
管理员可在服务器运行时切换面向玩家的显示语言：
```
/gfmenu lang zh_CN
/gfmenu lang en_US
```
config.yml 默认使用 `zh_CN`。语言设置会影响命令反馈、权限错误提示、编辑器标题、书本编辑器及输入会话中的所有提示文本。插件数据目录中现有的语言文件可覆盖单条消息；更新后新增的内置语言键仍以默认值提供。
启用 `zh_CN` 时，物品设置页面会显示独立的书本，分别对应：**名称**、**描述**、**左键命令**、**右键命令**、**通用命令**。物品的材质和数量通过点击选中物品直接决定，无需手动输入 Minecraft 材质 ID。中文动作别名同样受支持，包括：`控制台命令:`、`玩家命令:`、`消息:`、`打开菜单:`、`书本:`、`关闭`。
---
## 编辑菜单
拥有 `gfmenu.admin` 权限的管理员可在游戏内编辑已加载的菜单：
```
/gfmenu edit <菜单名>
```
执行命令后会打开一个物品栏编辑器。可点击现有菜单槽位中的物品，也可从自己的背包中拿起一件物品并点击空槽位放入。随后会弹出第二个物品栏，包含名称、描述（Lore）、左键命令、右键命令和任意点击命令的独立书本。点击书本后在其中写入内容，完成后点击「完成」返回物品设置页面。
物品的材质、数量、发光效果和头颅所有者由所选物品决定。点击绿宝石「保存并返回」按钮可将当前物品写入并返回菜单编辑器。对其他槽位重复以上操作。在主菜单编辑器中按 Escape 键关闭时，已保存的更改会先写入磁盘，编辑器随后退出。
在命令书本中，每行写一条命令。普通行（如 `/warp rewards`）以点击该物品的玩家身份执行；若需要服务器执行命令，则使用 `console: give %player% diamond 1` 格式。
对于无法通过物品栏界面修改的字段，可使用以下命令行方式编辑：
```
/gfmenu edit <菜单名> title <标题文本>
/gfmenu edit <菜单名> permission <权限节点|none>
/gfmenu edit <菜单名> size <9-54>
/gfmenu edit <菜单名> item <槽位> <材质> [数量] [名称]
/gfmenu edit <菜单名> remove <槽位>
/gfmenu edit <菜单名> lore <槽位> <set|add|remove|clear> [文本|索引]
/gfmenu edit <菜单名> action <槽位> <left|right|all> <set|add|remove|clear> [动作|索引]
```
> `size` 参数仅适用于 DeluxeMenus 风格的菜单；TrMenu 风格菜单的大小由布局行数决定。
---
## 物品动作
动作按点击类型分别配置。`command:` 以点击玩家身份执行；`console:` 以服务器控制台身份执行。
**YAML 示例：**
```yaml
Icons:
A:
display:
material: DIAMOND
name: "&bRewards"
actions:
left:
- "command: warp rewards"
right:
- "console: give %player% diamond 1"
- "sound: ENTITY_PLAYER_LEVELUP-1-1"
```
支持的动作类型：`command:`、`console:`、`tell:`、`message:`、`chat:`、`menu:`、`sound:`、`close`、`catcher:`、`book:`。
> `op:` 会被视为 `console:` 处理，**不会**给予玩家临时 OP 权限。
---
## 书本输入动作
使用 `book:` 动作可向玩家打开一本可书写的书。玩家确认编辑后，所有页面内容将存入 `%book_input%` 变量，并依次执行 `end=` 中配置的后续动作。
**YAML 示例：**
```yaml
actions:
left:
- "book:feedback|prompt=&eWrite your feedback in the book.|end=console: feedback save %player% %book_input%|cancel=tell: &cFeedback cancelled."
```
也可通过编辑器命令直接添加此动作：
```
/gfmenu edit <菜单名> action <槽位> left add book:feedback|prompt=&eWrite your feedback.|end=console: feedback save %player% %book_input%
```
**安全提示：** 请将 `%book_input%` 作为受信任插件命令的参数使用，不要直接配置 `console: %book_input%` 这类将玩家输入作为完整控制台命令执行的动作，否则玩家可以借此执行任意服务器命令。
[/MD]