Награда топу роста¶
Награда топу роста раз в настроенный период автоматически выдаёт мемкоины через 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 |
- Включите
Интерактив включён— без него не работают ни ручной запуск, ни автовыдача, ни напоминания. - Настройте период:
- для месяцев укажите день сброса. Первый итог наступает в ближайший такой день после включения интерактива: если настроить 15 сентября с днём сброса 1, первый итог будет 1 октября, а не задним числом 1 сентября. Если в каком-то месяце нужного числа нет (31 число в апреле), сработает последний день месяца;
- для дней период отсчитывается от последней выдачи, а до первой — от момента включения.
- Настройте места и суммы.
- Настройте сброс. Он выполняется только при настоящей выдаче; предпросмотр ничего не меняет.
- Нажмите
Сохранить настройки.
Прежде чем включать автозапуск¶
Тумблер Доверить расписанию автоматический запуск — отдельный и по умолчанию выключен, даже если
всё остальное настроено. Пока он выключен, выплата происходит только вручную по кнопке
Запустить сейчас.
Рекомендованный порядок первого включения:
- Нажмите
Предпросмотр— PulseCaster покажет топ, суммы и результат поиска на MemeAlerts, но ничего не выдаст и ничего не сбросит. - Проверьте результат: правильные ли места, находятся ли зрители на MemeAlerts.
- Если всё верно и вы готовы к реальной выдаче прямо сейчас — нажмите
Запустить сейчас(потребует подтверждения, это реальное списание мемкоинов, отменить нельзя). - Только после этого включайте
Доверить расписанию автоматический запуск.
Напоминания в 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 запустил сам.