> 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/compatibility.md).

# 平台与插件兼容性

本页说明不同服务端的功能范围，以及菜单与其他插件配合使用时的注意事项。Minecraft、Java 和客户端版本要求见[运行要求](/arcmenu-wen-dang/ru-men/requirements.md)。

## 服务端功能

Paper、Folia、Leaf 等兼容的服务端支持完整菜单功能。Spigot 支持基础菜单，配置前应确认所需功能是否可用。

| 功能                                   | Paper、Folia、Leaf 等 | Spigot        |
| ------------------------------------ | ------------------ | ------------- |
| 文字、矩形背景、边框                           | 支持                 | 支持            |
| 原版物品和方块展示                            | 支持                 | 支持            |
| 准星或视线指向按钮                            | 支持                 | 支持            |
| 鼠标模式                                 | 支持                 | 不支持           |
| 菜单切换、返回、关闭                           | 支持                 | 支持            |
| 权限检查和基础条件判断                          | 支持                 | 支持            |
| 发送消息、执行玩家或控制台命令                      | 支持                 | 支持            |
| 自定义图片和 CraftEngine 物品                | 支持                 | 不支持           |
| 提示框和动画                               | 支持                 | 不支持           |
| 可复用模板                                | 支持                 | 不支持           |
| PlaceholderAPI、Vault、PlayerPoints 集成 | 支持                 | 不支持           |
| ArcMenu Editor 可视化编辑                 | 支持                 | 不支持           |
| 插件提示语言设置                             | 支持                 | 支持，使用根目录的语言设置 |

Spigot 的菜单文字、自定义消息仍可自行修改。其基础条件与动作支持范围较小，不能直接使用包含高级功能的 Paper 菜单。

两类服务端的菜单目录不同。切换服务端类型时，应按[配置文件说明](/arcmenu-wen-dang/pei-zhi-yu-guan-li/configuration-files.md)放置文件，并检查菜单使用的功能。

## 可选插件集成

本节中的直接集成适用于 Paper、Folia、Leaf 等服务端。安装可选插件后需重启服务端，并确认相关插件正常启用。

### PlaceholderAPI

用于在菜单中显示其他插件提供的信息。使用前应确认所需占位符可以正常解析；缺少相关插件或占位符支持时，菜单无法显示对应数据。

ArcMenu 自带的玩家名称、UUID 和坐标占位符不要求安装 PlaceholderAPI。Spigot 支持这些基础占位符，但不支持 PlaceholderAPI 提供的其他占位符。

### Vault 与 PlayerPoints

Vault 用于连接服务器的经济功能，除 Vault 外还需要兼容的经济插件。PlayerPoints 用于玩家点数功能。

菜单使用余额或点数相关操作前，应确认对应插件正常工作。安装 Vault 不会自动提供账户余额，也不会将菜单变成商店；交易内容和按钮操作仍需配置。

### CraftEngine

用于展示 CraftEngine 自定义物品，并将 ArcMenu 资源合并到 CraftEngine 的资源包。

使用自定义物品前，应确认物品已在 CraftEngine 中正确配置。更新菜单图片后，需要重新加载 ArcMenu 资源、重建 CraftEngine 资源包，并让玩家加载更新后的资源包。操作步骤见[资源包配置](https://simple.superiormc.cn/arcmenu-wen-dang/pei-zhi-yu-guan-li/pages/JfPbYFTL9xk7jR5CbVN6#资源包配置)。

未安装 CraftEngine 时，仍可使用 ArcMenu 的图片功能，但需要自行分发资源包。

### ViaVersion

使用 ViaVersion 允许其他客户端版本连接时，仍需确认玩家客户端符合 ArcMenu 的鼠标模式要求。能够连接服务器，不代表所有菜单功能都适用。

应使用实际允许进入服务器的客户端检查菜单显示、鼠标点击和资源包加载。客户端要求见[运行要求](https://simple.superiormc.cn/arcmenu-wen-dang/pei-zhi-yu-guan-li/pages/WTHrY18aDjS0acrYGoiM#客户端要求)。

## 通过命令连接其他插件

即使某个插件没有 ArcMenu 专用集成，也可以通过菜单按钮执行其命令。该方式在 Spigot 上同样可用。

配置前应确认：

* 目标插件已安装，命令可正常执行。
* 使用玩家命令时，玩家拥有目标命令要求的权限。
* 使用控制台命令时，目标命令支持控制台执行，并填写所需的玩家参数。

按钮执行其他插件命令，不代表 ArcMenu 提供了该插件的全部功能。第三方命令的参数、权限和使用限制应以该插件文档为准。

## 资源包与编辑器

### 服务器资源包

自定义图片需要玩家接受并加载资源包。如果服务器已有资源包，应将 ArcMenu 资源一并合并、分发。

菜单图片和鼠标显示异常时，先检查玩家是否加载了更新后的资源包。只在服务端重建资源包，不会自动更新玩家正在使用的内容。

### ArcMenu Editor

编辑器仅供管理员设计菜单，普通玩家无需安装。使用前应选择与管理员客户端及 ArcMenu 插件兼容的编辑器。

Spigot 不支持编辑器。将编辑器制作的菜单用于其他服务器时，还需确认目标服务器支持菜单使用的功能，并提供相应资源包。

## 使用前检查

首次启用菜单或更换服务端、插件、客户端及资源包后，应检查：

1. 配置检查与重载是否成功。
2. 菜单文字、物品和图片是否正常显示。
3. 点击区域、菜单切换和第三方命令是否正常。
4. 占位符、经济或点数操作是否符合配置。
5. 普通玩家是否拥有所需权限，并能加载资源包。

建议同时使用普通玩家账号检查权限，避免仅以 OP 账号测试。相关命令见[命令与权限](/arcmenu-wen-dang/pei-zhi-yu-guan-li/commands-permissions.md)。

## 下一步

阅读[菜单文档结构](/arcmenu-wen-dang/cai-dan-pei-zhi/menus.md)，按层级了解菜单配置。