Ивенты роста

Ивенты роста — это игровые механики для чата вокруг команды !рост. Зрители проверяют рост, копят сантиметры, попадают в комбо, участвуют в случайных событиях и получают бонусы за активность в начале стрима.

Раздел нужен, чтобы владелец мог управлять темпом этой мини-игры:

• включить или выключить случайные ивенты;
• выбрать окно, когда ивент может стартовать после начала стрима;
• настроить бонус за ранний старт;
• выбрать короткий или полный ответ бота на !рост;
• включить или отключить конкретные ивенты;
• настроить казино;
• при необходимости сбросить рост или серии.

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

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

Как это работает для зрителя

Основная команда зрителя — !рост.

Когда зритель пишет !рост во время онлайн-стрима, PulseCaster проверяет его текущий рост на канале и меняет значение. Базовая проверка задумана как мягкий ежедневный ритуал: обычно рост увеличивается, пропуски стримов сбрасывают серию, но не списывают рост отдельно, а случайный регресс ограничен. Бонусы, фонтаны, комбо и ранний старт могут влиять на итог.

Важные принципы:

• один зритель может полноценно проверить рост один раз в день;
• если зритель уже проверял рост сегодня, бот покажет текущий рост и время следующей проверки;
• по умолчанию бот отвечает коротко; раскладка Состоит из: ... и шуточные факты о пройденных отметках роста есть только в полном ответе;
• бонусы от ивентов обычно начисляются на завтра;
• часть ивентов требует активного онлайн-стрима;
• случайные ивенты запускаются автоматически после старта стрима или вручную командой модератора.

Где включать команды

Перед настройкой проверьте Общие настройки.

Для роста важны команды:

Команда	Для чего
!рост	проверка и изменение личного роста
!топрост [количество]	топ участников по росту; от 1 до 50, по умолчанию 5
!ивент	ручной запуск и остановка ивентов владельцем или модератором

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

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

Откройте страницу Владелец → Интерактивные игры → Ивенты роста.

Главная страница разделена на вкладки: Игра с настройками, Сцены OBS с редакторами двух источников и Рейтинг с топом участников. На вкладке Игра сброс прогресса свёрнут по умолчанию; раскройте его, если нужно начать заново.

Доступные блоки:

Блок	Что настраивает
Топ-5 роста	текущие лидеры канала, рост и серия; обновляются при открытии страницы и после ручного сброса
Сброс прогресса	отдельный сброс роста и серии с подтверждением
Ответ на !рост	короткий или полный ответ бота в чате
Бонус за ранний старт	усиление !рост в первые минуты после начала стрима
Случайные ивенты роста	глобальный запуск ивентов и переход к настройке конкретных событий

Ответ на !рост

Блок задаёт, что бот пишет в чат после проверки роста. Вариантов два, на странице у каждого есть пример сообщения.

Вариант	Что в ответе
Коротко (по умолчанию)	результат за день, текущий рост и серия просмотров, если она от трёх дней
Полностью	то же, плюс строка Состоит из: ... с раскладкой бонусов и шуточный факт, когда рост пересекает отметку

Пример короткого ответа:

Nika, +6 см! Теперь у тебя 120 см. Серия просмотров 5 дней.

Тот же результат в полном ответе:

Nika, +6 см! Теперь у тебя 120 см. Состоит из: база +4 см, серия просмотров +2 см, теперь 120 см. 120 см — уровень школьного рекорда. Серия просмотров 5 дней.

Сообщения о фонтанах, серии и регрессе приходят в обоих вариантах. Если зритель уже проверял рост сегодня, бот в любом случае коротко напомнит текущий рост и время следующей проверки.

Короткий ответ меньше засоряет чат. Полностью стоит выбрать, если чату интересно, из чего складывается результат: бонусы, фонтан, серия и балансирующие поправки.

Бонус за ранний старт

Бонус за ранний старт поощряет зрителей приходить в начале эфира. Если зритель пишет !рост в заданное окно после старта стрима, результат усиливается.

Настройки:

Поле	Что означает
Бонус включен	включает или выключает ранний бонус
Окно бонуса	сколько минут после старта стрима действует усиление
Режим бонуса	как именно усиливать результат
Множитель раннего бонуса	во сколько раз усилить результат, если выбран режим Множитель
Добавка раннего бонуса	сколько см добавить, если выбран режим Добавка

Множитель или добавка

Режим	Как работает	Когда выбрать
Множитель (xN)	усиливает результат в несколько раз	если хотите заметный “стартовый разгон”
Добавка (+N)	добавляет фиксированное число сантиметров	если нужен более спокойный и предсказуемый бонус

Пример:

• окно бонуса: 10 минут;
• режим: Множитель;
• множитель: 2.

В первые 10 минут стрима !рост будет работать сильнее, а после окна вернётся к обычной логике.

Как начать

Для первого запуска оставьте окно 10 минут и умеренный множитель. Если чат начинает слишком сильно спамить !рост в начале эфира, уменьшите окно или переключитесь на фиксированную добавку.

Случайные ивенты роста

Случайные ивенты роста — это события, которые оживляют чат во время эфира.

На главной странице задаётся:

Поле	Что означает
Ивенты включены	общий переключатель всех случайных ивентов
Окно старта ивента	через сколько минут после старта стрима бот может запустить случайный ивент

Окно старта ивента задаётся диапазоном. Например, 10-60 мин означает: после начала стрима PulseCaster выберет момент внутри этого окна и попробует запустить один случайный ивент.

Если Ивенты включены выключены, конкретные ивенты на отдельной странице тоже не стартуют.

Настройка конкретных ивентов

Нажмите Настроить ивенты, чтобы открыть страницу Случайные ивенты.

Там можно включать и выключать отдельные события.

Ивент	Как работает	Команда зрителя
Быстрая зарядка	первый зритель, который успел написать команду, получает бонус на завтра	!зарядка
Комбо	три разных зрителя подряд пишут команду роста, и все трое получают бонус	!рост
Качок чата	пять минут собираем участников; каждый получает от +1 до +4 см	!качок
Фонтан роста	зрители вкладывают свой рост; при успехе получают возврат и фонтан-награду, при провале вклад сгорает	!фонтан или !фонтан <число>
Лавина	участники входят в общий пул; кто вошёл раньше, получает большую долю при успехе	!лавина
Шторм / Штиль	чат голосует за сторону, результат зависит от голосов и баланса выбора	!шторм или !штиль
Казино	временное окно со ставками роста и слотами	!казино, !казино <ставка>, !казино правила

Ивент: Быстрая зарядка

Быстрая зарядка — самый простой ивент на скорость реакции.

Как проходит:

1. Бот объявляет зарядку в чате.
2. Первый зритель, который пишет !зарядка, забирает бонус.
3. Бонус начисляется на следующий день.

Если никто не успел, ивент завершится без победителя.

Подходит для коротких всплесков активности: чат быстро реагирует, но ивент не требует долгого объяснения.

Ивент: Комбо

Комбо работает вокруг обычной команды !рост.

Как проходит:

1. Один зритель пишет !рост.
2. Затем второй другой зритель пишет !рост.
3. Затем третий другой зритель пишет !рост.
4. Если цепочка не сбилась, все трое получают бонус на завтра.

Важно: комбо сбрасывается, если между командами роста появляются обычные сообщения. То есть чат должен действительно собрать цепочку, а не случайно набрать её за полстрима.

Комбо хорошо работает как мягкая механика командного вовлечения: зрители зовут друг друга проверить рост, а PulseCaster помогает не держать это в голове.

Ивент: Качок чата

Бот открывает тренировку на пять минут. Зритель присоединяется командой !качок один раз; повтор команды не увеличивает счётчик. После окончания все участники получают одинаковый бонус к следующей доступной проверке !рост.

Уникальных участников	Бонус каждому
1–2	+1 см
3–5	+2 см
6–11	+3 см
12 и больше	+4 см

Даже один участник получает награду. После достижения +4 см сбор остаётся открытым до конца таймера. Владелец не выбирает награду вручную: ступени и время фиксированы.

Бонус «Качка» прибавляется после всех множителей и балансирующих поправок. Ранний старт и фонтаны его не умножают. Один зритель получает одну награду за игровой день (полночь МСК); ручной перезапуск события не снимает ограничение. Если проверки роста пропускаются, ожидающий бонус не складывается: сохраняется большая награда, максимум +4 см.

Ручная остановка отменяет незавершённую тренировку без награды. Сброс роста очищает ожидающий бонус, но не разрешает получить вторую награду в тот же день. При перезапуске процесса незавершённая тренировка не восстанавливается; уже начисленные бонусы сохраняются в базе.

Сцены роста для OBS

На странице Ивенты роста откройте вкладку Сцены OBS и выберите источник. Редактор показывает превью рядом с настройками; на узком экране настройки находятся под ним. Черновики и созданные ссылки сохраняются при переключении вкладок в пределах открытой страницы. Доступны два независимых источника:

• Ивенты роста — общий виджет для Качка, зарядки, комбо, фонтана, лавины, шторма и казино. Показывает активное событие, участников, прогресс, таймер и команду участия; итоги остаются на десять секунд. Если одновременно собирается комбо, активный основной ивент имеет приоритет.
• Результаты роста — небольшие уведомления после успешной проверки !рост, включая отрицательный результат. Смена лидера, вход в топ-3 и личный рекорд показываются заметнее. Обычные результаты и достижения включаются отдельно; при совпадении показывается одно уведомление с достижением.

У каждого источника свои цвета, фон, непрозрачность, ширина, скругление и размер текста. Нажмите элемент в превью или выберите его в панели оформления. Для ивентов доступны карточка и полоса, таймер можно скрыть. Нажмите Сохранить сцену: OBS подхватит изменения автоматически.

Создайте ссылку нужного источника, скопируйте её и добавьте в OBS: Источники → + → Браузер. Используйте размер, указанный рядом со ссылкой. Добавив оба источника, можно разместить их отдельно и включать только нужный источник на каждой сцене OBS. Если источник выключен в кабинете, его ссылка временно перестаёт отдавать содержимое.

Ссылка содержит секретный токен. По умолчанию он скрыт; база хранит только хеш. После закрытия редактора ранее созданная ссылка продолжает работать. Если адрес потерян или раскрыт, нажмите Заменить ссылку и обновите адрес в OBS: прежняя ссылка перестанет работать.

Результаты показываются по одному: остальные ждут в очереди за кадром, вертикального списка нет. В Размещение уведомлений выберите положение внутри источника: сверху, по центру или снизу, с выравниванием слева, по центру или справа. Появление настраивается отдельно: сверху, снизу, слева, справа или плавно. Кнопка Повторить в превью воспроизводит анимацию. Чтобы закрепить уведомления у нижнего края, выберите, например, Снизу слева и Снизу. Сам источник по-прежнему можно перемещать и менять его высоту в OBS. У прежних настроек сохраняется положение сверху слева и появление снизу; пересоздавать ссылку не нужно.

Уведомления идут очередью: обычное — 2,2 секунды, достижение — 5,5 секунды с приоритетом. При всплеске активности очередь ограничена, часть обычных результатов объединяется в счётчик. Результаты старше двадцати секунд отбрасываются; при первом открытии история не воспроизводится. Проверка !рост, уже выполненная сегодня, не создаёт повторного уведомления.

Ивент: Фонтан роста

Фонтан роста — более рискованный ивент.

Зрители вкладывают свой рост, и этот вклад списывается сразу. Если фонтан собран, участники получают возврат и фонтан-награду. Если фонтан не собран, вклад сгорает.

Команды:

!фонтан
!фонтан <число>

Если написать !фонтан без числа, бот подскажет рекомендуемый вклад. Если написать !фонтан 10, зритель попробует вложить 10 см.

Что важно объяснить чату:

• это не бесплатный бонус;
• вклад списывается сразу;
• есть личный лимит вклада;
• при успехе возможен возврат;
• при провале вклад теряется.

Рискованный ивент

Фонтан роста лучше включать, когда чат уже понимает механику !рост. Для первого теста можно оставить включёнными более простые ивенты: зарядку, комбо и коллективный челлендж.

Ивент: Лавина

Лавина распределяет общий пул между участниками.

Как проходит:

1. Бот объявляет общий пул и минимальное число участников.
2. Зрители пишут !лавина.
3. Один зритель может войти один раз.
4. Если участников достаточно, пул распределяется между ними.
5. Те, кто вошёл раньше, получают большую долю.

Если участников меньше минимума, награда не выдаётся.

Лавина хорошо подходит для активного чата: она создаёт гонку на вход, но не требует ставок от зрителей.

Ивент: Шторм / Штиль

Шторм / Штиль — голосование с риском перекоса.

Команды:

!шторм
!штиль

Как проходит:

1. Бот объявляет голосование.
2. Каждый участник выбирает одну сторону.
3. За участие может быть бонус на завтра.
4. Победившая сторона получает награду по правилам ивента.
5. Если слишком много людей выбрали один вариант, награды могут отмениться и сработает штраф.

Ивент лучше не объяснять как “просто голосование”. В нём важен баланс: если весь чат бездумно идёт в одну сторону, результат может стать хуже.

Ивент: Казино

Казино открывает временное окно, где зрители ставят свой рост.

Команды:

!казино
!казино <ставка>
!казино правила

Если зритель пишет !казино без ставки, используется ставка по умолчанию. Если пишет !казино 10, бот попробует поставить 10 см.

Настройки казино:

Поле	Что означает
Окно ивента	сколько минут казино активно
Ставка по умолчанию	ставка для команды !казино без числа
Кулдаун на игрока	минимальный интервал между прокрутками одного игрока
Минимальная ставка	меньше этого значения поставить нельзя
Макс. ставка (cap)	жёсткий потолок ставки в см
Макс. ставка (%)	ограничение ставки от текущего роста зрителя

Максимальная ставка считается по двум ограничениям: фиксированный потолок в сантиметрах и процент от роста игрока. Это защищает зрителей от слишком больших потерь.

Ручной запуск и остановка

Владелец или модератор может запускать и останавливать ивенты командой !ивент.

Доступные варианты:

!ивент зарядка
!ивент качок
!ивент фонтан
!ивент лавина
!ивент шторм
!ивент казино
!ивент стоп

!ивент стоп останавливает активный ивент, если он сейчас идёт.

Ручной запуск полезен, если:

• автоматический ивент не стартовал в нужный момент;
• хочется запустить конкретную механику под сцену на стриме;
• нужно проверить ивент перед полноценным использованием;
• чат сам попросил конкретный формат.

Команды зрителей

Команда	Кто использует	Что делает
!рост	зрители	проверяет и меняет личный рост
!см	зрители	то же, что !рост
!cm	зрители	то же, что !рост
!sm	зрители	то же, что !рост
!топрост [количество]	зрители	показывает топ роста; можно вывести до 50 участников
!росттоп	зрители	показывает топ роста
!топсм	зрители	показывает топ роста
!смтоп	зрители	показывает топ роста
!зарядка	зрители	участвует в быстрой зарядке
!качок	зрители	участвует в коллективном челлендже
!фонтан	зрители	показывает подсказку или рекомендуемый вклад в фонтан
!фонтан <число>	зрители	вкладывает указанное число см в фонтан
!лавина	зрители	входит в лавину
!шторм	зрители	голосует за шторм
!штиль	зрители	голосует за штиль
!казино	зрители	играет со ставкой по умолчанию
!казино <ставка>	зрители	играет с указанной ставкой
!казино правила	зрители	показывает правила казино

Команды владельца и модераторов

Команда	Что делает
!ивент зарядка	запускает быструю зарядку
!ивент качок	запускает коллективный челлендж
!ивент фонтан	запускает фонтан роста
!ивент лавина	запускает лавину
!ивент шторм	запускает шторм / штиль
!ивент казино	запускает казино
!ивент стоп	останавливает текущий активный ивент

Сброс прогресса

На главной странице настроек роста есть блок Сброс прогресса; со страницы Случайные ивенты он перенесён сюда.

Ответ GET /channels/{id}/growth-settings дополнен leaderboard: до пяти записей с display_name, current_value и combo_streak, на основе существующего рейтинга роста. Основная страница и страница ивентов читают настройки с include_leaderboard=false; это исключает SQL рейтинга из запроса. Топ-5 загружается отдельно через GET /channels/{id}/growth-settings?view=leaderboard и не блокирует настройки. При ошибке рейтинга показывается отдельное сообщение, настройки остаются доступны. Запрос только рейтинга ограничен двумя секундами. Для совместимости запрос без параметров сохраняет комбинированный ответ, но ожидание рейтинга ограничено 750 мс; если рейтинг не загрузился, настройки возвращаются без него.

Доступны два действия:

Действие	Что меняет
Сбросить рост (серии сохранить)	обнуляет рост у участников, очищает бонусы, фонтаны и ожидания ивентов, но сохраняет серии
Сбросить только серии	сбрасывает только счётчик серий у всех участников

Оба действия необратимы. Используйте их только если точно хотите начать сезон заново или исправить сильно сломанный баланс.

Рекомендуемая настройка для старта

Если вы включаете рост впервые:

1. Проверьте в Общих настройках, что включены !рост, !топрост и !ивент.
2. Включите Бонус за ранний старт.
3. Оставьте окно раннего бонуса около 10 минут.
4. Включите случайные ивенты глобально.
5. Начните с простых ивентов: Быстрая зарядка, Комбо, Коллективный челлендж, Лавина.
6. Фонтан и Казино подключайте, когда чат уже понимает, что рост может списываться.
7. После пары стримов посмотрите, не слишком ли часто чат отвлекается на команды.

Когда что отключать

Ситуация	Что сделать
Чат слишком часто отвлекается на игру	уменьшить окно раннего бонуса или выключить случайные ивенты
Зрители не понимают риск	временно выключить Фонтан роста и Казино
Ивенты мешают серьёзному сегменту стрима	выключить глобальный тумблер или остановить активный ивент через !ивент стоп
Комбо срабатывает слишком шумно	выключить Комбо на странице конкретных ивентов
Казино слишком разгоняет или просаживает рост	уменьшить ставку по умолчанию, максимум ставки или окно казино

Чеклист перед стримом

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

Остановка после окончания стрима

Первый сигнал stream.offline отменяет локальные отложенные и активные ивенты роста, дуэли (без поражений и таймаутов), меню и дропы «Большого дела». Автоматические сообщения роста, меню и дропов дополнительно проверяют общее состояние стрима перед отправкой: они не публикуются после offline даже в течение окна повторных проверок, когда запись стрима ещё считается активной. Это работает и при раздельных процессах stream-state-projector и twitch-chat-execution. Уже отправленные сообщения не удаляются.

Предметы и личный кабинет

Предметы роста добавляют награды за серии, усиление, кражу, секатор и автоматический щит. Откройте вкладку «Предметы и журнал» в настройках роста; по умолчанию механика выключена. Кабинет зрителя — /play/growth, вход через Twitch, отдельный прогресс на каждом канале.