Настройка команд чат-бота для разных ролей в чате

Какие команды должны быть у зрителей и модераторов

Зрительские команды отвечают на частые вопросы и не меняют ничего в чате: !правила, !расписание, !соцсети, !донат, !команды. Их можно запускать без риска, если ответ не содержит служебных ссылок, персональных данных и действий во внешних сервисах.

Модераторские команды нужны для работы с чатом: !пред, !таймаут, !очистка, !медленныйчат, !напомнить. Они либо меняют режим общения, либо помогают фиксировать нарушение. Зритель не должен получать доступ к таким вызовам даже по алиасу.

Права задают по последствиям команды, а не по её названию. Команда !help может быть открыта всем, а !helpmod с внутренней инструкцией — только модераторам. Если в ответе есть ссылка на закрытый документ, это уже служебная команда.

Недостаток слишком дробной системы — новичок в команде модерации дольше запоминает вызовы. Не создавайте отдельную команду под каждую мелочь: оставляйте только действия, которые повторяются на эфирах.

Сначала соберите рабочую таблицу команд

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

• Зрители: !правила, !расписание, !соцсети, !донат, !игра, !команды.
• Подписчики: !запрос, !трек, команды участия в закрытой активности, если она предусмотрена форматом канала.
• VIP: только бонусные команды, которые не модерируют чат и не меняют настройки.
• Модераторы: !пред, !таймаут, !очистка, !напомнить, !медленныйчат.
• Владелец и редактор бота: создание команд, изменение прав, вебхуков, ответов и списка модераторов в панели бота.

Не путайте роль в чате и доступ к панели. Пользователь может быть модератором Twitch, но не иметь права менять команды в Nightbot или StreamElements. Это нормальная схема: модерировать чат и редактировать бота должны не одни и те же люди по умолчанию.

Настройка прав в Nightbot

В Nightbot откройте раздел Custom, затем Commands. В списке найдите нужную команду и нажмите Edit. Основные поля для разграничения доступа находятся в настройках самой команды: Userlevel, Cooldown и User Cooldown.

В поле Userlevel выберите роль, которой разрешён запуск. Для !правила, !расписание и !соцсети обычно ставят Everyone. Для !напомнить, где бот публикует длинное сообщение о правилах, подходит Moderator. Команду, которая меняет ответ бота, запускает внешнее действие или публикует служебную ссылку, оставьте владельцу либо не создавайте как чат-команду вообще.

В Nightbot можно использовать уровни Everyone, Subscriber, Regular, Moderator, Owner и другие варианты, доступные в конкретной панели. Роль Regular не равна модератору: это уровень лояльного зрителя, а не право управлять чатом. Не выдавайте Regular доступ к !таймаут, !очистка и похожим командам.

Недостаток доступа Subscriber для полезной справки — часть аудитории не увидит расписание или правила. Закрывайте подпиской только бонусные функции, а не информацию, без которой зритель не сможет нормально участвовать в эфире.

Настройка прав в StreamElements

В StreamElements откройте Chat Bot, затем Chat Commands. Выберите существующую команду или создайте новую через Add New Command. В карточке команды проверьте поле User Level: именно оно определяет, кто может вызвать ответ или действие.

Для открытых вызовов вроде !соцсети установите уровень для всех зрителей. Для !правила, если ею пользуются и модераторы во время конфликта, тоже оставьте общий доступ, но поставьте задержки. Для команды !модправила, которая показывает внутренний порядок действий, выберите уровень модераторов.

В этой же карточке проверьте Global Cooldown и User Cooldown. Global Cooldown ограничивает повтор для всего чата. User Cooldown запрещает одному зрителю повторно вызывать команду раньше заданной задержки. Если оставить только пользовательское ограничение, несколько аккаунтов смогут заполнить чат одинаковым ответом. Если оставить только общее, один зритель будет пытаться вызывать команду после каждой разблокировки.

Недостаток жёсткого Global Cooldown — зрители могут не получить ссылку именно тогда, когда она нужна. Для !донат или !соцсети выбирайте задержку по активности чата, а не копируйте настройки с другого канала.

Как назначать роль VIP и постоянным зрителям

VIP часто получают за поддержку канала, участие в сообществе или давнее присутствие. Это не техническая роль модерации. VIP можно дать команду с дополнительной информацией, участие в игре или право запускать редкую развлекательную механику, если её повтор не создаёт проблем.

Не давайте VIP команды наказания, очистки чата, смены режима, выдачи баллов другим пользователям и управления ботом. Если VIP требуется доступ к модераторскому действию, назначьте человеку модератора и отдельно объясните правила работы. Смешивание статуса поддержки и полномочий модератора приводит к конфликтам: зритель может считать служебные права наградой, а не обязанностью.

Недостаток отдельного набора VIP-команд — его нужно поддерживать после каждого изменения формата. Если для VIP нет понятного полезного сценария, лучше не создавать уровень доступа только ради его наличия.

Кулдауны для открытых команд и защита от спама

Кулдаун нужен даже безопасным командам. Когда несколько зрителей подряд запускают !правила или !расписание, чат превращается в повторяющиеся сообщения бота, а обычные реплики уходят вверх. Особенно заметно это в моменты рейда, розыгрыша или активности с быстрым чатом.

Для каждой публичной команды настройте два ограничения: общее для чата и персональное для пользователя. Общее подходит для длинных сообщений, ссылок и многострочных ответов. Персональное защищает от одного зрителя, который повторяет вызов после каждой доступной попытки.

• Для !правила используйте общий кулдаун, чтобы бот не дублировал большой текст несколько раз подряд.
• Для !соцсети и !донат добавьте общий и пользовательский кулдауны: ссылки быстро засоряют чат при повторах.
• Для !игра, !баллы и других механик с участием проверьте, не выдаёт ли команда награду при каждом запуске.
• Для !команды делайте короткий ответ со ссылкой на полный список, а не публикуйте весь перечень в чат.
• Для !напомнить ограничьте общий запуск, чтобы два модератора не отправили один текст одновременно.

У модераторских команд другой приоритет. На !таймаут и !очистка кулдаун может помешать во время волны спама. Если бот позволяет, не ставьте на них задержку либо делайте её минимальной. Но команда !напомнить, !ссылки или !розыгрыш для модераторов тоже может требовать общего ограничения.

Недостаток слишком мягких кулдаунов — бот становится источником спама. Недостаток слишком долгих — команда выглядит сломанной, и модератор пытается вызвать её повторно. Зафиксируйте в инструкции, на каких командах есть задержка и почему она установлена.

Алиасы не должны обходить ограничения

Алиас запускает тот же ответ под другим словом. Для !расписание можно добавить !стримы или !распис. Это полезно, когда аудитория привыкла к разным вариантам. В Nightbot алиасы обычно добавляют в настройках основной команды, а в StreamElements нужно проверить, не создана ли похожая команда отдельно.

Для служебных действий не используйте короткие алиасы вроде !m, !t или !to. Они плохо читаются в журнале сообщений, пересекаются с игровыми вызовами и чаще вызываются по ошибке. Вместо этого используйте понятные варианты: !пред, !таймаут, !очистка.

После добавления алиаса проверьте его с аккаунта без прав. Реальная ошибка из практики — основная !таймаут закрыта для модераторов, а старый !to остался отдельной открытой командой с шаблонным действием. Владелец этого не замечает, потому что тестирует бота со своего аккаунта с максимальными правами.

Недостаток большого числа алиасов — поддержка становится сложнее. При смене ссылки или текста приходится проверять каждый вариант, а старый вызов может продолжать вести зрителей на неактуальную страницу.

Что реально ломается без разделения прав

Открытая команда с переменной, которая принимает ник пользователя, может стать источником подмены текста или упоминаний. Например, зритель вызывает !привет с чужим ником, а бот публикует сообщение так, будто канал отметил этого человека. Для развлекательной команды это неприятно, для служебной — уже риск ошибок модерации.

Другая частая проблема — команда !очистка настроена как обычный текстовый ответ, а модераторы считают, что она очищает чат. Во время нарушения они запускают её, бот пишет шаблонную фразу, а спам остаётся. Все команды, связанные с наказаниями и режимами чата, нужно проверять по фактическому действию, а не по названию.

Ещё один случай — доступ Moderator выбран в панели бота, но нужный человек добавлен модератором только на платформе и не синхронизирован с ботом. Команда не запускается, а модератор решает, что бот завис. После назначения роли всегда проверьте конкретный аккаунт тестовым вызовом.

Проверка команд до выхода в эфир

Тестируйте настройки не с владельца канала. Нужны как минимум обычный зрительский аккаунт и аккаунт модератора. Если используются подписчики, VIP или постоянные зрители, проверьте и эти уровни. Тест лучше проводить вне эфира: случайный тайм-аут, очистка или тестовая ссылка не попадут в живой чат.

1. От лица зрителя вызовите !правила, !расписание, !соцсети и все их алиасы.
2. Попробуйте вызвать !пред, !таймаут, !очистка и команды смены режима без прав.
3. Проверьте, что VIP не может запускать служебные вызовы, если ему специально не выданы права модератора.
4. Вызовите публичную команду несколько раз с одного аккаунта и с разных аккаунтов, чтобы проверить оба типа кулдауна.
5. Проверьте ошибочные аргументы: пустой ник, ник без символа упоминания, слишком длинную причину, лишние пробелы.
6. Посмотрите журнал действий бота, если он доступен: по нему легче найти сработавшую команду и конфликтующий алиас.

Текст отказа тоже имеет значение. Он не должен публиковать внутренние названия команд, ссылки на панель или описание прав владельца. Достаточно нейтрального ответа либо отсутствия ответа, если это предусмотрено ботом.

Инструкция для модераторов и пересмотр настроек

Дайте модераторам короткий список только тех команд, которыми они должны пользоваться. Укажите вызов, формат аргументов и ситуацию применения. Например: !таймаут ник длительность причина; перед запуском проверить ник и сообщение, не применять команду по просьбе другого зрителя без проверки контекста.

Не храните в такой инструкции пароли, токены, ключи подключения и ссылки с административным доступом. Чат-команда не должна заменять вход в панель Nightbot, StreamElements или аккаунт платформы.

Перепроверяйте права после смены модераторов, подключения нового бота, запуска розыгрыша, переноса команд и изменения формата эфиров. Недостаток регулярной ревизии очевиден: она требует времени. Но без неё на канале остаются старые алиасы, ненужные ссылки и доступы людей, которые уже не работают с чатом.