Настройки команды

Редактор команды разделен на вкладки: Действия, Поля вызова, Диагностика и Тест. Над вкладками — шапка с основными полями команды.

Основные поля

Поле	Описание	Ограничения
Имя	Имя для вызова через слэш: /dice	Латиница в нижнем регистре, цифры и _, до 32 символов. Уникально в чате и не совпадает со встроенными командами
Slash-команда	Показывать команду в меню Telegram, которое открывается по /	В меню помещается до 100 команд вместе со встроенными
Алиасы	Другие названия для вызова с префиксом: !кубик, .кость	До 10 алиасов, на любом языке, до 32 символов, без пробелов
Описание	Что делает команда. Видно в меню Telegram и в /help	До 256 символов
Группа	Название группы, по которой команды собираются в списке панели и в /help	До 32 символов, свободная форма
Действие по умолчанию	Какое действие выполнить, когда участник пишет команду	Одно из действий команды

Имя или алиас заняты

Если имя совпадает со встроенной командой (например, mute) или алиас уже есть у другой команды, редактор подсветит поле и подскажет, с какой командой конфликт.

Поля вызова

Вкладка «Поля вызова» определяет, кто, где и как часто может вызывать команду. Это те же поля, что у встроенных команд.

Кто может вызывать

Поле	Что задает
Разрешенные статусы	Статусы Telegram: создатель, администраторы (можно потребовать конкретные права админа), обычные участники, ограниченные
Разрешенные роли	Роли бота, которым можно
Разрешенные участники	Конкретные люди
Запрещенные статусы, роли, участники	Кому нельзя, даже если что-то из разрешенного подходит
Минимальный уровень	Команда доступна с N-го уровня (если включены «Уровни»)

Создателя чата не запереть

Создатель чата всегда может вызвать включенную команду, даже если в запрещенных указано иное. Так владелец не сможет случайно закрыть доступ самому себе.

Где можно вызывать

Поле	Что задает
Разрешенные топики	Если заполнено, команда работает только в этих топиках форума
Запрещенные топики	В этих топиках команда не работает

В чатах без топиков эти поля не показываются.

Как часто

Кулдаун — пауза, в течение которой команду нельзя вызвать повторно. Задается в секундах (до суток) и действует на выбор:

Область	Значит
На участника	Каждый участник может вызывать команду раз в N секунд
На чат	Команду можно вызвать раз в N секунд на весь чат
Глобально	Одна пауза для всех

Как отвечать

Поле	Варианты
Режим ответа	Ответом на сообщение с командой · Без упоминания · В ЛС (если участник запускал бота) · Эфемерно — ответ видит только вызвавший
Эфемерная команда	Сам вызов команды из меню Telegram не виден остальным участникам
Удалить сообщение с командой	Бот удалит !кубик после выполнения
Удалить ответ через	Бот удалит свой ответ через N секунд (0 — не удалять)
Записывать в лог	Отправлять вызов команды в лог-чат

Эфемерные сообщения не гарантированы

Telegram может не доставить эфемерное сообщение, если участник не в сети. Используйте этот режим для необязательных ответов: /rank, подсказок, сообщений «нет прав».

Наследование от модуля

У всех пользовательских команд есть общие настройки по умолчанию — в разделе «Команды» на уровне модуля. Каждое поле команды либо берется оттуда, либо переопределено у самой команды:

• бейдж «Из модуля» — значение унаследовано, изменится вместе с модулем;
• бейдж «Переопределено» — значение задано у команды. Кнопка «Сбросить к модулю» возвращает наследование.

Так удобно задать кулдаун 5 секунд для всех команд сразу и поменять его только там, где нужно.

Как бот сообщает об ошибках

Когда команда не может выполниться — сработал require, кончилась квота, у бота нет прав, — бот отвечает сообщением об ошибке. Как именно — задается в настройках модуля «Команды»:

Вариант	Что происходит
Ответом	Бот пишет ошибку ответом на вызов
Эфемерно	Ошибку видит только вызвавший
Молча	Бот ничего не пишет, ошибка остается только в диагностике

Включение и выключение

Команда выключается через меню «⋯» в редакторе — бот попросит подтвердить. Выключенная команда не отвечает и исчезает из меню Telegram и /help, но все ее настройки сохраняются.

Горячие клавиши

Клавиши	Действие
Ctrl + S	Сохранить команду
F11	Развернуть активное поле шаблона на весь экран