Базовые команды чата¶

Базовые команды — это команды PulseCaster для зрителей Twitch-чата. Они помогают узнать текущую игру, посмотреть личную статистику, спросить оракула, бросить кубик, открыть пройденные игры или поиграть в дуэль. Команды !кино, !пословица и !суперспособность используют AI и по умолчанию выключены.

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

Нужна помощь разработчика?

Напишите mrgorkiy в Telegram. Укажите страницу, ожидаемый результат, что произошло и шаги для повторения. Можно приложить скриншот или короткое видео. Перед отправкой закройте токены, коды подтверждения и приватные ссылки OBS.

Короткий список¶

Команда	Пример	Что делает
`!помощь`, `!help`, `!about` с упоминанием `@PulseCasterBot` или ответом на его сообщение	`!помощь @PulseCasterBot`, `@PulseCasterBot !help`	показывает общую справку о боте, разработчика и ссылку на документацию; выключить нельзя
`!помощь <команда>`, `!help <команда>` так же адресно	`!помощь @PulseCasterBot !время`	показывает назначение и пример использования конкретной встроенной или пользовательской команды
`!команды`, `!commands`	`!команды`	показывает команды, которые сейчас доступны на канале
`!оракул`	`!оракул стоит ли начинать новую игру?`	отвечает на вопрос в стиле шуточного оракула
`!предсказание`	`!предсказание` или `!предсказание ник`	выдаёт шуточное предсказание для себя, ника или пользователя из реплая
`!пословица`, `!поговорка`	`!поговорка про краснодар`	AI-команда: переделывает узнаваемую русскую пословицу под указанную тему
`!кино`	`!кино про пы-пы-пы`	AI-команда: превращает узнаваемое название фильма, мультфильма или сериала в каламбур
`!суперспособность`, `!способность`	`!суперспособность [способность]`	AI-команда: придумывает смешной подвох к заданной способности или полностью генерирует способность с особенностью; доступна один раз в день на пользователя и канал
`!подарок`	`!подарок ник`	отправляет случайный шуточный подарок
`!пройдено`, `!играл`, `!играла`	`!пройдено`, `!играл все`, `!пройдено Hollow Knight`	показывает прогресс по пройденным играм
`!медиа`, `!смотрел`, `!смотрела`, `!смотрели`, `!было`	`!медиа`, `!медиа статистика`, `!медиа все`, `!смотрел Гарри Поттер`	показывает состояние, статистику и каталог кинопросмотра
`!можностримить`, `!риск`, `!чепомедиа`	`!можностримить Дюна 2021`	проверяет карточку по фильтрам канала и показывает статус прав на ретрансляцию
`!тайминги`	`!тайминги Гарри Поттер`	открывает или показывает тайминги подготовленного медиа
`!оценка`	`!оценка 9`, `!оценка Hollow Knight 10`, `!оценка игра Dark Souls 9`, `!оценка медиа Дюна 8`	ставит оценку текущей или указанной игре/медиа; каталоги игр и медиа включаются отдельно
`!игра`	`!игра`	показывает текущую игру или категорию стрима
`!время`	`!время`	показывает, сколько стрим уже идёт, во сколько он начался (МСК) и сколько идёт текущая игра: «Стрим идёт уже 4:20:59 (с 15:59:17 МСК), а эта игра - 1:33:33»; если игра неизвестна, часть про неё опускается
`!статистика`, `!стата`, `!stats`	`!статистика` или `!стата все`	показывает личную статистику зрителя
`!фоллоу`, `!follow`	`!фоллоу`	показывает дату фоллоу, число дней и срок в годах, месяцах и днях; по умолчанию выключена
`!рейтинг`, `!rank`	`!рейтинг`	показывает рейтинг чаттеров за последние 30 дней
`!чтобыло`, `!чобыло`	`!чтобыло`	показывает историю того, что было на стриме
`!рост`, `!см`, `!cm`, `!sm`	`!рост`	показывает прогресс роста зрителя
`!топрост`, `!росттоп`, `!топсм`, `!смтоп`	`!топрост [количество]`	показывает топ по росту; можно запросить от 1 до 50 участников
`!кубик`	`!кубик` или `!кубик 20`	бросает кубик
`!кусь`, `!укусить`	`!кусь @ник @ник2 привет`, `!кууусь @ник`	по умолчанию выключена у всех каналов, стример включает её сам; кусает зрителей за случайное место: ники идут подряд после команды (до 10), текст после них не важен; без ника кусает автора сообщения из реплая, иначе себя. До трёх зрителей кусают каждого отдельно, каждого — за случайное число мест от одного до стольких, сколько «у» в команде (не больше трёх), чаще за максимум: у `!кууусь` 3 места — 50%, 2 — 30%, 1 — 20%; у `!куусь` 2 — 60%, 1 — 40%; толпу от четырёх — всех за одно место. У мест свои эмоуты: 7TV канала, если они там есть, иначе глобальные эмоуты Twitch или эмодзи; изредка выпадают пасхалки вроде «Ктулху» и «мизинца левой руки». Бота не пингуют — он уворачивается. Если у канала есть своя команда `!кусь`, отвечает она
`!дуэль`, `!д`	`!дуэль ник`, `!д принять`	запускает дуэль между зрителями; по умолчанию выключена

Справка о боте и командах¶

!помощь и её английские названия !help и !about отвечают только тогда, когда сообщение явно адресовано PulseCasterBot: на канале могут быть другие боты со своим !help. Упоминание можно поставить до команды или после неё:

!помощь @PulseCasterBot
!help @PulseCasterBot
!about @PulseCasterBot
@PulseCasterBot !помощь
@PulseCasterBot !help

Справку выключить нельзя: в общих настройках она показана с пометкой «Всегда включена». Без упоминания и ответа бот на !помощь молчит.

Те же команды можно отправить ответом на любое сообщение PulseCasterBot, не добавляя упоминание вручную. Общая справка кратко рассказывает о боте, указывает разработчика @mrgorkiy, напоминает базовые команды и даёт ссылку на документацию: https://pulsecaster.ru/docs/. Адресная справка работает независимо от тумблера базовых команд канала.

Для справки по одной команде добавьте её имя после !помощь или !help. Восклицательный знак у имени команды необязателен:

!помощь @PulseCasterBot !время
!help @PulseCasterBot время
@PulseCasterBot !help !время

Бот покажет назначение, синтаксис и алиасы встроенной команды. Для активной пользовательской команды или команды правила он покажет доступный на канале формат вызова. Скрытые пользовательские команды в справке не раскрываются.

!команды решает другую задачу: эту команду можно отправлять без реплая и упоминания, и она выводит компактный список команд, которые сейчас включены на конкретном канале. Поэтому для обзора используйте !команды (или !commands), а для пояснения одной команды — адресную !помощь <команда>.

Команды правил берутся из активных правил: из имени команды в разделе Когда и из условий Команда равна в ветках сценария. Не попадают скрытые команды и условия с НЕ: «команда НЕ равна !x» не значит, что правило отвечает на !x.

Оракул¶

!оракул — это команда для коротких шуточных ответов на вопросы зрителей.

Как использовать:

!оракул стоит ли сегодня идти в шахты?
!оракул получится ли пройти босса?

Оракул работает только когда есть активный стрим и PulseCaster понимает текущий контекст эфира: название стрима и категорию. Ответ специально сделан лёгким и развлекательным, это не совет и не обещание.

На что обратить внимание:

вопрос нужно писать после команды;
если месячный лимит оракула закончился, команда временно перестанет отвечать;
если стрим офлайн или категория неизвестна, бот может ответить, что данных сейчас нет;
оракул может ошибаться или отвечать странно, потому что это развлекательная AI-команда.

Пословицы и кино-каламбуры¶

Обе команды требуют слово про и тему:

!пословица про краснодар
!поговорка про краснодар
!кино про пы-пы-пы

Бот отвечает одной короткой переделкой и добавляет подходящий Twitch emote. Например:

Дарёному Краснодару в зубы не смотрят Kappa
РобоПы-пы-п BOP

Обе команды по умолчанию выключены. Владелец канала может независимо включить их в Общие настройки → Базовые команды. Это AI-команды, но готовый ответ из кэша не списывает лимит повторно.

Для новой пары «тип + тема» LLM создаёт до 10 вариантов, после чего ответы сохраняются в PostgreSQL и повторные вызовы не расходуют LLM-запрос. Бот сначала показывает наименее использованные варианты. Когда тема востребована и пул исчерпан, он может добавить следующую десятку, но не больше 50 вариантов на тему.

Расширение имеет адаптивную паузу: 24 часа для обычной темы, 6 часов после 30 запросов и 1 час после 100 запросов. Это не срок удаления: сохранённые варианты не пропадают после TTL. Пауза только ограничивает частоту новых LLM-генераций. На cache miss используется месячный лимит AI-ответов канала; готовые варианты доступны без расхода этого лимита.

Суперспособность¶

Текст после команды необязателен. Если способность задана, бот отвечает реплаем только коротким смешным подвохом:

!суперспособность управлять молниями
→ на чужих ширинках

Если текста нет, бот полностью придумывает способность вместе с её особенностью:

!способность
→ понимать язык котов, но только когда они молчат

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

Статистика¶

!статистика показывает личную статистику зрителя. Короткие названия !стата и !stats работают так же.

!статистика
!стата все
!stats

Без аргументов команда показывает статистику за текущий стрим: сообщения, символы, команды, просмотр, награды канала, фоллов и дуэли. Если стрим офлайн, используйте !стата все.

!стата все показывает доступную историю: сообщения, символы, команды, количество стримов, watch-time, награды, фоллов, рост и дуэли.

Стата может быть неполной, если:

зритель недавно пришёл и данных ещё мало;
у канала не хватает Twitch-доступов для части данных;
стрим только начался и статистика ещё не успела накопиться.

Дату фоллоу Twitch отдаёт только каналам, которые выдали право «Чтение фолловеров» в правах Twitch. Без него команда честно пишет «фоллоу не проверить: нет доступа к списку фолловеров» вместо даты. Владельцу канала команда всегда отвечает «фоллоу нет — это твой канал»: на себя подписаться нельзя. Если в аналитике даты ещё нет, бот запрашивает её у Twitch токеном владельца (или токеном бота с тем же правом) и кеширует успешный результат на 30 минут. Для точного watch-time команде также требуется право «Чтение зрителей в чате».

Фоллоу¶

!фоллоу (!follow) коротко показывает дату, когда автор команды зафолловил канал, полное число прошедших дней и календарный срок в годах, месяцах и днях. Например:

!фоллоу
→ MrGorkiy, фоллоу с 20.12.2025 (264 дня — 8 месяцев, 21 день).

Команда имеет отдельный тумблер в общих настройках и по умолчанию выключена для новых каналов владельцев. Для работы требуется Twitch-право moderator:read:followers. Если аналитика временно недоступна, бот запрашивает дату напрямую у Twitch.

Дуэль¶

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

Как вызвать:

!дуэль ник

Также можно ответить командой !дуэль на сообщение зрителя, если чат-клиент поддерживает реплаи.

Как принять:

!д принять

Ещё можно принять ответным вызовом:

!дуэль ник_который_вызвал

На принятие вызова даётся 60 секунд. После старта дуэли бот случайно выбирает один из режимов.

Режим	Что делать
Код	бот показывает код; нужно быстрее написать его наоборот через `!д <код>`
Математика	бот даёт пример; нужно быстрее написать правильный ответ через `!д <число>`
Кубики	оба участника пишут `!д бросок`; большее число побеждает

Если оба ошиблись, не успели или выбросили одинаковое число на кубиках, проиграть могут оба. Проигравший получает таймаут на 60 секунд. Стример, модераторы и другие защищённые роли не получают реальный таймаут, но бот всё равно покажет, что по дуэльной драме они проиграли.

Нельзя вызвать на дуэль себя или самого бота. Если вызвать стримера и он не примет вызов за минуту, стример всё равно победит по решению судьи.

Пройдено, медиа и оценки¶

Команды !пройдено, !смотрел, !тайминги и !оценка связаны с публичными страницами канала.

Команда	Когда полезна
`!пройдено`	узнать статус текущей игры или категории
`!пройдено все`	открыть общий список пройденного
`!пройдено <игра>`	найти конкретную игру
`!медиа`	посмотреть текущий или последний медиа-просмотр
`!медиа статистика`	увидеть карточки, завершённые просмотры и прогресс по отмеченным сезонам и сериям
`!медиа все`	открыть список медиа
`!медиа <название>`	найти конкретную карточку
`!можностримить <название>`	проверить год, IMDb-рейтинг, студию и доступность медиа; `!риск` и `!чепомедиа` — короткое и прежнее имена команды
`!тайминги <название>`	открыть тайминги конкретного просмотра
`!оценка 1..10`	поставить оценку текущей карточке
`!оценка <название> 1..10`	поставить оценку конкретной игре или медиа
`!оценка игра [название] 1..10`	явно оценить категорию игры
`!оценка медиа [название] 1..10`	явно оценить фильм, сериал или аниме

Успешные оценки одной карточки, отправленные в течение 2,5 секунды, бот объединяет в один ответ: перечисляет пользователей и их оценки, а в конце показывает итоговую оценку. Ошибки команды выводятся сразу.

Как `!оценка` выбирает карточку¶

Без явного игра или медиа бот решает сам:

если название не указано, оценка идёт в привязанный просмотр (!смотрим), а при его отсутствии — в текущую категорию стрима;
если название указано, бот ищет его сразу в обоих каталогах. Одно совпадение сохраняется, а если название есть и в играх, и в медиа — бот предложит пронумерованные карточки;
если совпадений нет, бот предложит похожие названия из игр и медиа, включая опечатки. Ответ !оценка 1 в течение двух минут выбирает карточку, а исходная оценка сохраняется без изменений;
карточки медиа с одинаковыми названиями показываются с годом и типом, например Дюна (1984, фильм), Дюна (2021, фильм).

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

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

Подробнее про страницы:

!смотрел, !смотрела, !смотрели и !было работают как совместимые названия для !медиа. При опечатке или одинаковых названиях бот предлагает варианты, которые можно выбрать через !смотрел 1 в течение двух минут. Команды просмотра только читают состояние; !оценка отдельно сохраняет или обновляет голос зрителя.

!можностримить сверяет карточку с настройками канала, дополняет её оценками и студиями из MDBList/OMDb и показывает легальные площадки из Watchmode. Зелёный результат возможен только при отдельно подтверждённой лицензии или статусе public domain. Наличие фильма в подписке, аренде или продаже не означает разрешение ретранслировать его на Twitch.

Рост и ивенты¶

!рост показывает текущий прогресс зрителя, а !топрост — топ по росту. По умолчанию выводятся 5 участников; необязательным аргументом можно запросить до 50, например !топрост 10. Ответ !рост по умолчанию короткий; полный ответ с раскладкой результата и шуточными фактами о росте включается в настройках роста. Некоторые команды роста работают только во время активных ивентов: !зарядка, !качок, !фонтан, !лавина, !шторм, !штиль, !казино. У !казино свой переключатель в общих настройках (группа «Рост»); вне ивента команда отвечает, что казино сейчас не активно, а !казино правила показывает условия.

Подробная настройка ивентов описана в разделе Ивенты роста.

Если команда не отвечает¶

Проверьте по порядку:

Команда включена в Общих настройках. Если зритель пишет алиас (например, !играл), проверьте, что не выключен именно этот алиас.
На канале включён общий тумблер базовых команд.
Для команды есть нужные данные: активный стрим, текущая категория, история просмотров или статистика.
Команда не на кулдауне. О кулдауне бот предупреждает один раз, повторные попытки молча игнорирует; подробнее — Антиспам команд.
У канала хватает доступов и лимитов для функции.

Если всё выглядит правильно, но команда всё равно не работает, напишите разработчику: t.me/mrgorkiy. Лучше сразу приложить скриншот или видео, текст команды, название канала и что бот ответил или не ответил.

Для !суперспособность и !способность администратор может включить общую базу одобренных ответов на странице /admin/ai-answers. Бот выбирает готовый вариант с заданной вероятностью, чаще предпочитая редко использованные ответы. Без аргумента выбирается полная способность с подвохом; с аргументом — подвох для совпадающего текста (регистр и лишние пробелы не учитываются). При отсутствии варианта используется ИИ. Готовый ответ не расходует квоту ИИ, но учитывается в суточном лимите команды. Новые генерации проходят модерацию перед повторным использованием.