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

## Описание

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

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

## Установка

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

{% file src="<https://2259704643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWX2ATrGwog58tMqyv49G%2Fuploads%2FJt9WHTvhycbbTsxtQRet%2Fcommand_list.cock?alt=media&token=285b39b6-5498-48d3-9dbf-2c7e3e1529db>" %}

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="https://2259704643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWX2ATrGwog58tMqyv49G%2Fuploads%2FyhSA60EGgj9Bj8k3iLRc%2Fimage.png?alt=media&#x26;token=5615009e-242f-4917-af0e-330c448e126d" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://2259704643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWX2ATrGwog58tMqyv49G%2Fuploads%2F4cZJU9JtDIafGkzMERSc%2Fimage.png?alt=media&#x26;token=24359c87-ff22-4849-85fa-37106d7f735b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2259704643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWX2ATrGwog58tMqyv49G%2Fuploads%2FEsgOnAcM29wAZ2OoUPxI%2Fimage.png?alt=media&#x26;token=bc010945-f948-487f-b142-1806706d0952" 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="https://2259704643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWX2ATrGwog58tMqyv49G%2Fuploads%2F5FpR74OrxySSqVIZDKmU%2Fimage.png?alt=media&#x26;token=31160fb1-7540-4160-abfe-ec315f3cf642" alt=""><figcaption></figcaption></figure>

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

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

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