> 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/pei-zhi-yu-guan-li/commands-permissions.md).

# 命令与权限

主命令为 `/arcmenu`。下文中，`<参数>` 表示需要填写的内容，`[参数]` 表示可选内容；输入时不保留括号。命令支持 Tab 补全。

## 通用命令

以下命令适用于 Paper、Folia、Leaf 和 Spigot。

### 玩家操作

| 命令                     | 用途                | 权限                         |
| ---------------------- | ----------------- | -------------------------- |
| `/arcmenu open <菜单标识>` | 为执行命令的玩家打开菜单。     | `arcmenu.use`，以及菜单自身要求的权限。 |
| `/arcmenu close`       | 关闭执行命令的玩家当前打开的菜单。 | 无额外权限要求。                   |

这两条命令需要在游戏中执行，不提供指定其他玩家的参数。

例如，打开配置中 `id: welcome` 的菜单：

```
/arcmenu open welcome
```

### 配置管理

以下命令需要 `arcmenu.admin`，可在游戏中或控制台执行。控制台输入命令时无需开头的 `/`。

| 命令                  | 用途             |
| ------------------- | -------------- |
| `/arcmenu list`     | 查看已加载的菜单标识。    |
| `/arcmenu validate` | 检查配置，报告发现的错误。  |
| `/arcmenu reload`   | 重新加载配置。        |
| `/arcmenu status`   | 查看菜单数量及当前使用情况。 |

修改菜单后，可依次检查并重载：

```
/arcmenu validate
/arcmenu reload
```

{% hint style="info" %}
重载成功后，当前打开的菜单会关闭。配置错误应根据提示修正后再重新加载。检查配置不会替代重载；更换插件文件则需要重启服务端。
{% endhint %}

## Paper、Folia 与 Leaf 专用命令

以下命令不适用于 Spigot。

### 操作方式

需要 `arcmenu.use`，且必须在游戏中执行。

| 命令                    | 用途                 |
| --------------------- | ------------------ |
| `/arcmenu mode`       | 查看当前操作方式和服务器设置。    |
| `/arcmenu mode touch` | 选择触摸模式，通过视线指向菜单按钮。 |
| `/arcmenu mode mouse` | 选择鼠标模式，通过光标操作菜单。   |

管理员强制指定操作方式后，玩家无法自行切换。鼠标模式的客户端与资源包要求见[运行要求](/arcmenu-wen-dang/ru-men/requirements.md)。

具体操作、模式策略和光标设置见[触摸与鼠标输入](/arcmenu-wen-dang/gong-neng-pei-zhi/input-modes.md)。

### 资源与模板

需要 `arcmenu.admin`，可在游戏中或控制台执行。

| 命令                    | 用途                |
| --------------------- | ----------------- |
| `/arcmenu reload all` | 重新加载配置、模板并重建图片资源。 |
| `/arcmenu resources`  | 重建资源包，不重新加载菜单定义。  |
| `/arcmenu templates`  | 查看已加载的模板标识。       |

资源包重建后仍需分发给玩家。使用 CraftEngine 时，随后执行 `/ce reload all`；其他方式见[资源包配置](https://simple.superiormc.cn/arcmenu-wen-dang/pei-zhi-yu-guan-li/pages/JfPbYFTL9xk7jR5CbVN6#资源包配置)。

### 预览与编辑

需要 `arcmenu.admin`，且必须在游戏中执行。

| 命令                                            | 用途                                |
| --------------------------------------------- | --------------------------------- |
| `/arcmenu preview <菜单标识> [frontend\|backend]` | 预览菜单，默认查看显示内容。`backend` 用于查看点击区域。 |
| `/arcmenu edit <菜单标识>`                        | 使用 ArcMenu Editor 打开菜单进行编辑。       |

例如，检查 `welcome` 的点击区域：

```
/arcmenu preview welcome backend
```

预览不执行菜单点击动作。测试按钮功能时，使用 `/arcmenu open <菜单标识>` 正常打开菜单。

编辑命令需要管理员安装兼容的 ArcMenu Editor，普通玩家无需安装。

### 动画

以下命令需要 `arcmenu.admin`。

| 命令                               | 用途                                   | 执行位置    |
| -------------------------------- | ------------------------------------ | ------- |
| `/arcmenu animations`            | 玩家执行时查看当前菜单可用的动画标识；控制台执行时查看配置中的动画标识。 | 游戏或控制台。 |
| `/arcmenu animate <动画标识>`        | 播放当前菜单中的指定动画。                        | 游戏内。    |
| `/arcmenu stop-animation <动画标识>` | 停止当前菜单中的指定动画。                        | 游戏内。    |

播放或停止动画前，需要打开配置了该动画的菜单。参数使用动画标识，不是菜单标识。

### 状态与排查

以下命令需要 `arcmenu.admin`，用于检查菜单操作或收集问题信息。

| 命令                           | 用途                   | 执行位置        |
| ---------------------------- | -------------------- | ----------- |
| `/arcmenu pointer`           | 查看当前菜单的指向信息。         | 游戏内，需要打开菜单。 |
| `/arcmenu pointer debug on`  | 开启光标诊断显示，用于排查鼠标模式问题。 | 游戏内。        |
| `/arcmenu pointer debug off` | 关闭光标诊断显示。            | 游戏内。        |
| `/arcmenu performance`       | 查看插件性能统计。            | 游戏或控制台。     |
| `/arcmenu performance reset` | 重置性能统计。              | 游戏或控制台。     |

使用光标诊断前，应先打开鼠标模式菜单并加载配套资源包。未满足条件时，命令会提示诊断不可用。

## 权限设置

### 插件权限

| 权限              | 用途                           | 默认授予  |
| --------------- | ---------------------------- | ----- |
| `arcmenu.use`   | 打开菜单；在支持的平台上选择操作方式。          | 所有玩家。 |
| `arcmenu.admin` | 配置检查、重载、菜单管理及支持的平台上的编辑等管理操作。 | OP。   |

`arcmenu.admin` 不代替 `arcmenu.use` 或菜单设置的额外权限。需要操作菜单的管理员也应拥有对应权限。

### 菜单权限

可在菜单顶层的 `permission` 字段设置额外权限，例如：

```yaml
permission: myserver.menu.vip
```

此时玩家需要同时拥有 `arcmenu.use` 和 `myserver.menu.vip` 才能打开该菜单。自定义权限通过服务器使用的权限插件授予。

## Spigot 命令范围

Spigot 使用本页的通用命令。它通过准星操作菜单，无法通过 `mode` 切换为鼠标模式；也不提供资源包、模板、编辑、预览及动画管理命令。修改配置后使用 `/arcmenu reload`，无需 `reload all`。

不同平台的配置路径和修改方式见[配置文件说明](/arcmenu-wen-dang/pei-zhi-yu-guan-li/configuration-files.md)。

## 下一步

继续阅读[平台与插件兼容性](/arcmenu-wen-dang/pei-zhi-yu-guan-li/compatibility.md)，确认菜单所需功能及插件联动条件。