Создавайте игры и награды

Да, ваша игра может реагировать на подарки TikTok

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

Выберите шаблон

В каждом предпросмотре есть кнопки примеров и инспектор «Последние полученные данные». Примеры — искусственные события, не покупки. Предпросмотр никогда не подключается к живой сессии.

• В HTML найдите EDIT THIS RULE или EDIT THESE RULES.
• Поместите игровую логику в receive(data) функцию.
• Вспомогательные функции подключения и подсчёта находятся в starter.js. Стили находятся в starter.css.

Подключите шаблон за 3 шага

1. Запустите SSN и подключите чат. Проверьте, что чат и подарки появляются в Dock. Для TikTok см. режимы подключения.
2. Откройте шаблон без ?demo, используя ID сессии (и пароль, если задан).
3. Проверьте в браузере. Затем добавьте ту же ссылку в OBS как браузерный источник, например 1000 × 800.

https://socialstream.ninja/games/templates/coin-rocket.html?session=YOUR_SESSION&password=YOUR_PASSWORD&clean

• &clean скрывает инспектор, состояние соединения и кнопки ведущего.
• Нет пароля? Исключите &password=….
• На бета-сайте сохраните /beta/ перед games/.

Создайте свою копию и запустите с диска

Сервер устанавливать не нужно. Вы редактируете файл на компьютере и указываете его в OBS.

1. Скачать исходники beta в ZIP и распакуйте.
2. Скопируйте нужный шаблон рядом с оригиналом. Пример: games/templates/my-rocket.html.
3. Сохраните структуру папок. Шаблоны загружают js/local-server-url.js, а цель поддержки загружает currency.js из корневой папки. Изображения и звук тоже оставьте на месте.
4. Перетащите HTML-файл в Chrome или Edge и скопируйте file:/// адрес.
5. Добавьте всё начиная с ? и далее из рабочей ссылки игры (сессия, пароль, параметры передачи).
6. В OBS оставляем Локальный файл выключенным. Вставьте полный адрес в браузерном источнике в поле URL поле.
7. После каждой правки обновляйте браузерный источник.

file:///C:/SSN/social_stream-beta/games/templates/my-rocket.html?session=YOUR_SESSION&clean

Используйте настоящий путь. Не перемещайте распакованную папку. Сессия — ID подключения SSN, не название игры. Удалите demo для живых данных. Оставьте SSN и захват запущенными. Другие примеры: руководство по настройке файлов.

Customize [game file] to match [reference], at [canvas size].
Include its existing CSS/JS and local artwork/audio. Preserve the game's
rules, controls, gift/coin/USD distinctions, streak handling, duplicate
handling, and demo/clean modes. Change the visual design, not the reward rules,
unless I explicitly specify a rule change. Keep session/password and
transport parsing, relative paths, and Chrome 80-compatible classic scripts.
Read docs/event-reference.html and docs/making-games.html.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited game work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files/assets, file URL and OBS setup steps, and tests using
fictional data. Preserve image-only events and a valid donoValue of zero.
Never treat chat text as proof of a payment.

Как выбрать число монет для действия?

Сначала решите, что измеряете. Затем выберите число.

Точное значение, минимум или накопительный баланс?

• Точно: coins === 10. Подарок за 25 монет ничего не делает.
• Минимум на событие: coins >= 10.
• Накопительный баланс: это использует ракета. 25 монет = два ускорения с остатком 5 монет.

Несколько уровней? Проверяйте высший первым, чтобы один подарок не запускал все нижние.

Что отправляет каждая платформа

type сообщает, откуда пришло. event сообщает, что произошло, если присутствует. Полученные данные зависят от режима захвата, настроек и платформы. Это отражает текущий код SSN, а не обещает каждое событие каждому аккаунту.

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

Правильно используйте donoValue и currency.js

<script src="../../currency.js"></script>
<script>
// From games/templates/: use the existing helper, including its zero handling.
var usd = getDonationValueUSD(data);
// Use usd for your rule; display data.hasDonation for the original amount/unit.
</script>

Не делайте так

• donoValue || convertToUSD(...) — это отбрасывает намеренный ноль.
• Извлечение чисел из chatmessage для обнаружения платежей.
• Требование event === "donation" — у звёзд Facebook и некоторых Cheers нет события.

Шаблон цели поддержки сначала выбирает типы поддержки, затем вызывает общий конвертер.

Считайте серию подарков один раз

TikTok может передавать серию текущими итогами: 1, 2, 3. Это три подарка, не шесть. Запоминайте максимальный увиденный итог серии и прибавляйте только прирост.

// All three events refer to the same streak:
// incoming total: 1, 2, 3, 3
// added to game:  1, 1, 1, 0
var newCoins = RewardStarter.increment(data, RewardStarter.coins(data), 'coins');

• Вспомогательная функция сопоставляет серии по ID группы/отправителя/подарка TikTok, затем meta.tiktokGiftStreakId, затем ID сообщений. ID сообщений также блокируют повторную доставку.
• Он не ждёт repeatEnd, поскольку браузерный захват может никогда этого не отправить. Нужна одна акция только в конце серии? Напишите отдельное правило с полями вашей связи.
• Используйте один путь захвата. Второй захват того же канала может использовать другие ID и считать дважды.

Награды без собственной игры

В разделе Event Flow:

1. Добавить Сравнить свойство.
2. Установите donoValue, больше или равнои вашу сумму в USD.
3. Подключите действие: звук, анимацию или управление OBS.

Использует собственное значение источника, если оно допустимо, иначе — конвертацию валют SSN.

• Один конкретный подарок TikTok: сравнивают meta.giftId или meta.giftNameи ограничьте поток событиями подарков TikTok.
• Проверки чисел в hasDonation тоже превращаются в USD. Это не проверки исходных монет. Для правил монет используйте родные метаданные или собственный код.
• Каждая проверка выполняется для каждого сообщения. Это не накопительный баланс и не счётчик серии. Используйте узлы состояния если это нужно, или храните эту логику в игре.

Проверьте перед подключением платного действия

1. Кнопки примеров. Серия 1 → 2 → 3 добавляет три подарка. Пример с принудительным нулём не добавляет USD. Неизвестная цена не добавляет точные монеты.
2. Настоящий источник. Посмотрите реальные захваченные данные. Подтвердите имя/ID подарка, сумму, единицу, количество и событие. Примеры проверяют правило, а не живой захват.
3. сцена OBS. Проверьте повторные события, переподключение и перезагрузку. Не обновляйте и не отключайте браузерный источник, если нужно сохранить прогресс в памяти.

Подробнее о соединениях: собственные оверлеи.