PLGamesBot /Гайды/Команды, мини-игры, уровни, розыгрыши
Войти
ИнструкцияВ эфире

Команды, мини-игры, уровни и розыгрыши: как настроить

Бот сразу отвечает на три десятка встроенных команд: мини-игры, уровни, розыгрыш, голосование, заказ музыки. Свои команды — правила, ссылки, «!дс» — заводятся на странице Команды. Всё это бесплатно на всех тарифах и работает, пока у бота есть права модератора в вашем чате.

12 минут Обновлено Все тарифы
Содержание

Коротко

  • Встроенные команды работают сразу: напишите в чат !команды — бот ответит списком того, что есть на канале.
  • Свою команду добавьте на странице Команды кнопкой Добавить: имя, Ответ бота, кулдаун и кому она отвечает.
  • Мини-игры, розыгрыши и голосования — на странице Игры и розыгрыши, опыт и титулы — на Очки и уровни. Зрители участвуют командами !участвую и !голос.

Что понадобится

  • Вход в кабинет PLGamesBot через Twitch и включённый бот: команды он читает в чате.
  • Права модератора у бота — /mod plgames_bot в своём чате или кнопка Выдать боту права на Своде. Без них бот молчит.
  • Больше ничего: команды, мини-игры, уровни, розыгрыши и голосования есть на всех тарифах, без ограничения по числу.

Настройка за 6 шагов

  1. Проверьте встроенные команды

    Напишите в своём чате !команды. Бот ответит списком: команды для всех, мини-игры и уровни, если они включены, и до десяти ваших команд. Вам он добавит команды управления каналом — !игра, !название, !клип, !можно, модераторам — !клип и !можно. Все встроенные команды — в таблице ниже.

  2. Добавьте свою команду

    Откройте Команды и нажмите Добавить. В окне «Новая команда»:

    1. Название команды — без «!», до 50 знаков: буквы, цифры, «_» и «-»;
    2. Ответ бота — что напишет бот, можно с переменными из раздела «Как это работает»;
    3. Кулдаун (сек) — сколько секунд команда молчит после ответа, от 0 до 3600, сразу стоит 10;
    4. Разрешение — кому команда отвечает: Все, Подписчики (и модераторы) или Модераторы (и вы);
    5. Сохранить — команда работает сразу, без перезапуска бота.
  3. Или поставьте готовый набор

    Кнопка Шаблоны открывает три набора: «Базовый набор» (привет, правила, соцсети), «Информация о стримере» и «Развлечения» (!лав, !обнять, !рейт). Установить добавит команды набора, а те, чьё имя у вас уже есть, пропустит. Команды с заглушкой вроде «[ссылка]» встают выключенными: впишите свой текст и включите тумблер в столбце «Вкл».

  4. Настройте мини-игры и уровни

    Мини-игры и уровни включены сразу. Выключить игру или поменять награду — Игры и розыгрыши, вкладка Мини-игры: общий тумблер Мини-игры включены, тумблер у каждой игры и XP за победу для рулетки и дуэли. Опыт — на странице Очки и уровни: Система уровней, XP за сообщение, XP за минуту просмотра, Объявлять повышение уровня и Титулы за уровни. Обе страницы сохраняются кнопкой Сохранить.

  5. Запустите розыгрыш

    Игры и розыгрыши, вкладка Розыгрыши → Новый розыгрыш:

    1. название и приз; как участвовать — «Случайный из участников» (зрители пишут !участвую) или «По ключевому слову» (зритель пишет ваше слово в чат);
    2. по желанию — сколько победителей, предел участников и галочка «Только подписчики»;
    3. Создать, затем Начать — с этой минуты бот принимает участников;
    4. Определить победителя — бот выберет случайно, имя появится в карточке розыгрыша. В чат бот победителя не пишет: объявите его сами.
  6. Запустите голосование

    На той же вкладке — Голосования → Новое голосование: вопрос и от двух до десяти вариантов, Создать, Начать. Зрители голосуют командой !голос и номером варианта, результаты видны в карточке и по команде !опрос. Завершить закрывает голосование.

Без прав модератора бот молчитКоманды при этом выполняются: голос и участие в розыгрыше записываются, опыт начисляется, — но ответа в чате зритель не увидит. Дайте права: /mod plgames_bot в своём чате или кнопка Выдать боту права на Своде.
Имя встроенной команды своей не датьНа !голос, !игра, !заказ и другие встроенные имена отвечает сам бот, поэтому кабинет такое имя не примет: «У бота уже есть команда !голос — выберите другое имя». Старая своя команда с таким именем молчит, и в списке у неё пометка «совпадает со встроенной командой — переименуйте».

Как это работает

Сообщение, которое начинается с «!», бот сначала сверяет со встроенными командами, потом с вашими. Регистр не важен: !Уровень и !уровень — одна команда. Встроенная отвечает одному зрителю не чаще раза в 5 секунд — лишние вызовы бот молча пропускает. Своя команда после ответа молчит столько секунд, сколько стоит в кулдауне, — для всего чата сразу.

В ответе своей команды бот подставляет переменные: {user} — кто написал; {touser} — первое слово после команды без @, а если его нет — снова автор; {args} — всё, что написали после команды (пусто — ник автора); {count} — который раз команду вызвали; {random 1-100} — случайное число в диапазоне; {uptime} — сколько идёт эфир или «оффлайн»; {time} — время по Москве; {game} и {title} — игра и название эфира; {channel} — канал; {level} — уровень зрителя. Чтобы разным зрителям ответить по-разному, есть условия: {if mod}для модераторов{else}для остальных{endif}, а вместо mod — sub (подписчик), vip, live (идёт эфир) или args (после команды что-то написали).

Мини-игры только дают опыт и ничего не отнимают. !рулетка выигрывает в 45 случаях из 100 и даёт 25 XP. !дуэль и ник вызывает зрителя: у него 60 секунд, чтобы написать !принять, а дальше победитель — пятьдесят на пятьдесят, ему 50 XP, проигравший ничего не теряет. !шар и вопрос отвечает как магический шар, !кубик бросает шестигранник (!кубик 20 — двадцать граней, от 2 до 100), !фортуна даёт предсказание и «удачу» в процентах. Таймаутов игры не дают. Фразы не идут по кругу: у шара их 28, у рулетки 26, у фортуны 24, у дуэли 18, и недавно сказанные в канале бот не повторяет.

Опыт зритель получает за каждое сообщение — по умолчанию 5 XP — и за каждую минуту, в которую писал в чат, — 2 XP. Молчащий зритель опыта не получает, чужие чат-боты тоже. Второй уровень — со 100 XP, это 15–20 сообщений, третий — с 282, пятый — с 800, десятый — с 2 700, пятидесятый — с 34 300. Титулы по умолчанию — «Новичок» на 5-м уровне, «Завсегдатай» на 10-м, «Ветеран» на 20-м, «Легенда» на 30-м и «Мифический» на 50-м; !уровень показывает высший из достигнутых.

Поздравляет бот с 3-го уровня и не чаще раза в 5 минут: первое поздравление уходит сразу, а кто дорос за следующие пять минут, тех бот назовёт одним сообщением «🎉 Новые уровни: …» — с первым сообщением чата после этих пяти минут. Если у нового уровня есть титул, бот назовёт и его.

Розыгрыш «Случайный из участников»: зритель пишет !участвую, и бот отвечает, что он участвует. Второй раз войти нельзя, с галочкой «Только подписчики» входят только подписчики, а «Макс. участников» закрывает вход, когда места кончились. Розыгрыш «По ключевому слову»: участвует тот, кто написал сообщение с вашим словом — регистр не важен, слово может стоять внутри фразы. Первому вошедшему бот отвечает сразу, остальных называет одним сообщением не чаще раза в 20 секунд. Победителей бот выбирает случайно, у каждого участника один шанс.

Голосование: зритель пишет !голос 2 — бот отвечает, что голос за второй вариант принят. Голос один на зрителя; с галочкой «Множественный выбор» — по одному за каждый вариант, с «Только подписчики» голосуют только подписчики. Результаты в OBS показывает ссылка, которая стоит рядом с кнопкой Новое голосование.

Ненужный розыгрыш удаляется корзиной в его карточке вместе с участниками, голосование — вместе с голосами. Корзина есть у черновика, завершённого и отменённого: идущий розыгрыш сначала остановите кнопкой Отменить, идущее голосование — Завершить.

Ответы уходят от общего бота plgames_bot, поэтому команду с оскорблением, словами ненависти или матом в адрес человека кабинет не сохранит, а ответ, в который такое подставил зритель (!обнять с оскорблением вместо ника, !дуэль с ним же), бот не отправит. Со своим бот-аккаунтом на Про этой проверки нет. Текст с «/announce…» из прежнего бота уходит обычным сообщением, без служебного слова: цветные объявления бот пока не делает.

!рулетка и вкладка «Рулетка» — разные вещи!рулетка — мини-игра на опыт. Вкладка Рулетка на странице Игры и розыгрыши — колесо с вариантами, на которые зрители ставят баллы канала через награду: !колесо показывает его варианты, а !ставка объясняет, как поставить. Подробно — в инструкции «Награды за баллы».

Встроенные команды

Так бот отвечает в чате Twitch. У большинства команд есть английские синонимы: !rank, !roulette, !vote.

КомандаКто можетЧто делает
!помощь, !командывсесписок команд канала; вам и модераторам — ещё команды управления
!уровень, !топуровеньвсе, если уровни включеныуровень, опыт до следующего, место и титул; пятеро с наибольшим опытом
!рулеткавсев 45 случаях из 100 — 25 XP (по умолчанию)
!дуэль ник, !принятьвсевызов на дуэль, на ответ — 60 секунд; победителю 50 XP (по умолчанию)
!шар, !кубик, !фортунавсеответ шара на вопрос, бросок кубика, предсказание
!участвую, !розыгрышвсевойти в розыгрыш; что и сколько участников
!голос номер, !опросвсепроголосовать; вопрос и текущие результаты
!колесо, !ставкавсеварианты колеса; как поставить — наградой за баллы канала
!топчата, !топчатвсепятеро самых активных в чате за эфир и за всё время
!uptime, !стата, !топдонатероввсесколько идёт эфир; статистика канала; топ донатеров
!момент, !моментывсеотметить момент эфира и показать отмеченные
!заказ, !голосавсезаказ музыки и голоса озвучки — подробно в их инструкциях
!настроениевсе, раз в минуту на каналнастроение чата по 30 последним сообщениям, если AI включён; тратит AI-запрос из дневных
!игра, !названиевы; модераторы — если вы разрешилисменить категорию и название эфира
!клип, !можновы и модераторыснять клип; проверить, можно ли показать фильм, песню или игру
!timeout ник, !ban никвы и модераторытаймаут на 600 секунд или на указанное число секунд; бан

Если не работает

Бот не отвечает ни на одну команду

У бота нет прав модератора: напишите в своём чате /mod plgames_bot или нажмите Выдать боту права на Своде. Проверьте и то, что бот включён — тумблер вверху Свода.

Своя команда молчит

Посмотрите её строку на странице Команды: выключен тумблер в столбце «Вкл», не прошёл кулдаун, «Доступ» не пускает этого зрителя или стоит пометка «совпадает со встроенной командой — переименуйте». Если в ответ зритель подставил оскорбление, бот тоже промолчит.

Кабинет пишет «Похоже на переменные другого бота»

В ответе синтаксис другого бота вида $(…). Перепишите переменные в фигурных скобках: {user}, {touser}, {args}, {count}, {random 1-100} и другие из раздела «Как это работает».

!рулетка, !шар или !уровень не отвечают

Игра или уровни выключены: Игры и розыгрыши → Мини-игры или Очки и уровни → Система уровней. Ещё причина — тот же зритель вызвал команду меньше 5 секунд назад.

На !участвую бот отвечает «для участия напишите: …»

Розыгрыш создан «По ключевому слову»: участвуют, написав это слово в чат. Не начинайте ключевое слово с «!» — такое сообщение бот читает как команду и в розыгрыш не засчитывает.

Никто не может войти: «нужно минимум N баллов»

В розыгрыше заполнено «Мин. баллов для участия». Баллов зрителям бот пока не начисляет, поэтому порог выше нуля не проходит никто. Отмените розыгрыш и создайте новый, оставив это поле пустым.

Поздравление с уровнем пришло не сразу или списком

Так задумано: бот поздравляет с 3-го уровня и не чаще раза в 5 минут, а доросших за это время называет одним сообщением.

Из ответа команды пропало «/announce»

Twitch не выполняет «/announce…» от бота, а Kick такого не знает, поэтому бот срезает служебное слово и отправляет текст обычным сообщением.

Частые вопросы

Сколько это стоит?

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

Можно ли проиграть опыт в мини-играх?

Нет. Рулетка и дуэль только дают опыт победителю, проигравший ничего не теряет. Таймаутов мини-игры не дают.

Как поменять, сколько опыта дают игры?

Игры и розыгрыши → вкладка «Мини-игры», поле «XP за победу» для рулетки и дуэли, затем «Сохранить». То же в Telegram: «🎲 Мини-игры» → «⚡ Настроить XP за игры».

Как часто зритель может играть?

Каждая встроенная команда отвечает одному зрителю не чаще раза в 5 секунд. Дневного лимита на игры нет.

Работает ли это на Kick?

Частично. В чате Kick бот отвечает на !помощь, !команды, ваши команды, !уровень, !топ, !шар и !кубик, начисляет опыт за сообщения и засчитывает вход в розыгрыш по ключевому слову. !рулетка, !дуэль, !фортуна, !участвую и !голос — только в чате Twitch, а {uptime} в ответе своей команды на Kick пока пишет «оффлайн».

Что изменилось

  • Новая инструкция.
  • Мини-игры отвечают по-разному и недавние фразы в канале не повторяют. Поздравления с уровнем — с 3-го и не чаще раза в 5 минут, доросших бот называет одним сообщением. Розыгрыш и голосование, где уже кто-то участвовал, удаляются — раньше кабинет отвечал «Ошибка». Текст с «/announce…» из прежнего бота уходит обычным сообщением.
  • Галочки работают и в чате: «Только подписчики» у голосования пускает только подписчиков, «Множественный выбор» — по одному голосу за каждый вариант, а розыгрыш по ключевому слову соблюдает «Только подписчики» и «Макс. участников». Тип «Только подписчики» тоже пускает только подписчиков.

Всё готово к настройке?Страница откроется в кабинете после входа через Twitch.

Открыть «Команды» →