> For the complete documentation index, see [llms.txt](https://simple.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://simple.superiormc.cn/arcmenu-wen-dang/gong-neng-pei-zhi/editor.md).

# 可视化编辑器

ArcMenu Editor 供管理员在游戏中调整菜单布局、元素属性和点击区域。普通玩家使用菜单无需安装编辑器。

编辑器需要 Paper、Folia、Leaf 等服务端，Spigot 不支持。管理员客户端需安装 Fabric 与兼容的 ArcMenu Editor，并拥有 `arcmenu.admin`。

## 准备与打开

下载地址：[ArcMenu Editor](https://github.com/FENTAIIII/ArcMenu-Editor)。按文件名中的 Minecraft 版本选择对应文件，仅安装一个编辑器文件。

1. 安装与管理员 Minecraft 客户端匹配的 Fabric、Fabric API 和编辑器，使用该客户端连接服务器。
2. 确认目标菜单已通过检查并加载；编辑器打开现有菜单，不代替首次创建菜单文件。
3. 执行 `/arcmenu edit <菜单标识>`，例如：

```
/arcmenu edit welcome
```

若提示编辑器未连接或需要更新，先确认模组已启用并使用兼容的编辑器。鼠标资源与自定义图片仍需按[图片与资源包](/arcmenu-wen-dang/gong-neng-pei-zhi/resource-packs.md)加载。

同一菜单同时只允许一个管理员编辑。已有其他管理员编辑时，等待其结束后再打开。

## 前端与后端

| 编辑范围 | 内容                      |
| ---- | ----------------------- |
| 前端   | 文字、背景、图片、物品、方块及分组等显示元素。 |
| 后端   | 点击区域的位置、尺寸和交互属性。        |

前端可调整元素位置与大小、修改属性、复制或删除元素、组织分组及调整显示顺序。后端用于对齐点击范围；移动前端按钮不会自动移动其区域。

根据所选元素类型填写属性，字段说明见[前端元素类型](/arcmenu-wen-dang/cai-dan-pei-zhi/menus/frontend.md)和[后端交互区域与点击事件](/arcmenu-wen-dang/cai-dan-pei-zhi/menus/backend.md)。显示顺序的调整不能代替后端区域的 `priority`。

分组与模板用于复用前端布局。保存模板时需要新的模板标识，不能覆盖同名文件；插入模板后得到独立元素。具体范围见[分组与可复用模板](/arcmenu-wen-dang/cai-dan-pei-zhi/menus/groups-templates.md)。

## 保存与应用

编辑中的更改属于当前草稿。确认布局后，按所用编辑器提供的保存或应用操作处理：

| 操作    | 结果                       |
| ----- | ------------------------ |
| 保存    | 将草稿写入菜单文件。               |
| 应用    | 先保存，再重新加载菜单，使玩家使用更新后的配置。 |
| 撤销、重做 | 调整当前草稿中的编辑操作。            |

仅保存后，若未执行应用，应通过 `/arcmenu validate` 和 `/arcmenu reload` 加载新配置。新增图片或改变资源内容仍需重建和分发资源包，应用菜单不代替此步骤。

关闭编辑器前确认需要保留的更改已保存。编辑器不会将普通预览点击当作按钮动作执行；测试功能应退出编辑，再用 `/arcmenu open <菜单标识>` 正常打开。

## 文件冲突与备份

编辑期间不要同时用其他工具修改同一菜单文件。发现文件已被外部修改时，编辑器拒绝覆盖，应保留需要的草稿内容，再关闭并重新打开最新文件。

首次保存更改时，会在 `plugins/ArcMenu/backup-menu/` 中保留原文件备份。已有同名备份不会每次保存都更新，因此它不是完整的编辑历史。

恢复备份前应结束该菜单的编辑，将所需备份内容复制回对应菜单文件，再检查并重载。恢复前建议另存当前文件，便于比较。

## 检查结果

分别检查显示布局、点击范围、条件与命令，并使用普通玩家账号验证权限。动画移动不会自动改变点击区域；提示框与图片需在加载资源包后检查。

常见加载问题见[常见问题与故障排查](/arcmenu-wen-dang/pei-zhi-yu-guan-li/faq.md)。