Перейти к содержанию

Награда топу роста

Награда топу роста раз в настроенный период автоматически выдаёт мемкоины через MemeAlerts лучшим по !рост и обнуляет рост и/или серию, чтобы гонка началась заново. Это мотивация заходить и пользоваться !рост регулярно, а не разово.

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

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

Только сброс по расписанию

Включите Только сброс, без мемкоинов, выберите сброс роста и/или серии, настройте период и включите Доверить расписанию автоматический запуск. Сохраните настройки. Подключение MemeAlerts не требуется: бот не ищет саппортеров и не выдаёт бонусы. Ручной запуск требует подтверждения, предпросмотр ничего не сбрасывает. Итог записывается в журнал. Запуск блокируется, пока изменения на странице не сохранены.

В API режим задаётся пустым списком places (PUT /channels/{id}/growth-payout/places). Должен быть включён хотя бы один флаг reset_growth или reset_streak; без мест и без сброса запуск возвращает ошибку. Для возврата к выдаче выключите режим и заново сохраните места и суммы. Схема базы и расписание не меняются.

Что нужно перед настройкой

Режим выдачи мемкоинов использует официальное OAuth-подключение MemeAlerts (см. Донат-платформы) со scope oauth-bonus-give. Если MemeAlerts уже подключён без этого разрешения, откройте Донат-платформы → MemeAlerts и нажмите Подключить через MemeAlerts ещё раз — это переоформит доступ с нужным разрешением.

Выдача идёт только зрителям, которые хотя бы раз поддерживали канал на MemeAlerts. Если ник в Twitch-чате совпадает с ником на MemeAlerts, PulseCaster находит саппортера по точному совпадению имени автоматически. Если ники разные, укажите пару в блоке Связка ников с MemeAlerts на этой же странице (см. Связка ников Twitch и MemeAlerts) — и PulseCaster начнёт находить зрителя по связанному имени. Пока связки нет или совпадения не нашлось, место помечается в журнале как Не найден на MemeAlerts — деньги никому не уходят, но занявший место никуда не теряется: выдайте вручную на memealerts.com и переходите дальше.

Как настроить

Откройте Владелец → Интерактивные игры → Награда топу роста. Страница разбита на блоки:

Блок Что настраивается
Расписание Интерактив включён, длина периода в днях или месяцах, день сброса для месяцев
После выдачи Сбрасывать рост и Сбрасывать серию
Места и суммы сколько мемкоинов получает каждое место, от 1 до 20 мест
Автозапуск и напоминания Доверить расписанию автоматический запуск и Напоминать мне в Telegram
  1. Включите Интерактив включён — без него не работают ни ручной запуск, ни автовыдача, ни напоминания.
  2. Настройте период:
  3. для месяцев укажите день сброса. Первый итог наступает в ближайший такой день после включения интерактива: если настроить 15 сентября с днём сброса 1, первый итог будет 1 октября, а не задним числом 1 сентября. Если в каком-то месяце нужного числа нет (31 число в апреле), сработает последний день месяца;
  4. для дней период отсчитывается от последней выдачи, а до первой — от момента включения.
  5. Настройте места и суммы.
  6. Настройте сброс. Он выполняется только при настоящей выдаче; предпросмотр ничего не меняет.
  7. Нажмите Сохранить настройки.

Прежде чем включать автозапуск

Тумблер Доверить расписанию автоматический запуск — отдельный и по умолчанию выключен, даже если всё остальное настроено. Пока он выключен, выплата происходит только вручную по кнопке Запустить сейчас.

Рекомендованный порядок первого включения:

  1. Нажмите Предпросмотр — PulseCaster покажет топ, суммы и результат поиска на MemeAlerts, но ничего не выдаст и ничего не сбросит.
  2. Проверьте результат: правильные ли места, находятся ли зрители на MemeAlerts.
  3. Если всё верно и вы готовы к реальной выдаче прямо сейчас — нажмите Запустить сейчас (потребует подтверждения, это реальное списание мемкоинов, отменить нельзя).
  4. Только после этого включайте Доверить расписанию автоматический запуск.

Напоминания в Telegram

Тумблер Напоминать мне в Telegram включён по умолчанию. Сообщение приходит владельцу канала в личку от бота PulseCaster — не чаще одного раза за период. Что именно придёт, зависит от автозапуска:

Автозапуск Когда Что в сообщении
выключен когда период закончился напоминание подвести итоги, текущий топ и что сбросится после выдачи
включён, выдача прошла сразу после автовыдачи сколько мест выдано автоматически, кого выдать вручную и почему, готовый текст для публикации
включён, выдача не прошла когда MemeAlerts отказал в доступе или не ответил что мемкоины не выданы и рост не сброшен, причина и что сделать

Если в топе на момент напоминания никого нет, сообщение не отправляется. Если после сообщения о сбое выдача всё-таки прошла, придёт второе сообщение — уже с итогами.

Если сообщения не приходят, проверьте, что вы запускали бота PulseCaster в Telegram: бот не может написать тому, кто ни разу с ним не общался.

Текст для публикации

После предпросмотра или выдачи под результатом появляется блок Текст для публикации с кнопкой Скопировать текст для публикации. Текст можно выложить в Telegram, VK или Discord без правок.

  • У выдачи это итоги: места, рост и награда. Про сброс роста и серии текст пишет, только если сброс действительно выполнился.
  • У предпросмотра это текущий топ «на сегодня», без слов об итогах и сбросе.
  • Места, до которых никто не дошёл, в текст не попадают.

Тот же текст приходит в Telegram-напоминании после автовыдачи. Текст есть и у старых запусков — откройте нужный запуск в журнале.

Журнал запусков

Каждый запуск — предпросмотр или боевой, ручной или по расписанию — попадает в журнал с раскрытием по местам. Статус места:

Статус Что значит
Выдано мемкоины успешно отправлены через MemeAlerts
Не найден на MemeAlerts на этом месте есть зритель по !рост, но саппортера с таким именем на MemeAlerts не нашлось — свяжите ники в блоке Связка ников с MemeAlerts на этой странице или выдайте вручную
Ошибка MemeAlerts запрос к MemeAlerts не прошёл, под именем зрителя видна причина из ответа MemeAlerts
Предпросмотр это был предпросмотр — выдача не выполнялась

Если в каком-то месте пока никого нет (например, играющих меньше, чем настроено мест), место остаётся пустым и помечается как не найденное — это нормально для новых или маленьких каналов.

Если MemeAlerts отказывает в доступе (HTTP 401)

Когда MemeAlerts отклоняет токен канала, PulseCaster один раз обновляет токен и повторяет запрос. Если отказ повторяется, выдача ведёт себя так:

  • Боевой запуск останавливается до выдачи. Сначала PulseCaster ищет всех победителей на MemeAlerts и только потом платит. Если MemeAlerts отказал уже при поиске или не ответил ни по одному зрителю (например, сервис недоступен), мемкоины не списываются, рост и серия не сбрасываются, запуск в журнал не попадает, а на странице видна причина. Период при этом не считается закрытым — выдачу можно повторить.
  • Предпросмотр сохраняется в журнале со статусом Есть проблема: места, которые не удалось проверить, помечены не проверено: MemeAlerts отказал в доступе.
  • Если отказ пришёл посреди выплат или ни одному зрителю не удалось выдать мемкоины, уже выданные места остаются выданными, остальные помечаются для ручной выдачи, а рост и серия не сбрасываются — чтобы никто не потерял место без награды. Зрители, которых просто не нашли на MemeAlerts, сброс не останавливают: им выдают вручную.
  • Автозапуск после отказа пробует снова раз в час и, если включены напоминания, один раз сообщает о сбое в Telegram. Ручной Запустить сейчас можно нажать в любой момент.

Что делать: откройте Донат-платформы → MemeAlerts, переподключите MemeAlerts и повторите Предпросмотр. В тексте ошибки PulseCaster показывает объяснение, которое вернул сам MemeAlerts, — по нему видно, в чём причина.

Ограничения

  • Одна выдача не превышает 1000 мемкоинов за запрос к MemeAlerts; более крупная сумма места автоматически разбивается на несколько последовательных запросов, зритель получает сумму целиком.
  • MemeAlerts не даёт отменить Выдано — при сомнениях сначала используйте Предпросмотр.
  • Ext-api MemeAlerts не хранит историю: журнал показывает только то, что PulseCaster запустил сам.