- 版权类型
- 原创
- 插件中文名称
- GF菜单
- 插件英文名称
- GFMenu
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- Leaves
- 其他核心
- 语言支持
- 多语言
- 适配版本（Java）
- 26.x
- 1.21
[MD]
# GFMenu
[](https://www.spigotmc.org/resources/gfmenu.137753/)
[](https://modrinth.com/plugin/gfmenu)
[](https://github.com/levindurant303/GFMenu)
**GFMenu** 是一个简单易用、基于 Bukkit 的 Minecraft 1.21+ GUI 菜单插件。
兼容 CraftBukkit、Spigot、Paper 以及其他 Bukkit API 服务端实现。它为交互式服务器菜单提供游戏内可视化编辑、书本输入、玩家与控制台命令执行，以及中英文语言切换
---
## 语言
全服面向玩家的语言可由管理员在运行时切换：
```text
/gfmenu lang zh_CN
/gfmenu lang en_US
```
`config.yml ` 默认使用 zh_CN。所选语言会改变命令反馈、权限错误、编辑器标题、书本编辑器以及输入会话消息。插件数据文件夹中现有的语言文件可以覆盖单条消息；更新后，新内置的键仍会作为默认值可用。
在 zh_CN 下，物品设置页面包含分别用于 名称、描述、左键命令、右键命令 和 通用命令 的独立书本。所选物品决定其材料和数量，因此玩家无需输入 Minecraft 材料 ID。包括 `控制台命令:` 、 `玩家命令:` 、`消息:`、 `打开菜单:`、 `书本:` 和 `关闭` 在内的中文操作别名也会被接受。
## 编辑菜单
拥有 `gfmenu.admin` 权限的管理员可以在游戏内编辑已加载的菜单。
```text
/gfmenu edit <menu>
```
这会打开一个物品栏编辑器。点击已有的菜单物品，或者从自己的物品栏中拿起一个物品并点击空的菜单槽位。随后会打开第二个物品栏，其中包含分别用于名称、描述、左键命令、右键命令和通用命令的独立书本。点击一本书，在其中写入普通文本，然后点击 `完成 `返回到物品设置页面。
所选物品决定其材料、数量、发光效果和头颅所有者。点击翠绿色的 `保存并返回`按钮以写入该物品并返回菜单编辑器。对其他槽位重复此操作。使用 Escape 关闭主菜单编辑器时，会在保存的更改写入后关闭编辑器。
在命令书中，每行写一条命令。普通行（例如 `/warp rewards`）会以点击的玩家身份执行。仅当必须由服务器执行命令时，才使用 `console: give %player% diamond 1`。
命令编辑可用于无法通过物品栏更改的字段：
```text
/gfmenu edit <menu> title <text>
/gfmenu edit <menu> permission <node|none>
/gfmenu edit <menu> size <9-54>
/gfmenu edit <menu> item <slot> <material> [amount] [name]
/gfmenu edit <menu> remove <slot>
/gfmenu edit <menu> lore <slot> <set|add|remove|clear> [text|index]
/gfmenu edit <menu> action <slot> <left|right|all> <set|add|remove|clear> [action|index]
```
`size` 用于 DeluxeMenus 风格的菜单。TrMenu 菜单大小由其 `layout` 的行数决定。
## 物品操作
操作按点击类型进行配置。 `command:` 以点击的玩家身份运行； `console:` 从服务器控制台运行。
```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
actions:
left:
- "book:feedback|prompt=&eWrite your feedback in the book.|end=console: feedback save %player% %book_input%|cancel=tell: &cFeedback cancelled."
```
同一操作也可以通过编辑器命令添加：
```text
/gfmenu edit <menu> action <slot> left add book:feedback|prompt=&eWrite your feedback.|end=console: feedback save %player% %book_input%
```
将 `%book_input%` 保留在由可信插件拥有的命令的参数位置中。不要配置原始的`console: %book_input%` 操作，因为那会允许玩家使用整个控制台。
# ⚠️ 转载/搬运政策
**中文**：关于转载/搬运：欢迎中文社区搬运本插件，但请务必保留原作者署名、附上原帖链接，并保持免费下载。如有违反，将发起 DMCA 投诉。
## 项目主页
作者：levindurant303
https://github.com/levindurant303/GFMenu
[/MD]
