🎯 Что это и зачем
Картацион: интерактив, где зрители физически двигают тебя по карте донатами.
Формула по умолчанию: 1 ₽ = 1 метр реального пути (настраивается).
Твоя задача: физически дойти до финишной точки. Линия на карте это просто
ориентир, путь по улицам строй как удобно (ноги, велик, самокат, машина). Зритель видит,
как его 500 ₽ превратились в 500 твоих метров.
🗺 Настройка перед стримом
-
Стартовая точка. Открой Яндекс.Карты,
ПКМ на нужном месте → «Что здесь?» → скопируй координаты → вставь в поле «Начальная точка» → «Установить точку».
-
Цена за метр. По умолчанию
1 ₽ = 1 м. Подними (например 5 ₽ = 1 м),
если ожидаешь много донатов и маршрут короткий. Уменьши, если маршрут длинный и донатов мало.
-
DonationAlerts. Клик по иконке «Подключения» → вставь Client ID
твоего DA-приложения → «Подключить» → разреши доступ. Подключение живёт 1 год;
если истечёт, в углу всплывёт уведомление и модалка откроется сама.
-
Режим обработки донатов:
- Ручной: очередь замирает на каждом донате. Сумма подставляется
в поле, появляется баннер «⏳ Ожидаем ваш ход». Ты либо жмёшь стрелку направления
(донат засчитан, линия двигается, очередь идёт дальше), либо жмёшь «Пропустить»
если сообщение мусорное или без направления.
- Авто: направление парсится из сообщения доната, линия сдвигается сама.
Если направления в сообщении нет, донат просто пропускается и идёт следующий.
Распознаваемые слова в сообщении:
- Вверх: вверх, наверх, сверху, север, верхн…, ↑, up
- Вниз: вниз, снизу, юг, нижн…, ↓, down
- Влево: влево, слева, налево, запад, ←, left
- Вправо: вправо, справа, направо, восток, →, right
Если слов нет, донат запишется в лог, но линия не сдвинется. Если в сообщении
несколько направлений сразу, побеждает то, что встретилось раньше в тексте.
-
Кубик удачи (опционально, включается галочкой):
- Выпал чёт: сумма
× коэффициент.
- Выпал нечёт: сумма
÷ коэффициент.
- Автобросок вкл: бросается сам на каждом донате.
- Автобросок выкл: жмёшь рукой. В Авто-режиме очередь ждёт твоего броска
(всплывает баннер «⏳ Ждём ваш бросок»), это удобно для хайпа в кадре.
🎮 Во время стрима
- Новый донат → тост сверху (сумма, ник, сообщение, распознанное направление).
- Донаты копятся в очереди слева внизу (значок «🔔») и обрабатываются по одному в порядке прихода.
- Поле «Сумма в рублях» автоматически обновляется текущим донатом.
- В ручном режиме между донатами появляется баннер «⏳ Ожидаем ваш ход»: очередь стоит,
пока ты не нажмёшь стрелку (засчитывает донат и двигает линию) или «Пропустить»
(засчитывает без движения).
- Стрелки ↑ ↓ ← → двигают последнюю точку на
сумма / цена за метр метров.
- Кнопка отменяет последний шаг (Ctrl+Z для маршрута).
-
«Показать маршрут в навигаторе» → выбери транспорт (пешком / велик / авто) →
получишь QR-код на телефон + прямые ссылки на Яндекс.Навигатор и Google Maps.
⏱ Таймер
Обратный отсчёт 10 минут. запуск/пауза,
сброс, /
± 1 минута. Для челленджей «дойти за N минут».
🔄 Сброс
« Сбросить маршрут» (под «Установить точку») чистит маршрут,
undo-стек, очередь донатов и сумму. Не трогает: подключение к DA, темы, настройки кубика.
🛡 Что переживает F5 и разрыв интернета
- Маршрут (все сдвиги) + стартовая точка
- Очередь донатов: после возврата обработка продолжится
- Подключение DA, настройки, темы, таймер
-
При разрыве сети поллинг молча ждёт. Когда интернет вернётся, все пропущенные
донаты подтянутся из DA-истории, ни один не потеряется.
🎨 Оформление и карта
- Тема (левый верх): Классика (светлая фиолетовая) / Ретро (неоновая, пиксельный шрифт).
- Карта (ниже): Схема / Спутник / Гибрид. В Ретро-теме схема автоматически темнеет.
🖥 Окно для OBS
В очереди донатов (значок «🔔» слева внизу) разверни карточку и кликни
«Открыть окно для OBS». Откроется новая вкладка с адресом ?view=queue:
только очередь, прозрачный фон, больше ничего.
В OBS добавь Browser Source, в URL вставь эту ссылку, ширина ~520, высота под сцену.
Окно синхронизируется с главным в реальном времени через localStorage,
лишнего трафика и API-запросов нет.
💡 Советы для IRL
- Перед стримом прикинь реальный пробег за эфир и подкрути цену за метр соответственно.
- Если маршрут на карте ведёт через реку/забор/стройку, идёшь в обход. Главное дойти до точки.
- Сразу на старте отсканируй QR → загрузишь маршрут в Яндекс.Навигатор в телефоне.
- Скажи в чате, какие слова распознаются. Иначе в Авто-режиме часть донатов уйдёт «в лог» без движения.
- В горячие моменты выключай автобросок кубика: ручной бросок эмоциональнее смотрится.
- Если устал или потерял связь, переключайся в режим Ручной или жми «Сбросить маршрут» и начинай заново.