Crie jogos e recompensas

Sim, seu jogo pode reagir a presentes do TikTok

Seu JavaScript escolhe a ação: impulsionar um foguete, cultivar um jardim, criar um inimigo ou preencher uma meta conjunta. Você também escolhe o limite. O SSN não pode mudar preços de presentes de uma plataforma.

Escolha um modelo

Cada prévia tem botões de exemplo e um inspetor “Últimos dados recebidos”. As amostras são eventos fictícios, não compras. O modo de prévia nunca entra na sessão ao vivo.

• No HTML, procure EDIT THIS RULE ou EDIT THESE RULES.
• Coloque a lógica do jogo na função receive(data) .
• Os auxiliares de conexão e contagem ficam em starter.js. Os estilos ficam em starter.css.

Conecte um modelo em 3 etapas

1. Inicie o SSN e conecte seu chat. Confira se chat e presentes aparecem no dock. Para TikTok, veja os modos de conexão.
2. Abra o modelo sem ?demo, usando seu ID de sessão (e senha, se definida).
3. Confira no navegador. Depois adicione o mesmo link ao OBS como fonte de navegador, por exemplo em 1000 × 800.

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

• &clean oculta o inspetor, o estado da conexão e os botões do host.
• Sem senha? Omita &password=….
• No site beta, mantenha /beta/ antes de games/.

Faça sua cópia e execute pelo disco

Não há servidor para instalar. Você edita um arquivo no computador e aponta o OBS para ele.

1. Baixe o ZIP do código beta e extraia.
2. Copie o modelo escolhido ao lado do original. Exemplo: games/templates/my-rocket.html.
3. Mantenha a estrutura de pastas. Os modelos carregam js/local-server-url.js, e a meta de apoio carrega currency.js da pasta raiz. Mantenha também imagens e áudio no lugar.
4. Arraste seu HTML para Chrome ou Edge e copie o endereço file:/// .
5. Adicione tudo a partir de ? em diante do link de jogo que funciona (sessão, senha e opções de transporte).
6. Em OBS, saia Arquivo local desmarcado. Cole o endereço completo no campo URL campo.
7. Após cada edição, atualize a fonte de navegador.

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

Use seu caminho real. Não mova a pasta extraída. A sessão é seu ID de conexão SSN, não o nome do jogo. Remova demo para entrada ao vivo. Mantenha SSN e captura ativos. Mais exemplos: guia de configuração de arquivo.

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.

Como escolher a quantidade de moedas de uma ação?

Primeiro decida o que vai medir. Depois escolha um número.

Exato, mínimo ou saldo acumulado?

• Exato: coins === 10. Um presente de 25 moedas não faz nada.
• Mínimo por evento: coins >= 10.
• Saldo acumulado: é o que o foguete usa. 25 moedas = dois impulsos, com 5 moedas sobrando.

Vários níveis? Verifique primeiro o maior para um presente não acionar todos os inferiores.

O que cada plataforma envia

type indica de onde veio. event indica o que aconteceu, quando presente. O que chega depende do modo de captura, das configurações e da plataforma. Reflete o código atual do SSN, não garante que todas as contas recebam todos os eventos.

Outras fontes podem informar gorjetas, presentes, assinaturas ou compras. Confira a referência de eventos antes de adicioná-los ao filtro isSupport . Uma venda ou inscrição presenteada não é automaticamente uma gorjeta. O YouTube envia a compra do presente e cada aviso de destinatário; contar ambos recompensa o mesmo presente duas vezes.

Use donoValue e currency.js corretamente

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

Não faça isto

• donoValue || convertToUSD(...) — descarta um zero intencional.
• Extrair números de chatmessage para detectar pagamentos.
• Exigir event === "donation" — Estrelas do Facebook e alguns Cheers não têm evento.

O modelo de meta de apoio seleciona primeiro os tipos de apoio e depois chama o conversor compartilhado.

Conte cada sequência de presentes uma vez

O TikTok pode informar uma sequência como totais acumulados: 1, 2, 3. São três presentes, não seis. Guarde o maior total visto na sequência e some só o aumento.

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

• O auxiliar identifica sequências pelos IDs TikTok de grupo, remetente e presente; depois por meta.tiktokGiftStreakId, depois por IDs de mensagem. Eles também bloqueiam entregas repetidas.
• Não espera por repeatEnd, porque a captura do navegador pode nunca enviar isso. Precisa de uma ação só quando a sequência terminar? Escreva uma regra separada usando os campos enviados pela sua conexão.
• Use uma única rota de captura. Uma segunda captura do mesmo canal pode usar IDs diferentes e contar duas vezes.

Recompensas sem jogo personalizado

Em Event Flow:

1. Adicione Comparar propriedade.
2. Defina como donoValue, maior ou igual, e seu valor em USD.
3. Conecte uma ação, como som, animação ou controle do OBS.

Usa o valor da fonte se válido e, caso contrário, a conversão monetária do SSN.

• Um presente específico do TikTok: compare meta.giftId ou meta.giftName, e limite o fluxo a eventos de presentes do TikTok.
• Verificações numéricas de hasDonation também são convertidas para USD. Não verificam moedas brutas. Use metadados nativos ou código personalizado para regras de moedas.
• Cada verificação roda por mensagem. Não é um saldo acumulado nem um contador de sequências. Use nós de estado se precisar disso ou mantenha essa lógica no jogo.

Teste antes de vincular uma ação paga

1. Botões de exemplo. Uma sequência 1 → 2 → 3 soma três presentes. A amostra com valor zero não adiciona USD. Um preço desconhecido não adiciona moedas exatas.
2. Fonte real. Veja os dados reais capturados. Confirme nome/ID do presente, valor, unidade, quantidade e evento. As amostras testam sua regra, não a captura ao vivo.
3. Cena do OBS. Teste eventos repetidos, reconexão e recarga. Não atualize nem desligue a fonte de navegador se precisar manter o progresso na memória.

Mais detalhes de conexão: sobreposições personalizadas.