# Автоматический список команд

## Описание

Когда дело доходит до списка команд, особенно если некоторые или большинство из них являются персональными, нам часто приходится собирать вручную Action, в котором будут перечислены все необходимые подсказки. Мы можем часто забывать обновлять их, и тем более все становится сложнее из-за привязке к группам и отдельным зрителям. 

Автоматический список команд полностью решает эту проблему, требуя от нас минимум усилий.

## Установка

1. Загрузите файл плагина

{% file src="/files/rnkcHfUssXvjnsq4J2Bx" %}

2. Далее в верхней части streamer.bot нажмите кнопку Import и перетащите файл в верхнюю область (Import String).  Вы увидите, что к импорту запланированы:

* 1 действие: `[Chat] Command List`

3. Добавьте к импортированному `[Chat] Command List` триггер любой команды, на которую вы хотите отравлять список команд

## Настройка

### Добавление подсказок

Откройте любой Action, который привязан в какой-либо команде чата. Добавьте в него комментарий (Core -> Misc -> Comment). В комментарий введите префикс `Description:` и любое описание.  После этого обязательно нажмите кнопку Save в streamer.bot

<figure><img src="/files/Ancb2FT5Rjg0KEKxq2F7" alt=""><figcaption></figcaption></figure>

Готово! Теперь эта команда будет автоматически выводиться в список доступных.

### Вывод только общих команд

Общие команды - это такие команды, которые доступны абсолютно всем зрителям. Обычно это ссылки на социальные сети и прочая информация.

Команда является общей, когда Grand Type установлен в Allow и в списке допущенных - пусто.

<figure><img src="/files/UHH6C6cY8TrVttk1rEh0" alt=""><figcaption></figcaption></figure>

Если вы хотите возвращать только общие команды (например, если у вас разные команды вывода списка), сделайте следующее:

1. Найдите Action \[Chat] Command List
2. Дважды нажмите на 2 Sub-Action (Execute Method) и во втором поле выберите `SendGeneralCommands`

<figure><img src="/files/Vjwtl9IGiF748IJR65Uz" alt=""><figcaption></figcaption></figure>

#### Альтернативное решение

Вы можете сделать отдельный Action для вывода списка команд. Для этого удалите триггер команды из \[Chat] Command List, создайте новый Action, добавьте туда триггер команды, и в SubAction выполните Core -> C# -> Execute C# Method. Выберите Command List и нужный вам метод отправки списка.

### Вывод только персональных команд

Персональные команды - это команды, доступные только конкретным зрителям, или группам зрителей.

По аналогии с [#vyvod-tolko-obshikh-komand](#vyvod-tolko-obshikh-komand "mention") перейдите в Action \[Chat] Command List, дважды кликните на второй SubAction и выберите `SendPersonalCommands` во втором пункте.

### Настройка сообщения, об отсутствии команд в списке

Если команд по какой-либо причине нет, то выведется сообщение по умолчанию: `Прости, но список команд пуст / Sorry, but there is no command`

Если вы хотите поменять его, сделайте следующее:

* В Action, где выполняется отправка списка команд, добавьте SetArgument (Core -> Argument -> Set Argument)
* В имя аргумента укажите `empty_commands_message`
* В значение аргумента укажите сообщение, которое вы хотите отправлять в таких ситуациях

<figure><img src="/files/xPFwICZXjkUtobYfWnDj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Обратите внимание, установка аргумента должна быть выполнена до вызова C# метода
{% endhint %}

## Отправка списка команд на другие платформы

Хотите добавить поддержку списка команд на VKPlay, Trovo и другие платформы? У меня хорошие новости, данный плагин уже поддерживает эту возможность. Все что вам нужно, это использовать интеграцию с [MiniChat](broken://spaces/zxg1LJV3Pzq903TWkRYu).


---

# 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:

```
GET https://docs.play-code.ru/plugins/catalog/avtomaticheskii-spisok-komand.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.