> For the complete documentation index, see [llms.txt](https://docs.myarc.icu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myarc.icu/pei-zhi-yu-guan-li/commands-permissions.md).

# 命令与权限

ArcMenu 的所有操作都集中在主命令 `/arcmenu` 下，并在游戏内提供完整的 Tab 自动补全。下文中 `<参数>` 代表必须填写的内容，`[参数]` 代表可选填写的内容。

## 玩家命令

这些命令供普通玩家在日常游玩时打开菜单、调整个人操作偏好或浏览内容。

| 命令                                             | 所需权限                   | 用途与参数说明                                                                                                                        |
| ---------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `/arcmenu open <菜单ID>`                         | `arcmenu.use` 及菜单自身权限  | 打开指定 ID 的菜单（如 `/arcmenu open main` 打开默认主菜单），也可打开已注册的扩展路由。                                                                      |
| `/arcmenu close`                               | 无限制                    | 关闭自己当前打开的菜单、Effect 动画或编辑界面。                                                                                                    |
| `/arcmenu mode`                                | `arcmenu.use`          | 查看自己当前生效的操作模式以及服务器的全局输入策略。                                                                                                     |
| `/arcmenu mode <touch\|mouse\|vision>`         | `arcmenu.use`          | 切换操作模式。可填 `touch`（触控）、`mouse`（鼠标）或 `vision`（需客户端安装对应游戏版本的 ArcMenu Editor 模组）；同时兼容旧名 `/arcmenu mouse` 及参数 `crosshair`、`cursor`。 |
| `/arcmenu sensitivity [set\|add\|clear] [数值]`  | `arcmenu.use`          | 查看或调整个人鼠标灵敏度，不会改动服务器全局配置。不填参数查看当前等级与倍率；`set <1..9>` 直接设置等级（默认 5 级）；`add <增量>` 在当前等级上增减（如 `1` 或 `-1`）；`clear` 恢复默认的 5 级。        |
| `/arcmenu cursor-scale [set\|add\|clear] [数值]` | `arcmenu.use`          | 查看或调整个人光标大小。参数用法与 `sensitivity` 完全一致，支持 `1` 到 `9` 级调节与 `clear` 重置。                                                             |
| `/arcmenu effect <EffectID>`                   | `arcmenu.effect` 及项目权限 | 播放指定 ID 的 Effect 过场动画。                                                                                                         |
| `/arcmenu effect <stop\|pause\|resume>`        | `arcmenu.effect`       | 停止（`stop`）、暂停（`pause`）或继续（`resume`）自己正在播放的 Effect。                                                                             |
| `/arcmenu market`                              | `arcmenu.market`       | 在游戏内打开 ArcPack 菜单市场界面（需安装配套 Editor 客户端，也可输入别名 `/arcmenu marketplace`）。                                                         |

要打开一个菜单，玩家需要同时拥有默认的 `arcmenu.use` 权限和该菜单里面配置的 `permission` 权限。关于个人灵敏度、光标缩放倍率以及对应的占位符，可以查看[触控、鼠标与 Vision 输入](/gong-neng-pei-zhi/input-modes.md)。

## 管理员命令

以下命令需要 `arcmenu.admin` 权限（默认授予服务器 OP）。

### 菜单控制与日常维护

| 命令                                  | 控制台可用 | 用途与参数说明                                                                      |
| ----------------------------------- | ----- | ---------------------------------------------------------------------------- |
| `/arcmenu force-open <菜单ID> <在线玩家>` | 是     | 为指定的在线玩家打开菜单。此命令会跳过本次打开的 `arcmenu.use` 与菜单 `permission` 权限检查，但不会修改玩家原本拥有的权限。 |
| `/arcmenu refresh <在线玩家> [元素ID]`    | 是     | 立即刷新目标玩家当前打开菜单中的占位符与动态内容。省略 `[元素ID]` 时刷新整份菜单，填写具体元素 ID 时只刷新该元素。              |
| `/arcmenu reload`                   | 是     | 重载 `config.yml`、`offset.yml`、`tooltip.yml`、语言文件、所有菜单与动画配置。                   |
| `/arcmenu reload all`               | 是     | 执行完整重载：除包含 `reload` 的全部内容外，还会重载 `templates/` 模板并重新构建 ArcMenu 资源包。            |
| `/arcmenu resources`                | 是     | 重新扫描图片、GIF 与光标配置并构建资源包（也可使用别名 `/arcmenu resourcepack`）。                      |
| `/arcmenu validate`                 | 是     | 检查所有菜单、动画、模板与配置文件的语法和几何规则是否合法，只输出结果，不改动当前运行状态。                               |
| `/arcmenu list`                     | 是     | 列出当前已成功加载的所有菜单 ID。                                                           |
| `/arcmenu templates`                | 是     | 列出当前已加载的所有前端模板 ID。                                                           |
| `/arcmenu status`                   | 是     | 查看插件运行状态摘要，包含已加载菜单数、动画轨道数、图片数、模板数、活跃会话数、展示实体数、输入策略及编辑协议版本。                   |
| `/arcmenu update`                   | 是     | 立即连接版本清单检查是否有新版本发布，仅提示版本号。                                                   |

### 编辑、项目管理与市场安装

| 命令                                            | 控制台可用 | 用途与参数说明                                                        |
| --------------------------------------------- | ----- | -------------------------------------------------------------- |
| `/arcmenu edit <菜单ID>`                        | 否     | 在可视化编辑器中打开指定菜单（也可使用别名 `/arcmenu editor`）。                      |
| `/arcmenu edit <新菜单ID> create [源菜单ID]`        | 否     | 新建一份空白菜单并打开编辑器；如果填写了 `[源菜单ID]`，则会复制源菜单的内容作为新菜单的起点。             |
| `/arcmenu projects`                           | 否     | 打开可视化项目管理器（也可使用别名 `/arcmenu project`）。                         |
| `/arcmenu download pack <包ID> [版本]`           | 是     | 直接从菜单市场下载并安装指定的 ArcPack。省略 `[版本]` 时自动安装最新版。                    |
| `/arcmenu preview <菜单ID> [frontend\|backend]` | 否     | 在游戏内打开菜单的管理员预览。默认 `frontend` 查看前端画面，填 `backend` 可直观查看后端点击交互区域。 |

### 动画、Effect 与性能诊断

| 命令                                             | 控制台可用 | 用途与参数说明                                                                                            |
| ---------------------------------------------- | ----- | -------------------------------------------------------------------------------------------------- |
| `/arcmenu editeffect [EffectID] [源菜单ID]`       | 否     | 打开 Effect 编辑器。可打开已有项目、新建空白项目，或基于 `[源菜单ID]` 的画面创建 Effect。                                           |
| `/arcmenu effect <EffectID> <在线玩家>`            | 是     | 为指定的在线玩家播放 Effect 过场动画。                                                                            |
| `/arcmenu effect <stop\|pause\|resume> <在线玩家>` | 是     | 停止、暂停或继续目标玩家的 Effect 播放。                                                                           |
| `/arcmenu effect list`                         | 是     | 列出当前已加载的所有 Effect 项目 ID。                                                                           |
| `/arcmenu effect effect reload`                | 是     | 重新加载 `effects/` 目录下的所有 Effect 项目（实际输入 `/arcmenu effect reload`）。                                   |
| `/arcmenu animations`                          | 是     | 在游戏内执行时查看自己当前菜单可用的动画轨道；在控制台执行时列出全服所有菜单配置的动画轨道 ID。                                                  |
| `/arcmenu animate <动画ID>`                      | 否     | 在自己当前打开的菜单上播放指定的动画轨道。                                                                              |
| `/arcmenu stop-animation <动画ID>`               | 否     | 停止自己当前菜单上正在播放的指定动画轨道。                                                                              |
| `/arcmenu pointer`                             | 否     | 查看自己当前菜单会话的光标指向坐标与命中诊断信息。                                                                          |
| `/arcmenu pointer debug [on\|off]`             | 否     | 开启（`on`，省略时默认开启）或关闭（`off`）本地光标诊断显示，并在聊天栏与后台输出当前光标及平面光照状态。                                          |
| `/arcmenu performance [reset]`                 | 是     | 查看插件性能统计报告（涵盖每 Tick 耗时、矩阵与元数据写入/跳过率、实体生成与销毁、活跃会话及上下行带宽估算）；填 `reset` 可重置统计数据（支持别名 `/arcmenu perf`）。 |

## 权限说明

| 权限节点                  | 默认归属         | 说明                                          |
| --------------------- | ------------ | ------------------------------------------- |
| `arcmenu.use`         | 所有玩家         | 允许打开并使用普通菜单、切换操作模式、调整个人灵敏度与光标大小。            |
| `arcmenu.effect`      | 所有玩家         | 允许播放和控制自己的 Effect 过场动画。                     |
| `arcmenu.effect.exit` | 默认不授予（false） | 允许玩家在观看 Effect 过场动画期间，按 Shift+F 或跳跃键主动退出播放。 |
| `arcmenu.market`      | 所有玩家         | 允许使用已验证的正版 Minecraft 账号打开并浏览 ArcPack 菜单市场。  |
| `arcmenu.admin`       | OP           | 允许使用所有管理、重载、校验、编辑器、项目管理器、强制打开、刷新、下载与诊断命令。   |

当你在某份菜单的 YAML 根部设置了 `permission: myserver.menu.vip` 时，玩家需要同时拥有 `arcmenu.use` 和 `myserver.menu.vip` 才能打开它。如果你希望玩家在缺少 `myserver.menu.vip` 时自动进入另一份引导或提示菜单，可以在菜单里配合配置 `permission-denied-menu`，具体写法见[菜单文档结构](/cai-dan-pei-zhi/menus.md)。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myarc.icu/pei-zhi-yu-guan-li/commands-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.