> 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/ru-men/install.md).

# 安装与更新

本页介绍 Paper、Folia、Leaf 等服务端，以及 Spigot 的安装方法。安装前，请确认服务端与 Java 版本符合[运行要求](/arcmenu-wen-dang/ru-men/requirements.md)。

## 安装步骤

两类服务端使用同一个 ArcMenu 插件文件。

1. 关闭服务端。
2. 将 ArcMenu 插件 `.jar` 文件放入服务端的 `plugins/` 目录。
3. 如已安装 ArcMenu，移除旧的 `.jar` 文件，确保目录中仅保留一个 ArcMenu 插件文件。
4. 启动服务端，检查控制台是否出现报错。
5. 按下方对应服务端的说明，确认配置文件并打开示例菜单。

## Paper、Folia 与 Leaf

### 首次启动

插件会在 `plugins/ArcMenu/` 中生成配置文件和示例菜单。需要占位符、经济或自定义物品功能时，可安装相应的[可选插件](https://simple.superiormc.cn/arcmenu-wen-dang/ru-men/pages/WTHrY18aDjS0acrYGoiM#可选插件)。

| 路径               | 用途                |
| ---------------- | ----------------- |
| `config.yml`     | 语言、快捷键和操作方式等基本设置。 |
| `menus/`         | 菜单配置。             |
| `images/`        | 菜单使用的 PNG 图片。     |
| `templates/`     | 可复用的菜单组件。         |
| `animations.yml` | 菜单动画。             |
| `tooltip.yml`    | 提示框样式。            |
| `languages/`     | 插件提示文字。           |

以上路径均相对于 `plugins/ArcMenu/`。可参考 `menus/example.yml` 与游戏中的示例菜单了解配置内容。

### 示例菜单

使用 OP 账号进入游戏，在地面上执行：

```
/arcmenu open example
```

默认可使用 **Shift+F** 打开或关闭主菜单。关闭菜单也可执行：

```
/arcmenu close
```

{% hint style="info" %}
玩家需要落地后才能打开菜单。移动、传送或死亡会关闭菜单；站在原地转动视角不会关闭。
{% endhint %}

### 资源包配置

菜单使用自定义图片时，玩家需要加载 ArcMenu 资源包。

**已安装 CraftEngine：** 修改图片或相关配置后，按顺序执行：

```
/arcmenu reload all
/ce reload all
```

CraftEngine 会将 ArcMenu 资源合并到自己的资源包中。等待重建完成后，将更新后的资源包分发给玩家。

**未安装 CraftEngine：** ArcMenu 生成的资源包位于：

```
plugins/ArcMenu/generated/arcmenu-resourcepack.zip
```

通过服务端的资源包设置分发该文件，或将其合并到已有资源包中。ArcMenu 不会自动向玩家发送该文件。

{% hint style="info" %}
玩家接受并加载资源包后，菜单图片才能正常显示。修改图片后，需要同时更新玩家使用的资源包。
{% endhint %}

### 操作方式

默认使用触摸模式，通过视线指向菜单按钮。玩家可执行以下命令切换：

```
/arcmenu mode touch
/arcmenu mode mouse
```

`touch` 为触摸模式，`mouse` 为鼠标模式。管理员强制指定操作方式后，玩家无法自行更改。使用鼠标模式前，请确认客户端符合[运行要求](/arcmenu-wen-dang/ru-men/requirements.md)，并加载配套资源包。

### 配置重载

| 命令                    | 用途                            |
| --------------------- | ----------------------------- |
| `/arcmenu validate`   | 检查菜单配置是否存在错误。                 |
| `/arcmenu reload`     | 重新加载菜单、动画等配置。                 |
| `/arcmenu reload all` | 重新加载配置并重建资源，适用于图片、模板或提示框样式修改。 |

重载成功后，当前打开的菜单会关闭。配置存在错误时，根据提示修正后重新执行重载。资源内容发生变化时，还需更新玩家使用的资源包。

## Spigot

### 首次启动

Spigot 需要 26.1 或更高版本。按照上方安装步骤放置插件后，首次启动时需保持服务端能够访问互联网，以便插件下载必要文件。如果下载失败，请检查网络连接后重新启动。

启动完成后，检查以下文件：

| 路径                                         | 用途        |
| ------------------------------------------ | --------- |
| `plugins/ArcMenu/config.yml`               | 插件提示语言设置。 |
| `plugins/ArcMenu/languages/`               | 插件提示文字。   |
| `plugins/ArcMenu/spigot/config.yml`        | 主菜单快捷键设置。 |
| `plugins/ArcMenu/spigot/menus/example.yml` | 示例主菜单。    |
| `plugins/ArcMenu/spigot/menus/details.yml` | 示例详情菜单。   |

自定义菜单应放入 `plugins/ArcMenu/spigot/menus/`，快捷键设置应修改 `plugins/ArcMenu/spigot/config.yml`。语言设置见[语言管理](/arcmenu-wen-dang/gong-neng-pei-zhi/languages.md)。

### 示例菜单

使用 OP 账号进入游戏，执行：

```
/arcmenu open example
```

通过准星指向菜单按钮进行操作。默认可使用 **Shift+F** 打开或关闭主菜单，也可执行以下命令关闭：

```
/arcmenu close
```

如需关闭主菜单快捷键，在 `plugins/ArcMenu/spigot/config.yml` 中设置：

```yaml
shortcuts:
  shift-f: false
```

修改后执行 `/arcmenu reload`。

### 配置重载

| 命令                  | 用途               |
| ------------------- | ---------------- |
| `/arcmenu list`     | 查看已加载的菜单。        |
| `/arcmenu validate` | 检查菜单配置是否存在错误。    |
| `/arcmenu reload`   | 重新加载菜单、快捷键和语言设置。 |

重载成功后，当前打开的菜单会关闭。配置存在错误时，根据提示修正后重新执行重载。

{% hint style="info" %}
Spigot 支持基础菜单，不支持鼠标模式、自定义图片、动画、提示框、可视化编辑器及运行要求中列出的可选插件联动。无需执行上方的资源包配置或鼠标模式切换步骤。完整说明见运行要求中的 Spigot 功能限制。
{% endhint %}

## 权限

普通玩家默认拥有 `arcmenu.use`，可打开菜单。如菜单设置了额外权限，玩家还需拥有对应权限。

配置检查、菜单列表和重载命令需要 `arcmenu.admin`，默认授予 OP。

## 插件更新

1. 备份整个 `plugins/ArcMenu/` 目录，包括 Spigot 配置（如有）。
2. 阅读更新说明，确认是否需要调整配置或更新编辑器。
3. 关闭服务端。
4. 移除旧插件 `.jar` 文件，放入新插件文件。
5. 启动服务端，检查控制台是否出现报错。
6. 打开菜单，验证按钮及已使用的功能是否正常。

已有配置通常会保留，需按更新说明进行调整。使用资源包的服务器如涉及资源更新，还需重新构建并分发资源包。

更换插件文件后必须重启服务端，`/arcmenu reload` 不能代替重启。

## 下一步

完成安装并确认示例菜单正常后，可按照[第一个菜单](/arcmenu-wen-dang/ru-men/first-menu.md)创建自定义菜单。