Skip to content

streamerbot.md

Latest commit

 

History

History
63 lines (44 loc) · 5.18 KB

streamerbot.md

File metadata and controls

63 lines (44 loc) · 5.18 KB

Инструкция по интеграции Donaton Timer со Streamer.bot

Эта инструкция описывает точный алгоритм настройки связки между Donaton Timer и Streamer.bot, чтобы вы могли добавлять время на таймер за любые события (сабки, битсы, фолловы, баллы канала и кастомные команды).

Как работает интеграция?

Приложение Donaton Timer подключается напрямую к встроенному WebSocket-серверу Streamer.bot. Вы сами указываете, какие именно события таймер должен слушать, и какую "денежную сумму" он должен за них начислять.

Шаг 1. Настройка Streamer.bot

  1. Откройте Streamer.bot.
  2. Перейдите во вкладку Servers/Clients -> WebSocket Server.
  3. Убедитесь, что стоит галочка Auto Start, а сам сервер запущен (статус Started).
  4. Запомните IP и Port. По умолчанию это 127.0.0.1 и 8080.

Шаг 2. Подключение в Donaton Timer

  1. Откройте Donaton Timer и нажмите на иконку шестерёнки (Настройки).
  2. Найдите секцию Streamer.bot.
  3. Включите галочку активации интеграции.
  4. Введите адрес WebSocket. По умолчанию: ws://127.0.0.1:8080/.

Шаг 3. Привязка событий (Маппинги)

Чтобы таймер реагировал на события, нужно создать для них "Привязки" (Event -> Сумма). Нажмите + Добавить событие в настройках Donaton Timer.

Перед вами 3 поля. Обратите внимание, что Streamer.bot чувствителен к регистру! Пишите Source и Type точь-в-точь как в таблицах ниже.

Поле "Сумма" (Очень важно!)

  • Если указать больше нуля (например, 130): При срабатывании этого события таймер всегда будет засчитывать ровно 130 рублей, игнорируя любые настоящие данные из Streamer.bot. Идеально для сабок, фолловеров и баллов канала.
  • Если указать 0 (динамическая сумма): Таймер "полезет" внутрь данных самого события, присланного от Streamer.bot, и попытается сам найти там сумму доната (поля amount или bits). Если он её найдет — начислит ровно столько времени, сколько эквивалентно этой настоящей сумме.

Примеры популярных привязок для Twitch

Что хотите отслеживать Source Type Сумма
Обычная Сабка (Sub) Twitch Sub 130 (фиксированная цена)
Ресаб (ReSub) Twitch ReSub 130 (фиксированная цена)
Подарочная сабка (GiftSub) Twitch GiftSub 130 (фиксированная цена)
Битсы (Cheer) Twitch Cheer 0 (таймер сам прочитает кол-во битсов из события)

Примеры кастомного

Что хотите отслеживать Source Type Сумма
Кастом General Custom 0 (таймер сам прочитает кол-во amount из события)

Заметка: Если вам нужны награды за баллы канала, можете использовать Source: Twitch, Type: PointRedemption, и указать нужную фиксированную цену (эквивалент в рублях).

Как передать кастомные донаты (Например, из C# или макросов)

Если вы генерируете собственные кастомные события внутри Streamer.bot (например, интеграция со сторонними сервисами через код), вы можете ловить их в Donaton Timer.

  1. В Donaton Timer добавьте привязку:
    • Source: General
    • Type: Custom
    • Сумма: 0 (чтобы передавать динамическую сумму из кода)
  2. В Streamer.bot убедитесь, что при трансляции события (Broadcasting) в объект data вы отправляете поле amount (сумма доната) и, желательно, поле user или name (имя зрителя). Таймер автоматически подхватит эти данные.