PLGamesBot /Гайды/Награды за баллы
ИнструкцияВ эфире

Награды за баллы канала: как настроить

Зритель тратит баллы канала — бот делает то, что вы назначили награде: зачитывает текст, ставит трек в очередь, показывает картинку или принимает ставку. Награду можно создать в кабинете или взять ту, что уже есть на Twitch.

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

Коротко

  • Награды за баллы Twitch даёт только компаньонам и партнёрам.
  • Создайте награду на странице Награды Twitch кнопкой Награда — или выберите действие у награды, которая уже есть на канале.
  • Не сработало — бот отменяет активацию, и Twitch возвращает зрителю баллы. Это умеет только награда, созданная в кабинете.

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

  • Статус компаньона или партнёра Twitch: баллы канала есть только у них. Без него кабинет так и пишет на странице Награды Twitch.
  • Вход в кабинет через Twitch: через этот доступ бот создаёт награды и закрывает активации.
  • То, чем работает действие: плеер озвучки в OBS, запущенный плеер музыки, виджет алертов в OBS или открытая рулетка — смотрите таблицу ниже.
  • Чтобы бот объяснял зрителю отказ в чате, — включённый бот с правами модератора (/mod plgames_bot в своём чате).

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

  1. Откройте страницу наград

    В кабинете — Награды Twitch, вкладка Награды. Здесь все награды канала: и созданные в кабинете, и заведённые на самом Twitch — у таких стоит пометка «создана вами на Twitch». Награда без действия помечена «Бот ничего не делает».

  2. Создайте награду

    Нажмите Награда вверху страницы и заполните форму:

    1. Название и Стоимость — так награду увидят зрители;
    2. Действие бота — что сделать при активации, варианты в таблице ниже;
    3. Подсказка зрителю — что написать в поле награды, например «ссылка на YouTube»;
    4. Требовать ввод текста — для озвучки, заказа песни и ставки включается сам: без текста боту нечего делать;
    5. Создать на Twitch — награда сразу появится на канале.
  3. Или назначьте действие готовой награде

    У награды, заведённой на Twitch, выберите действие в её строке, в списке «Выберите действие…». Если зрители уже писали в неё ссылки или фразы, рядом появится подсказка вида «Похоже на «Заказ песни» — привязать». Помните: при отказе баллы за такую награду бот не вернёт.

  4. Подготовьте то, чем работает действие

    Для «Медиа-алерт» загрузите файл во вкладке Медиа и добавьте в OBS виджет алертов — ссылка в блоке OBS: Виджет алертов внизу вкладки Награды. Для «TTS-сообщение» нужен плеер озвучки, для «Заказ песни» — плеер музыки, для «Ставка на рулетку» — открытые ставки на странице Игры и розыгрыши, вкладка Рулетка.

  5. Проверьте

    Попросите зрителя или модератора взять награду. Во вкладке Активации появится строка: «Выполнено» — бот всё сделал, «Ожидает» — активация ждёт вас, «Отменено» — баллы вернулись зрителю.

Форма «Новая награда» на странице «Награды Twitch»: поля «Название», «Стоимость (Channel Points)», «Действие бота», «Подсказка зрителю», тумблер «Требовать ввод текста», кнопка «Создать на Twitch» и сообщение, что награды даёт только компаньонам и партнёрам
Форма «Новая награда». Ниже — то, что кабинет пишет каналу без статуса компаньона: баллов канала у него нет, а заказ музыки работает командой !заказ.
Создавайте награду в кабинете, а не на TwitchЗакрыть или отменить активацию Twitch позволяет только приложению, которое создало награду. Поэтому вернуть баллы, когда действие не сработало, бот может только у награды из кабинета. Награду, заведённую на Twitch, при отказе придётся закрывать вручную в очереди запросов наград на Twitch.

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

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

У награды, заведённой на самом Twitch, действие выполняется так же, но отменить активацию бот не может. При отказе он только назовёт зрителю причину, без «баллы вернутся», а активация останется «Ожидает» — вернуть баллы можно в очереди запросов наград на Twitch.

«Ручная обработка» — для наград, которые выполняете вы сами: спеть, сыграть со зрителем. Бот ничего не делает, активация ждёт во вкладке Активации. Зелёная галочка отмечает её выполненной, красный крестик отклоняет и возвращает баллы. У награды, заведённой на Twitch, обе кнопки меняют отметку только в кабинете — на Twitch такую активацию закройте сами.

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

Корзина удаляет по-разномуУ награды из кабинета корзина удаляет её и на Twitch. У награды, заведённой на Twitch, корзина снимает только действие бота — сама награда остаётся на канале.

Что умеет награда

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

ДействиеЧто делает ботЧто для этого нужно
Ручная обработканичего: активация ждёт вас во вкладке Активацииничего
TTS-сообщениезачитывает текст зрителя голосомплеер озвучки в OBS, текст в награде, озвучки в дневном лимите
Заказ песниставит трек по ссылке в очередьзапущенный плеер музыки, ссылка YouTube или SoundCloud в награде
Медиа-алертпоказывает на экране выбранный файлфайл во вкладке Медиа, виджет алертов в OBS
Ставка на рулеткуставит на вариант рулетки; вес ставки — цена наградыоткрытые ставки за баллы канала, номер варианта в тексте награды

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

Кабинет пишет «Награды за баллы Twitch даёт только компаньонам и партнёрам»

У канала пока нет статуса компаньона, а значит, и баллов канала. Озвучка всего чата и команда !заказ работают и без наград.

Зритель взял награду, а бот ничего не сделал

У награды не назначено действие — в её строке «Бот ничего не делает» — или стоит «Ручная обработка». Выберите действие в строке. За прошлые нажатия верните баллы кнопкой Вернуть баллы в красном блоке вверху.

Баллы не возвращаются: «Награду создало другое приложение»

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

Озвучка или заказ отменяются: «в награде нет текста» или «пришлите ссылку»

Награда не просит у зрителя текст. Создайте её в кабинете с включённым Требовать ввод текста — или включите ввод текста в настройках награды на Twitch, если она заведена там.

Медиа-алерт ничего не показывает

Виджет алертов не добавлен в OBS или стоит не в той сцене: ссылка — в блоке OBS: Виджет алертов на вкладке Награды. Проверьте и то, что у награды выбран файл: при «Медиа-алерт» рядом с действием появляется второй список — с файлами.

Активации вообще не появляются в кабинете

Twitch присылает их по подписке, которая создаётся при входе в кабинет и проверяется каждые шесть часов. Если вы отзывали доступ PLGamesBot в настройках Twitch, выйдите из кабинета и войдите снова через Twitch.

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

Можно ли использовать награды, которые уже есть на канале?

Да. Кабинет показывает все награды канала, и любой можно назначить действие прямо в её строке. Разница одна: при отказе баллы за такую награду бот не вернёт — Twitch даёт менять активации только приложению, которое создало награду.

Что видит зритель, если действие не сработало?

Бот пишет ему в чат причину — например, «плеер музыки сейчас не запущен, заказ не принят» или «ставка не принята: ставки закрыты». Если Twitch принял отмену, в конце добавляется «баллы вернутся». Без прав модератора бот молчит, и сообщения не будет.

Сколько файлов можно загрузить для медиа-алертов?

Один файл — до 10 МБ: видео MP4 и WebM, звук MP3, WAV и OGG, картинки PNG, JPG, GIF и WebP. Всего на бесплатном тарифе — 10 файлов и 50 МБ, на Старте — 100 файлов и 500 МБ, на Про — 5 ГБ без ограничения по числу файлов.

Работают ли награды на Kick?

Пока нет: с Kick бот получает только сообщения чата, активации наград оттуда не приходят. Эта инструкция — про баллы канала Twitch.

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

  • Отказ награды объясняется зрителю в чате, а баллы возвращаются — при заказе без ссылки, при сбое озвучки и при исчерпанном лимите. Ссылку в заказе песни можно вставить без https.
  • Каналу без статуса компаньона кабинет прямо пишет, почему наград нет. Заказ песни за баллы при незапущенном плеере отменяется с возвратом баллов.

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

Открыть «Награды Twitch» →