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

# FAQ

### `/kit create default boxing` не работает

Нужен displayName:

```
/kit create default boxing Boxing
```

Потом сохраните инвентарь:

```
/kit setinv default boxing
```

### Команда с `set` и `spawn1` не работает

Такой команды нет. Правильно:

```
/arena duel pos1 arena1
/arena duel pos2 arena1
/arena duel posarena1 arena1
/arena duel posarena2 arena1
```

`pos1/pos2` — спавны игроков, `posarena1/posarena2` — границы.

### `/arena duel create arena1` не работает

Нужно название:

```
/arena duel create arena1 Arena 1
```

### Матч не стартует

Проверьте:

1. Два игрока стоят в одной очереди.
2. Для `/queue` есть `kits/Default/<kit>.yml`.
3. Для `/ratingqueue` есть `kits/Rating/<kit>.yml`.
4. Есть свободная duel-арена.
5. У арены есть `pos1`, `pos2`, `posarena1`, `posarena2`.
6. Все точки в одном мире.
7. У игроков есть `kastfight.queue`.

### FFA пишет, что нет арены

Минимальная настройка:

```
/arena ffa create ffa1 FFA 1
/arena ffa posarena1 ffa1
/arena ffa posarena2 ffa1
/ffa setspawn 1 ffa1
```

И нужен FFA-кит:

```
/kit create ffa boxing Boxing FFA
/kit setinv ffa boxing
```

### Рейтинг закрыт

Проверьте:

```yaml
rating:
  unlock:
    enabled: true
    required_matches: 20
    require_wins: false
    required_wins: 10
```

Плейсхолдеры:

```
%kastfight_rating_unlock_matches_left%
%kastfight_rating_unlock_wins_left%
%kastfight_rating_unlocked%
```

### Плейсхолдеры не работают

Проверьте PlaceholderAPI, правильный формат `%kastfight_...%`, id кита и наличие игрок-контекста.

### В TAB ранг пустой

Используйте:

```
%kastfight_rank_title_total%
```

У игрока должен быть общий Elo. Можно выставить:

```
/fight rank <ник> <порог>
```

Порог должен существовать в `rating.total-ranks.default`.

### В меню не виден кит

* `gui_queue.yml` показывает `default`.
* `gui_ratingqueue.yml` показывает `rating`.
* `gui_ffa.yml` показывает `ffa`.

Ещё проверьте `/kit setinv <mode> <id>` и `/fight reload`.

### Игрок не может выйти из FFA

Скорее всего он в combat-tag. Время задаётся тут:

```yaml
ffa:
  combat:
    duration-seconds: 30
```

### После reload игроков выкинуло из FFA

Это настройка:

```yaml
ffa:
  on-plugin-reload:
    kick-to-spawn: true
    remove-kit: true
```

### Скорборд конфликтует с другим плагином

Отключите хаб-скорборд:

```yaml
scoreboards:
  hub-enabled: false
```

Или весь скорборд KastFight:

```yaml
scoreboards:
  enabled: false
```

### Команда не существует

Проверьте `aliases.yml`. Публичные команды вроде `/queue`, `/arena`, `/kit` создаются как алиасы внутренних команд.

### Нет прав

Проверьте через LuckPerms:

```
/lp user <ник> permission check kastfight.queue
```

Для арен нужны и базовый доступ, и право действия:

```
kastfight.internal.arena
kastfight.arena.create
kastfight.arena.set
kastfight.arena.delete
```

### После изменения конфига ничего не поменялось

```
/fight reload
```

Если меняли `plugin.yml` или jar, нужен restart сервера.


---

# 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/faq.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.