> 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/ru-men/requirements.md).
# 运行要求
在部署 ArcMenu Premium 之前，可以根据下方说明确认服务端的运行环境，并了解不同客户端模式与联动插件的搭配方式。
## 服务端与 Java
| 服务端代际 | Java 版本要求 |
| -------------- | ------------- |
| Paper 1.21.x 系 | Java 21 或更高版本 |
| Paper 26.x 系 | Java 25 或更高版本 |
Leaf、Folia、Purpur 等 Paper 衍生服务端与 Paper 共用同一个插件 JAR，拥有全部功能；在 Folia 上运行时，插件会自动在玩家所属的区域线程内处理展示实体与交互。
## 玩家客户端与输入模式
玩家进入服务器后可以使用三种交互模式，服务器既可以让玩家自由切换，也可以在配置中指定默认模式：
* **触控模式（Touch）**：无需安装客户端模组，也不依赖 ArcMenu 的着色器资源。菜单采用原版展示实体渲染，大小随玩家 FOV 自然变化，遵循正常的世界光照与方块遮挡，玩家开启各类光影包时也能保持原汁原味的游戏画面。
* **鼠标模式（Mouse）**：无需安装客户端模组。客户端加载配套的 ArcMenu 资源包后，即可获得固定 FOV 画面、平面物品光照与本地平滑光标。配合 ViaVersion 使用时，服务端会根据玩家实际的客户端协议版本自动匹配资源。
* **Vision 模式**：需在客户端安装 Fabric、对应游戏版本的 Fabric API 以及与当前客户端版本匹配的 **ArcMenu Editor** 模组。Vision 直接集成在 Editor 模组中，普通玩家安装后无需管理员权限即可使用。它在本地提供零延迟的原生光标移动、固定 FOV 投影、独立深度遮挡与明亮的 UI 物品渲染，同时兼容第三方光影包；在输入文本时还能通过原生文本输入直接调用系统输入法，无需打开原版铁砧界面。
三种模式的点击判定、悬停检测与菜单动作均由服务端统一处理。
## 按需搭配的联动插件
以下插件均为可选扩展，按服务器功能需求安装即可：
| 插件 | 在 ArcMenu 中的作用 |
| -------------- | ---------------------------------------------------------- |
| PlaceholderAPI | 在文本、图片路径、玩家头颅材质或条件判断中读取在线人数、等级、属性等变量。 |
| Vault（需搭配经济插件） | 在菜单条件中检查金币余额，或在点击动作里执行扣费与奖励。 |
| PlayerPoints | 检查点券数量或执行点券扣除与发放。 |
| CraftEngine | 在菜单中展示 CE 自定义物品，并在生成资源包时自动合入 ArcMenu 的图片与字体资源。 |
| Nexo | 展示 Nexo 自定义物品，并在生成资源包时自动将 ArcMenu 资源合入 Nexo 资源包。 |
| ItemsAdder | 展示 ItemsAdder 自定义物品，保留原有元数据与 overlay 并在打包时自动合入 ArcMenu 资源。 |
## 客户端编辑器与 Vision 模组
[ArcMenu Editor](https://github.com/FENTAIIII/ArcMenu-Editor/releases) 是与服务端配套的客户端 Fabric 模组。拥有管理权限的用户可以用它打开菜单可视化编辑器、Effect 过场动画工作区、项目管理器与菜单市场，并在编辑器内使用独立菜单渲染预览；普通玩家安装后即可启用 Vision 模式。
发布页提供了适配各 Minecraft 版本的独立构建（1.21.x 客户端需使用 Java 21+，26.x 客户端需使用 Java 25+）。安装时只需挑选文件名中 `mc` 版本号与你当前游戏客户端一致的那一个 JAR 放入客户端 `mods/` 目录，并搭配对应版本的 Fabric API，切勿同时放入多个版本的 Editor JAR。遇到版本升级或排查问题时，请将服务端插件与客户端 Editor 一并更新至最新发布版本。
---
# 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/ru-men/requirements.md?ask=&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.
