> For the complete documentation index, see [llms.txt](https://kast1ent.gitbook.io/kast1ent-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kast1ent.gitbook.io/kast1ent-docs/kastfight/gui-i-menyu.md).

# GUI и меню

### Игровые меню

```
Menus/gui_queue.yml
Menus/gui_ratingqueue.yml
Menus/gui_ffa.yml
Menus/gui_kiteditor.yml
Menus/gui_kiteditor_default.yml
Menus/gui_kiteditor_rating.yml
Menus/gui_kiteditor_ffa.yml
Menus/gui_kit_preview.yml
Menus/gui_premium_choice.yml
Menus/gui_premium_queue.yml
Menus/gui_premium_ratingqueue.yml
Menus/gui_settings.yml
```

### Команды открытия

```
/queue
/ratingqueue
/ffa
/kiteditor
/kiteditor default
/kiteditor rating
/kiteditor ffa
/premiumqueue
/settings
```

### Как меню выбирает киты

* `gui_queue.yml` показывает `default`-киты.
* `gui_ratingqueue.yml` показывает `rating`-киты.
* `gui_ffa.yml` показывает `ffa`-киты.
* `gui_premium_queue.yml` показывает premium default.
* `gui_premium_ratingqueue.yml` показывает premium rating.
* `gui_kiteditor_*` открывает редактор личного набора.

### Базовый формат

```yaml
title: "&0☆ Дуэли"
size: 45
close_on_kit_select: true
sounds:
  open:
    name: UI_BUTTON_CLICK
    volume: 1.0
    pitch: 1.0
items:
  example:
    slot: 10
    material: DIAMOND_SWORD
    name: "&fНазвание"
    lore:
      - "&7Описание"
    commands:
      - "player:queue boxing"
```

Команды на кнопках пишутся без `/`:

```yaml
commands:
  - "player:queue boxing"
  - "console:say %player% clicked"
```

### Отдельная команда для меню

В коде есть регистрация команд меню. Если в yml добавить:

```yaml
open_command: duelsmenu
permission: kastfight.duelsmenu
```

то появится команда:

```
/duelsmenu
```

Если `permission` не указан, будет использовано `kastfight.<open_command>`.

### Админское меню

```
/ktkits
/fight admin
/kastfight admin
```

Право:

```
kastfight.admin.gui
```

Файл:

```
gui_admin.yml
```

### GUI-редактор

```
/fight guieditor <menuId>
/fight seteditor <menuId>
/fight menu <menuId>
```

`menuId` — имя без `gui_` и `.yml`, например `queue`, `ratingqueue`, `ffa`, `settings`.

### Verbose

```
/fight verbose <ник> on
/fight verbose <ник> off
```

Помогает понять, почему игрок не может открыть меню или нажать кнопку.

### Если кит не отображается

Проверьте:

1. Кит создан в правильном режиме.
2. Инвентарь сохранён через `/kit setinv`.
3. В меню хватает слотов.
4. YAML не сломан.
5. Выполнен `/fight reload`.


---

# 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 dynamically by asking a question.

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

```
GET https://kast1ent.gitbook.io/kast1ent-docs/kastfight/gui-i-menyu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.