Створюйте ігри й нагороди

Так, ваша гра може реагувати на подарунки 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 й рахувати двічі.

Винагороди без власної гри

У розділі Потоки подій:

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

Використовує власне значення джерела, якщо воно допустиме, інакше — конвертацію валют SSN.

• Один конкретний подарунок TikTok: порівнюють meta.giftId або meta.giftNameі обмежте потік подіями подарунків TikTok.
• Перевірки чисел у hasDonation теж перетворюються на USD. Це не перевірки початкових монет. Для правил монет використовуйте власні метадані платформи чи власний код.
• Кожна перевірка виконується для кожного повідомлення. Це не накопичувальний баланс і не лічильник серії. Використовуйте вузли стану якщо це потрібно, або зберігайте цю логіку в грі.

Перевірте перед підключенням платної дії

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

Докладніше про з'єднання: власні накладки.