Перейти к содержимому
Руководство 02

Команды и переменные

Команды, которые приветствуют людей по имени, бросают кубики и считают ваши победы. Без кода: только фигурные скобки.

01Устройство команды

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

Пользовательская команда задаёт вопрос, который зрители могут задать (!calin), и ответ, который даёт ваш бот. В редакторе восемь полей; обязательны только название и ответ.

  • Название: то, что зрители пишут после «!». Строчными буквами, одним словом.
  • Другие названия: дополнительные триггеры для той же команды (!calin и !calins могут быть одной командой).
  • Ответ: то, что говорит бот. До 5 строк; каждая строка отправляется отдельным сообщением в чате.
  • Репетиция чата проигрывает ваш ответ с примерными значениями перед сохранением. Конструктор команд работает так же.
  • Доступ и перерывы: кто может использовать команду, сколько все ждут после каждого использования и сколько каждый зритель ждёт между своими использованиями.
  • «Только в эфире» ставит команду на паузу вне эфира; «Активна» служит общим выключателем.
  • Источник данных: вставляет значение, полученное из одного из ваших источников данных, вместо переменной.
Редактор команды, пристыкованный к вашему списку, с подписями у каждого поля.
Совет Поле «Источник данных» вставляет {urlfetch:name}, значение из источника данных, который вы сами сохранили. Руководство по источникам данных объясняет, как сохранить первый.

02Два способа создать команду

с первого взглядаРедактор в панели управления или одна строка в чате. Оба способа приводят к одному результату.

Из панели управления

В разделе «Команды» нажмите Новая команда, заполните название и ответ, затем Создать. Она отвечает в чате обычно в течение нескольких секунд. Редактирование работает так же: нажмите на команду, измените её, сохраните.

Из чата, через !cmd

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

!cmd add, edit и remove доступны только стримеру и модераторам.
  • !cmd add <название> <ответ> создаёт команду.
  • !cmd edit <название> <ответ> заменяет её ответ.
  • !cmd remove <название> удаляет её.
Совет В чате удобно создавать короткие фразы; панель управления показывает дополнительные настройки (доступ, перерывы, другие названия) и предпросмотр в реальном времени. Используйте то, что вам удобнее.

03Переменные: самая умная часть

с первого взглядаФигурные скобки задают заполнители, которые бот подставляет при ответе. Все они есть в справочнике переменных.

Напишите {user} в ответе, и бот заменит его на имя человека, который запустил команду. Вот что такое переменная: заполнитель, который бот заполняет в момент ответа. Каждая переменная, которую он понимает, с точным синтаксисом и конкретным примером, есть в справочнике переменных.

Добавьте вертикальную черту и текст внутри фигурных скобок, чтобы у переменной был запасной текст, если значение пустое: hug {touser|всем} обнимет названного человека или всех, если никто не назван.

Одна команда, две очень разные фразы: !hug без имени против !hug MikanMeerkat.
Посмотрите каждую переменную Справочник переменных показывает синтаксис, примеры и модуль, который нужен каждой из них, сгруппированные так, как вы их используете.

04Несколько строк и действия в чате

с первого взглядаКаждая строка становится отдельным сообщением. Строка также может объявить, сделать shoutout или закрепить сообщение.

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

Строка начинается сЧто происходит
/meСообщение «action» курсивом, в классическом стиле IRC.
/announceВыделенное объявление Twitch. Варианты цвета: /announceblue, /announcegreen, /announceorange, /announcepurple.
/shoutoutВстроенный shoutout Twitch на первое имя в строке.
/pinОтправляет сообщение и закрепляет его до конца стрима.
Команда из двух строк: объявление, затем обычное сообщение.
Встроенная защита Текст, который вводят зрители ({args}, {touser}), очищается, прежде чем попасть в сообщение: никто не сможет вставить /ban или /timeout в вывод вашей команды.

05Правила игры

с первого взглядаНазвания, лимиты, перерывы и уровни доступа. Всё, что редактор принимает и отклоняет.

Редактор проверяет всё это за вас и простыми словами говорит, что не так. Для справки:

ПолеПравило
НазваниеОт 1 до 64 символов, без пробелов и без «!» (чат добавляет его сам). Хранится строчными буквами: !Calin и !calin задают одну и ту же команду.
Другие названияДо 25, каждое по тем же правилам, что и название.
ОтветДо 5 строк по 500 символов каждая (одно сообщение в чате на строку).
Общий перерывОт 0 до 86400 секунд. Он общий для всего чата: после использования все ждут. 0 его отключает.
Перерыв для каждого зрителяОт 0 до 86400 секунд. Каждый зритель ждёт этот срок между своими использованиями; остальные по-прежнему могут запустить команду, как только пройдёт общий перерыв. Другие названия считаются той же командой. 0 его отключает.
ДоступМинимальный ранг, по порядку: все, подписчики, VIP, модераторы, главные модераторы, стример. Каждый уровень включает уровни выше.
Ограничить по ID пользователяЗакрепляет команду за одним аккаунтом Twitch; это полностью заменяет уровень доступа. Идеально для личной команды друга. Поле принимает только цифры: это ID пользователя Twitch, а не имя пользователя. Чтобы найти ID, используйте проверенный сервис поиска ID пользователей Twitch, или инструмент модерации, который показывает ID пользователей.

06Без лишнего ввода: конструктор

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

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

Попробуйте сейчас Открыть конструктор команд