Twórz gry i nagrody

Tak, gra może reagować na prezenty TikToka

Twój JavaScript wybiera działanie: przyspieszenie rakiety, wzrost ogrodu, pojawienie się wroga lub wspólny cel. Ty wybierasz też próg. SSN nie może zmienić cen prezentów platformy.

Wybierz szablon

Każdy podgląd ma przyciski próbek i inspektor „Ostatnio odebrane dane”. Próbki to sztuczne zdarzenia, nie zakupy. Tryb podglądu nigdy nie dołącza do sesji na żywo.

• W HTML wyszukaj EDIT THIS RULE lub EDIT THESE RULES.
• Umieść logikę gry w receive(data) funkcji.
• Funkcje pomocnicze połączenia i zliczania są w starter.js. Style są w starter.css.

Podłącz szablon w 3 krokach

1. Uruchom SSN i podłącz czat. Sprawdź, czy czat i prezenty pojawiają się w Docku. Dla TikTok zobacz tryby połączenia.
2. Otwórz szablon bez ?demoużywając ID sesji (i hasła, jeśli je ustawiono).
3. Sprawdź w przeglądarce. Potem dodaj ten sam link do OBS jako źródło przeglądarkowe, np. 1000 × 800.

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

• &clean ukrywa inspektor, stan połączenia i przyciski prowadzącego.
• Bez hasła? Pomiń &password=….
• Na stronie beta zachowaj /beta/ przed games/.

Zrób własną kopię i uruchom z dysku

Nie instalujesz serwera. Edytujesz plik na komputerze i wskazujesz go w OBS.

1. Pobierz źródła beta w ZIP i rozpakuj.
2. Skopiuj wybrany szablon obok oryginału. Przykład: games/templates/my-rocket.html.
3. Zachowaj strukturę folderów. Szablony ładują js/local-server-url.js, a cel wsparcia wczytuje currency.js z folderu głównego. Zachowaj też obrazy i dźwięki na miejscu.
4. Przeciągnij plik HTML do Chrome lub Edge i skopiuj file:/// adres.
5. Dodaj wszystko od ? i dalej z działającego linku gry (sesja, hasło, opcje transportu).
6. W OBS wyjdź Plik lokalny odznaczone. Wklej pełny adres w źródle przeglądarkowym do pola URL .
7. Po każdej zmianie odśwież źródło przeglądarkowe.

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

Użyj rzeczywistej ścieżki. Nie przenoś rozpakowanego folderu. Sesja to identyfikator połączenia SSN, nie nazwa gry. Usuń demo dla danych na żywo. Pozostaw SSN i przechwytywanie uruchomione. Więcej przykładów: instrukcja konfiguracji plików.

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.

Jak wybrać liczbę monet dla akcji?

Najpierw zdecyduj, co mierzysz. Potem wybierz liczbę.

Dokładnie, minimum czy narastające saldo?

• Dokładnie: coins === 10. Prezent za 25 monet nic nie robi.
• Minimum na zdarzenie: coins >= 10.
• Narastające saldo: tego używa rakieta. 25 monet = dwa przyspieszenia i 5 monet reszty.

Kilka progów? Najpierw sprawdź najwyższy, aby jeden prezent nie uruchamiał wszystkich niższych.

Co wysyła każda platforma

type mówi, skąd pochodzi. event mówi, co się stało, jeśli występuje. Otrzymane dane zależą od trybu przechwytywania, ustawień i platformy. To odzwierciedla obecny kod SSN, nie obiecuje każdego zdarzenia na każdym koncie.

Inne źródła mogą zgłaszać napiwki, prezenty, wspieranie kanału lub zakupy. Sprawdź dokumentację zdarzeń przed dodaniem do filtra szablonu isSupport . Sprzedaż lub podarowana subskrypcja nie jest automatycznie napiwkiem. YouTube wysyła zakup prezentu i każde powiadomienie odbiorcy; liczenie obu nagradza ten sam prezent dwukrotnie.

Poprawnie używaj donoValue i 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>

Nie rób tego

• donoValue || convertToUSD(...) — odrzuca zamierzone zero.
• Wyciąganie liczb z chatmessage aby wykrywać płatności.
• Wymaganie event === "donation" — gwiazdki Facebook i niektóre Cheers nie mają zdarzenia.

Szablon celu wsparcia najpierw wybiera rodzaje wsparcia, potem wywołuje wspólny konwerter.

Licz serię prezentów tylko raz

TikTok może zgłaszać serię narastająco: 1, 2, 3. To trzy prezenty, nie sześć. Zapamiętaj najwyższą dotąd sumę serii i dodawaj tylko przyrost.

// 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');

• Funkcja pomocnicza dopasowuje serie według ID grupy/nadawcy/prezentu TikTok, potem meta.tiktokGiftStreakId, potem ID wiadomości. ID wiadomości blokują też ponowne dostarczenia.
• Nie czeka na repeatEnd, ponieważ przechwytywanie przeglądarkowe może nigdy tego nie wysłać. Chcesz jedną akcję dopiero po zakończeniu serii? Napisz osobną regułę z polami wysyłanymi przez Twoje połączenie.
• Używaj jednej drogi przechwytywania. Druga dla tego samego kanału może używać innych ID i liczyć podwójnie.

Nagrody bez własnej gry

W sekcji Event Flow:

1. Dodaj Porównaj właściwość.
2. Ustaw na donoValue, większe lub równei swoją kwotę w USD.
3. Podłącz działanie, np. dźwięk, animację lub sterowanie OBS.

Używa własnej wartości źródła, jeśli jest poprawna, a w przeciwnym razie przeliczenia walut SSN.

• Jeden konkretny prezent TikTok: porównują meta.giftId lub meta.giftNamei ogranicz przepływ do zdarzeń prezentów TikTok.
• Sprawdzenia liczb w hasDonation również stają się USD. Nie są sprawdzeniem surowych monet. Do reguł monet użyj metadanych platformy lub własnego kodu.
• Każde sprawdzenie działa osobno dla każdej wiadomości. To nie jest narastające saldo ani licznik serii. Użyj węzły stanu jeśli tego potrzebujesz, albo zachowaj tę logikę w grze.

Przetestuj przed podłączeniem płatnego działania

1. Przyciski próbek. Seria 1 → 2 → 3 dodaje trzy prezenty. Przykład z nadpisaniem zerem nie dodaje USD. Nieznana cena nie dodaje dokładnych monet.
2. Prawdziwe źródło. Obejrzyj prawdziwe przechwycone dane. Potwierdź nazwę/ID prezentu, kwotę, jednostkę, liczbę i zdarzenie. Przykłady testują regułę, nie przechwytywanie na żywo.
3. scena OBS. Sprawdź powtórzone zdarzenia, ponowne połączenie i przeładowanie. Nie odświeżaj ani nie wyłączaj źródła przeglądarkowego, jeśli musisz zachować postęp w pamięci.

Więcej o połączeniach: własne nakładki.