> 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/readme.md).
# ArcMenu Premium
为你的 Minecraft 服务器，做一套真正属于它的界面。
ArcMenu 可以把文字、图片、GIF、物品模型和动画组合成游戏内界面。从服务器导航、商店、签到和任务，到登录、公会、副本剧情与音乐播放器，都可以拥有统一的视觉语言与交互方式。触控与 Mouse 模式无需客户端安装模组；玩家也可以安装 ArcMenu Editor 模组开启 Vision 模式。
## 用它做什么
* **自由排版与复用**：在同一块画布上安排文字、图片、物品、方块、矩形背景、边框与线条，支持多层嵌套分组和可复用的组件模板。
* **三种输入模式**：触控模式通过准星视线指向，保留原版世界光照与遮挡，开启光影也能正常游玩；Mouse 模式借助服务器资源包提供固定视角与本地光标；Vision 模式集成于 ArcMenu Editor 模组中，提供兼容光影的原生光标、固定 FOV 与独立菜单渲染。
* **多维点击与反馈**：每个按钮区域都可以分别响应左键、右键、中键以及 Shift 组合点击，鼠标或准星悬停时还能弹出自定义提示框并触发悬停动画。
* **菜单导航与条件逻辑**：点击按钮即可执行指令、跳转到其他菜单或返回上一页，还能根据玩家权限、经济数据或数学表达式决定显示内容与跳转方向。
* **动态内容与自定义材质**：在界面上实时显示玩家头颅、PlaceholderAPI 占位符数据，直接展示 CraftEngine、Nexo 或 ItemsAdder 的自定义物品模型，支持为图片染色或播放 GIF 动图。
* **关键帧动画与过场演出**：为菜单配置进入、切换与退出过渡，或使用 Effect 制作带音频波形预览、三次贝塞尔曲线、关键帧和事件轨道的过场画面。
* **所见即所得的游戏内编辑**：管理员安装与客户端版本匹配的 ArcMenu Editor 后，可以在真实的 16:9 游戏视口旁直接拖拽排版、管理图层、浏览资源包图片库、撤销修改并即时保存。
* **项目打包与菜单市场**：通过工作区将菜单、模板、图片和 Effect 打包成 ArcPack 归档，支持在编辑器内直接浏览菜单市场、下载现成作品或发布自己的设计。
* **开放的应用 API**：开发者可以把背包、卡牌、音乐、社交或登录系统接入 ArcMenu，由插件自己管理业务数据，把屏幕、指针输入、文本输入组件（Arcitx）和页面返回栈交给 ArcMenu 托管。
## 开始使用
准备启动服务器前，可以先查看[运行要求](/ru-men/requirements.md)了解服务端运行环境、客户端交互模式与联动插件的搭配方式，再按照[安装与更新](/ru-men/install.md)把插件放进服务器并完成资源包配置。
如果你习惯先从配置文件入手理解结构，可以跟着[第一个菜单](/ru-men/first-menu.md)亲手写出一份带按钮的欢迎界面，随后在[菜单文档结构](/cai-dan-pei-zhi/menus.md)中查阅完整的 YAML 写法。
日常制作和排版界面时，推荐搭配 **ArcMenu Editor** 客户端模组直接在游戏画面里拖拽调整，具体用法见[可视化编辑器](/gong-neng-pei-zhi/editor.md)与[项目管理器](/gong-neng-pei-zhi/projects.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/readme.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.
