# 底部按钮 (Bottom)

`Bottom` 节点定义菜单底部的交互按钮区域，共有三种布局模式。

***

## 配置结构

```yaml
Bottom:
  type: '模式类型'   # notice | confirmation | multi
  # 模式专属配置...
```

***

## 三种布局模式

### notice - 单按钮模式

只显示一个确认按钮，适合信息展示或简单触发操作。

**配置项：**

| 字段                | 说明               |
| ----------------- | ---------------- |
| `confirm.text`    | 按钮文字，支持颜色代码和条件判断 |
| `confirm.width`   | 可选，按钮宽度（1-1024）  |
| `confirm.actions` | 点击时执行的动作列表       |

**示例：**

```yaml
Bottom:
  type: 'notice'
  confirm:
    text: '&a[ 领取奖励 ]'
    actions:
      - 'console: give %player_name% diamond 1'
      - 'tell: &a你已领取钻石！'
      - 'sound: entity.player.levelup'
```

***

### confirmation - 确认/取消双按钮模式

显示确认和取消两个按钮，适合需要二次确认的危险操作。

**配置项：**

| 字段                | 说明                |
| ----------------- | ----------------- |
| `confirm.text`    | 确认按钮文字，支持条件判断     |
| `confirm.width`   | 可选，确认按钮宽度（1-1024） |
| `confirm.actions` | 点击确认时执行的动作列表      |
| `deny.text`       | 取消按钮文字，支持条件判断     |
| `deny.width`      | 可选，取消按钮宽度（1-1024） |
| `deny.actions`    | 点击取消时执行的动作列表      |

**示例：**

```yaml
Bottom:
  type: 'confirmation'
  confirm:
    text: '&a[ 确认购买 ]'
    actions:
      - 'console: eco take %player_name% 100'
      - 'console: give %player_name% diamond_sword 1'
      - 'tell: &a购买成功！'
      - 'sound: entity.experience_orb.pickup'
  deny:
    text: '&c[ 取消 ]'
    actions:
      - 'tell: &7已取消购买。'
      - 'sound: block.note_block.bass'
```

***

### multi - 多按钮矩阵模式

支持多个自定义按钮，以矩阵方式排列，可额外配置一个退出按钮。

**配置项：**

| 字段        | 类型    | 默认值 | 说明                    |
| --------- | ----- | --- | --------------------- |
| `columns` | `Int` | `2` | 每行显示的按钮列数             |
| `buttons` | 节点    | —   | 按钮列表（按 YAML 书写顺序排列）   |
| `exit`    | 节点    | —   | 可选的退出/返回按钮（显示在按钮列表末尾） |

**按钮配置项：**

| 字段               | 类型          | 说明                                     |
| ---------------- | ----------- | -------------------------------------- |
| `show-condition` | String      | 可选，按钮显示条件；条件不满足时该按钮不显示                 |
| `text`           | String/List | 按钮文字，支持颜色代码、条件判断和 MiniMessage 标签       |
| `width`          | Int         | 可选，按钮宽度（1-1024），不设置则使用默认宽度             |
| `tooltip`        | List        | 可选，按钮悬停提示（每行一个字符串），支持颜色代码和 MiniMessage |
| `actions`        | List        | 可选，点击时执行的动作列表；如果不设置则点击时无反应             |

**退出按钮配置项：**

| 字段        | 类型          | 说明                                 |
| --------- | ----------- | ---------------------------------- |
| `text`    | String/List | 退出按钮文字，支持颜色代码、条件判断和 MiniMessage 标签 |
| `width`   | Int         | 可选，退出按钮宽度（1-1024）                  |
| `actions` | List        | 可选，点击时执行的动作列表；如果不设置则点击时无反应         |

**示例：**

```yaml
Bottom:
  type: 'multi'
  columns: 3

  buttons:
    btn_shop:
      text: '&6[ 商店 ]'
      actions:
        - 'open: shop/main'

    btn_profile:
      text: '&b[ 个人信息 ]'
      actions:
        - 'open: profile'

    btn_settings:
      text: '&7[ 设置 ]'
      actions:
        - 'open: settings'

    btn_admin:
      text: '&4[ 管理面板 ]'
      actions:
        - 'open: admin/tools'

  exit:
    text: '&8[ 关闭 ]'
    actions:
      - 'actionbar: &7菜单已关闭'
      - 'close'
```

在 Multi 模式下，还可以使用 `show-condition` 来控制按钮是否显示：

```yaml
Bottom:
  type: multi
  columns: 2
  buttons:
    1:
      show-condition: "%player_is_op% == true"  # 只有管理员才能看到此按钮
      text: '[ 管理员按钮 ]'
      actions: ...
    2:
      show-condition: "%player_level% >= 10"  # 玩家大于等于 10 级才能看到
      text: '[ VIP 按钮 ]'
      actions: ...
    3:
      text: '[ 普通按钮 ]'  # 无显示条件，所有玩家可见
      actions: ...
```

***

## 条件判断按钮文字

所有按钮的 `text` 字段均支持条件判断：

```yaml
Bottom:
  type: 'confirmation'
  confirm:
    text:
      - condition: "%player_level% >= 10"
        allow: '&6[ VIP 确认 ]'
        deny: '&a[ 确认 ]'
    actions:
      - 'tell: &a已确认'
  deny:
    text: '&c[ 取消 ]'
    actions:
      - 'tell: &7已取消'
```

关于条件判断的完整语法，请参阅 [🔍 条件判断](/plugins/kamenu-cn/menu/conditions.md)。

***

## 按钮宽度 (width)

所有按钮都支持自定义宽度配置，通过 `width` 字段可以控制按钮的显示宽度。

**适用范围：**

* `notice` 模式的确认按钮（`confirm.width`）
* `confirmation` 模式的确认和取消按钮（`confirm.width` 和 `deny.width`）
* `multi` 模式的所有按钮（`buttons` 中的每个按钮和 `exit` 按钮）

**宽度值：**

* 范围：1 - 1024
* 不设置则使用默认宽度（由 Paper Dialog API 决定）
* 支持条件判断

**示例：**

```yaml
# notice 模式
Bottom:
  type: 'notice'
  confirm:
    text: '&a[ 确认 ]'
    width: 200
    actions:
      - 'tell: &a确认操作'

# confirmation 模式
Bottom:
  type: 'confirmation'
  confirm:
    text: '&a[ 确认 ]'
    width: 200
    actions:
      - 'tell: &a确认操作'
  deny:
    text: '&c[ 取消 ]'
    width: 100
    actions:
      - 'tell: &c取消操作'

# multi 模式
Bottom:
  type: 'multi'
  columns: 2

  buttons:
    wide_button:
      text: '&a[ 宽按钮 ]'
      width: 200
      actions:
        - 'tell: &a这是一个宽按钮'

    narrow_button:
      text: '&b[ 窄按钮 ]'
      width: 50
      actions:
        - 'tell: &b这是一个窄按钮'

    conditional_width:
      text: '&c[ 条件宽度 ]'
      width:
        - condition: '%player_is_op% == true'
          allow: 200
          deny: 100
      actions:
        - 'tell: &c按钮宽度根据权限变化'

  exit:
    text: '&8[ 退出 ]'
    width: 80
    actions:
      - 'close'
```

**注意：**

* 宽度值会影响按钮在界面上的实际显示尺寸
* 过大的宽度可能导致按钮超出屏幕
* 建议根据实际显示需求调整宽度值


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://katacr.gitbook.io/plugins/kamenu-cn/menu/bottom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.