Vytvářejte hry a odměny

Ano, hra může reagovat na dárky TikTok

Váš JavaScript vybírá akci: zrychlit raketu, pěstovat zahradu, vytvořit nepřítele nebo plnit společný cíl. Volíte také práh. SSN nemůže měnit ceny dárků platformy.

Vyberte šablonu

Každý náhled má ukázková tlačítka a inspektor „Last received payload“. Ukázky jsou falešné události, nikoli nákupy. Režim náhledu se nikdy nepřipojuje k živé relaci.

• V HTML vyhledejte EDIT THIS RULE nebo EDIT THESE RULES.
• Umístěte herní logiku do receive(data) funkce.
• Pomocné funkce připojení a počítání jsou v starter.js. Styly jsou v starter.css.

Připojte šablonu ve 3 krocích

1. Spusťte SSN a připojte chat. Ověřte, že chat i dárky přicházejí do Docku. Pro TikTok viz režimy připojení.
2. Otevřete šablonu bez ?demo, se svým ID relace a případně nastaveným heslem.
3. Ověřte jej v prohlížeči. Potom přidejte stejný odkaz do OBS jako zdroj prohlížeče, například 1000 × 800.

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

• &clean skryje inspektor, stav připojení a tlačítka hostitele.
• Nemáte heslo? Vynechte &password=….
• Na beta webu ponechte /beta/ před games/.

Vytvořte vlastní kopii a spusťte ji z disku

Žádný server k instalaci. Upravíte soubor na počítači a nasměrujete na něj OBS.

1. Stáhnout zdrojový ZIP beta verze a rozbalte jej.
2. Zkopírujte vybranou šablonu vedle originálu. Příklad: games/templates/my-rocket.html.
3. Zachovejte strukturu složek. Šablony načítají js/local-server-url.js, a cíl podpory načítá currency.js z hlavní složky. Ponechte na místě také obrázky a zvuk.
4. Přetáhněte soubor HTML do Chromu nebo Edge a zkopírujte file:/// adresu.
5. Přidejte vše od ? dále ze svého funkčního herního odkazu (relace, heslo, možnosti přenosu).
6. V OBS odejděte Místní soubor vypnuté. Vložte celou adresu do pole zdroje prohlížeče URL pole.
7. Po každé úpravě obnovte zdroj prohlížeče.

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

Použijte skutečnou cestu. Nepřesouvejte rozbalenou složku. Relace je ID připojení SSN, nikoli název hry. Odstraňte demo pro živý vstup. Nechte SSN i zachytávání běžet. Další příklady: průvodce nastavením souboru.

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 vybrat počet mincí pro akci?

Nejprve rozhodněte, co měříte. Pak vyberte číslo.

Přesná hodnota, minimum, nebo průběžný zůstatek?

• Přesná hodnota: coins === 10. Dárek za 25 mincí neudělá nic.
• Minimum na událost: coins >= 10.
• Průběžný zůstatek: který používá raketa. 25 mincí = dvě zrychlení a zbytek 5 mincí.

Máte více úrovní? Nejprve kontrolujte nejvyšší, aby jeden dárek nespustil všechny nižší.

Co posílají jednotlivé platformy

type říká, odkud data pocházejí. event říká, co se stalo, pokud je přítomné. Příchozí data závisí na režimu zachytávání, nastavení a platformě. Popisuje současný kód SSN, nikoli záruku, že každý účet dostane všechny události.

Jiné zdroje mohou hlásit příspěvky, dárky, členství nebo nákupy. Zkontrolujte přehled událostí než je přidáte do filtru šablony isSupport filtr. Prodej nebo darované předplatné není automaticky příspěvek. YouTube posílá nákup dárku i oznámení každému příjemci; počítáním obou odměníte stejný dárek dvakrát.

Používejte donoValue a currency.js správně

<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>

Tohle nedělejte

• donoValue || convertToUSD(...) — zahodí záměrnou nulu.
• Získávání čísel z chatmessage pro rozpoznání plateb.
• Vyžadování event === "donation" — Facebook Stars a některé Cheers nemají událost.

Šablona cíle podpory nejprve vybere typy podpory a pak zavolá sdílený převodník.

Sérii dárků započítejte jen jednou

TikTok může sérii hlásit jako průběžné součty: 1, 2, 3. To jsou tři dárky, nikoli šest. Pamatujte si nejvyšší součet dané série a přičítejte jen nárůst.

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

• Pomocná funkce páruje série podle ID skupiny, odesílatele a dárku TikTok, potom podle meta.tiktokGiftStreakId, pak ID zpráv. ID zpráv také brání opakovanému doručení.
• Nečeká na repeatEnd, protože zachytávání v prohlížeči jej nemusí nikdy poslat. Potřebujete jednu akci až po konci série? Napište samostatné pravidlo s poli, která vaše připojení skutečně posílá.
• Používejte jedinou cestu zachytávání. Druhé zachytávání stejného kanálu může používat jiná ID a počítat dvakrát.

Odměny bez vlastní hry

V části Event Flow:

1. Přidejte Porovnat vlastnost.
2. Nastavte na donoValue, větší nebo rovno, a částku v USD.
3. Připojte akci, například zvuk, animaci nebo ovládání OBS.

Použije vlastní hodnotu zdroje, pokud je platná; jinak převod měn SSN.

• Jeden konkrétní dárek TikTok: porovnejte meta.giftId nebo meta.giftName, a omezte tok na události dárků TikTok.
• Číselné kontroly v hasDonation se také převádějí na USD. Nejde o přímé kontroly mincí. Pro pravidla mincí používejte původní metadata nebo vlastní kód.
• Každá kontrola se provádí pro jednu zprávu. Nejde o průběžný zůstatek ani počítadlo série. Použijte stavové uzly pokud to potřebujete, nebo ponechte tuto logiku ve hře.

Otestujte před připojením placené akce

1. Ukázková tlačítka. Série 1 → 2 → 3 přidá tři dárky. Ukázka s přepsáním hodnoty na nulu nepřidá žádné USD. Neznámá cena nepřidá přesný počet mincí.
2. Skutečný zdroj. Prohlédněte skutečně zachycená data. Ověřte název/ID dárku, částku, jednotku, počet a událost. Ukázky testují pravidlo, nikoli živé zachytávání.
3. scénu OBS. Ověřte opakované události, obnovení spojení a nové načtení. Pokud potřebujete zachovat průběh v paměti, zdroj prohlížeče neobnovujte ani nevypínejte.

Další podrobnosti připojení: vlastní překryvy.