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

# 第一个菜单

本教程介绍如何创建一个带标题和按钮的基础菜单。玩家右键点击按钮后，会收到一条聊天消息。

示例适用于 Paper、Folia、Leaf 和 Spigot，不需要资源包或额外插件。

## 准备工作

完成[插件安装](/arcmenu-wen-dang/ru-men/install.md)，确认可以打开内置示例菜单。配置检查和重载需要 OP 或 `arcmenu.admin` 权限。

本教程新增菜单，不替换内置示例，也不修改主菜单设置。

## 创建菜单文件

根据所用服务端，在以下目录创建 `welcome.yml`：

| 服务端                | 文件路径                                       |
| ------------------ | ------------------------------------------ |
| Paper、Folia、Leaf 等 | `plugins/ArcMenu/menus/welcome.yml`        |
| Spigot             | `plugins/ArcMenu/spigot/menus/welcome.yml` |

将以下完整配置写入文件并保存：

```yaml
schema-version: 1
id: welcome
permission: arcmenu.use

canvas:
  width: 320
  height: 180
  pixels-per-block: 42.7
  distance: 3

frontend:
  background:
    type: rectangle
    width: 140
    height: 80
    color: '#182031'
    opacity: 235
  title:
    type: text
    content: '&fWelcome'
    offset: {y: 24, z: 1}
    size: 5
  description:
    type: text
    content: '&7Right-click the button below.'
    offset: {y: 4, z: 1}
    size: 3
  greeting-button:
    type: rectangle
    width: 60
    height: 18
    color: '#365E91'
    offset: {y: -20, z: 1}
  greeting-label:
    type: text
    content: '&fSay hello'
    offset: {y: -20, z: 2}
    size: 4

backend:
  greeting-area:
    x: 0
    y: -20
    width: 60
    height: 18
    actions:
      right:
        - 'tell: &aWelcome to the server!'
```

{% hint style="info" %}
YAML 使用空格缩进，不要使用 Tab。复制配置时应保留缩进和引号，并确认文件扩展名为 `.yml`。
{% endhint %}

## 检查并加载菜单

保存文件后，依次执行：

```
/arcmenu validate
/arcmenu reload
```

如提示配置错误，根据提示检查文件与字段，修正后重新执行。重载成功后，可打开新菜单：

```
/arcmenu open welcome
```

命令中的 `welcome` 对应配置里的 `id`。

## 操作验证

1. 确认菜单中显示标题、说明文字和按钮。
2. Paper、Folia、Leaf 等服务端使用触摸模式时，以视线指向按钮；Spigot 使用准星指向按钮。
3. 右键点击按钮，确认聊天栏出现欢迎消息。
4. 执行 `/arcmenu close` 关闭菜单。

在 Paper 系服务端上，玩家需落地后打开菜单。本教程可直接使用默认的触摸模式；Spigot 无需切换操作方式。

## 简单修改

可修改 `frontend` 下 `title` 的 `content`，更改菜单标题；也可修改按钮动作中 `tell:` 后的文字，更改点击时显示的消息。修改时保留原有缩进和引号。

保存后执行 `/arcmenu reload`，重新打开菜单并检查效果。

## 下一步

继续阅读[配置文件说明](/arcmenu-wen-dang/pei-zhi-yu-guan-li/configuration-files.md)，了解各类设置的用途及修改后的生效方式。菜单顶层字段见[菜单文档结构](/arcmenu-wen-dang/cai-dan-pei-zhi/menus.md)。