Sorteios, bilhetes e prêmios em pontos

Está começando a usar a ferramenta de sorteios? Comece por Seu primeiro sorteio: passo a passo com capturas de tela.

Use um único host para executar o sorteio. O popup, Stream Deck e Event Flow controlam esse host; as exibições do público mostram seu resultado confirmado.

Faça seu primeiro sorteio gratuito

1. No popup, abra Opções de sorteio. Deixe o ID como default, palavra-chave como !enter, e preço do bilhete e prêmio em pontos em zero.
2. Escolha cartão do ganhador, roleta de nomes ou roleta da comunidade. Visualize a exibição e copie o link para uma fonte de navegador do OBS.
3. Selecione Abrir participações. Os espectadores participam enviando a palavra-chave em um chat capturado.
4. Selecione Fechar participações, depois Sortear ganhador. Sortear também fecha as participações se você esquecer de fechá-las antes.
5. Selecione Nova rodada para iniciar outro sorteio. Ganhadores anteriores permanecem no histórico do host.

Mantenha o host do SSN em execução. Não é necessário interagir com a fonte de navegador do OBS. A roleta independente da comunidade continua disponível sem &managed; pontos e controles remotos usam o modo gerenciado.

Bilhetes pagos com pontos do SSN

1. Ative o recurso existente Sistema de pontos de fidelidade no popup. São pontos do SSN, separados dos pontos do canal da Twitch e das pontuações individuais dos jogos.
2. Em Bilhetes e prêmios em pontos, defina os pontos por bilhete e um número máximo de bilhetes por espectador. Preço 1 significa um bilhete por ponto.
3. Abra as participações. Para um sorteio chamado friday, um espectador compra cinco bilhetes com !ticket friday 5.
4. Verifique os participantes em Gerenciar sorteios e histórico. Uma compra bem-sucedida cobra e inscreve o espectador ao mesmo tempo. Saldo insuficiente não cria bilhetes.

Compras de bilhetes reservam pontos imediatamente, para que os mesmos pontos não possam comprar adesivos nem entrar em outro sorteio pago. Sortear consome esses pontos. Cancelar e reembolsar devolve os pontos reservados. Remover um participante antes do sorteio devolve a reserva dele. Rodadas pagas não podem ser descartadas silenciosamente com Nova rodada.

As regras são bloqueadas após a primeira participação. Fechar/abrir pode pausar uma rodada com as regras existentes. Para alterar preço ou elegibilidade, cancele e crie outra rodada. Um espectador não pode trocar de carteira nem de lado do pote após entrar.

Distribuir pontos

Defina Prêmio em pontos por ganhador e Número de prêmios antes de abrir. Cada prêmio adiciona essa quantidade de pontos do SSN à conta existente do espectador selecionado. Isso cria pontos; não usa a receita dos bilhetes nem uma carteira do operador. A emissão total é limitada pelo valor de prêmio e número de ganhadores configurados.

Para vários prêmios, sorteie um de cada vez. Cada ganhador confirmado é registrado antes de a exibição animar. Um sorteio concluído não pode ser cancelado para desfazer um resultado conhecido. Corrija erros por meio de um ajuste deliberado de pontos pelo host; alterar a exibição ou reconectar nunca concede o prêmio novamente.

Jogos com recompensas em pontos

Caça ao número gerenciada

Escolha Caça ao número (controlada pelo host), custo do bilhete 0, um prêmio e um prêmio em pontos opcional. O host seleciona um número de 1 a 100. Os jogadores usam !guess friday 50, substituindo o ID do sorteio. Palpites corretos premiam uma única vez o primeiro participante elegível a acertar; palpites errados reduzem o intervalo para todos. Cada espectador pode dar um palpite a cada cinco segundos.

Use a exibição gerenciada do sorteio ou games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. O Number Hunt normal e outros jogos existentes mantêm seu comportamento local original. Suas pontuações locais e rótulos de ganhadores não concedem pontos do SSN automaticamente.

Pote de cara ou coroa

Este é um jogo de sorte. Escolha Pote de cara ou coroa, preço 1, um resultado e prêmio extra 0. Os espectadores apostam com !ticket friday 3 heads ou !ticket friday 3 tails. Os dois lados precisam de um participante. Feche as participações e sorteie: o host escolhe cara ou coroa com a mesma probabilidade, independentemente dos totais apostados.

Os espectadores vencedores recuperam sua aposta e dividem as apostas perdedoras proporcionalmente ao valor apostado. As sobras de pontos inteiros vão para as maiores partes fracionárias; a ordem de entrada desempata. Nenhuma taxa é cobrada e nenhum ponto extra é criado. Para apostas vencedoras de 2 e 1 contra 5 pontos perdedores, o pote de 8 pontos paga 5 e 3. Cancele antes de sortear para reembolsar todos. Se um lado estiver vazio, o sorteio é rejeitado e você pode cancelar/reembolsar.

Vários sorteios

Dê a cada sorteio um ID curto com letras, números, hífens ou sublinhados. As compras de um espectador em todos os IDs compartilham o mesmo saldo disponível da carteira. Cada URL do OBS inclui &giveaway=ID. Os comandos de bilhete e palpite identificam o sorteio explicitamente. Use palavras-chave diferentes em sorteios gratuitos simultâneos: uma palavra-chave gratuita ambígua não inscreve em vários sorteios por acidente.

Os campos do popup são valores de configuração. Atualize ou abra o gerenciador para inspecionar as regras confirmadas no host. Alterar um link do público muda apenas as configurações de exibição; não reescreve as regras de bilhetes de uma rodada em andamento.

OBS e apresentação

O fundo gerenciado padrão é transparente. Se quiser, selecione um painel temático. Cartão, roleta de nomes e roleta da comunidade compartilham o mesmo resultado e seis estilos de cor. Preferências de movimento reduzido pulam as animações de revelação. A roleta mostra no máximo 120 nomes; é uma animação de revelação, não uma representação completa das chances de cada bilhete. A seleção usa todo o conjunto de bilhetes elegíveis.

Ao reconectar, a exibição mostra o resultado salvo. Uma exibição conectada não informa ao SSN se aquela cena do OBS está visível no momento. Mantenha URLs de controle, IDs de sessão e arquivos de backup privados.

Event Flow

Adicione Sorteio / Bilhetes nas ações de pontos. Selecione Entrar em sorteio gratuito, Comprar bilhetes, Conceder bilhetes gratuitos, Fechar participações, Sortear ganhador, Cancelar e reembolsar ou Consultar estado. Selecione o ID e a quantidade de bilhetes; escolha cara/coroa para uma compra no pote. A ação usa a identidade capturada do espectador. Use um gatilho/filtro confiável antes de concessões ou controles de operador.

Comprar bilhetes já gasta os pontos. Não coloque Gastar pontos antes dela. Uma falha interrompe ações dependentes sem ocultar o chat original. O resultado fica disponível em meta.giveawayControlResult. O painel de teste do Event Flow simula essa ação sem comprar bilhetes reais. Use um host/perfil isolado para testes completos que envolvam alterações reais de rodada.

A elegibilidade da compra usa o saldo confirmado quando a ação é executada. Não dependa de a própria mensagem de entrada gerar o último ponto necessário. IDs nativos de mensagens da fonte oferecem proteção persistente contra repetição; fontes sem esses IDs têm garantias mais fracas de identidade entre reinicializações. Eventos agendados genéricos sem identidade de espectador/mensagem capturada não podem comprar em nome de alguém.

Stream Deck e API

O plugin nativo inclui Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round e Giveaway State. O ID padrão deles é default. Coloque {"giveawayId":"friday"} no campo de valor para selecionar outra rodada. Abrir também pode aceitar um config objeto; caso contrário, uma rodada existente mantém suas regras confirmadas e um novo ID usa os padrões do popup.

Use a conexão P2P existente ou o transporte WebSocket configurado. A tecla informa uma resposta do SSN; não afirma que o OBS esteja ao vivo. Se uma resposta exceder o tempo limite, consulte o estado antes de tentar um novo sorteio.

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

Um ID de operação identifica uma operação de negócio; o ID de callback identifica uma resposta. Mantenha o ID da operação nas novas tentativas. Reutilizá-lo com parâmetros diferentes falha. Use um novo ID de operação para uma nova compra intencional. O acesso de operador à API pode gastar em nome do ator informado: não o exponha como formulário público de compra sem autenticação.

Histórico, backups e recuperação

O gerenciador lista rodadas, participantes e histórico de ganhadores. Exporte o histórico de ganhadores como JSON ou salve um backup completo versão 2 de pontos/sorteios. Backups completos contêm saldos, reservas, rodadas e recibos de operação juntos. Nada é enviado a um servidor.

Ao reiniciar o host, rodadas abertas salvas ficam fechadas para revisão. Seus bilhetes permanecem reservados. Reabra com as mesmas regras, sorteie ou cancele/reembolse. Transações interrompidas do banco de dados são confirmadas integralmente ou não deixam compra/pagamento parcial. Reservas de adesivos sem confirmação de entrega registrada são recuperadas após o tempo limite.

A recuperação completa está disponível em um host novo sem saldos nem registros de sorteios existentes. Restaura o snapshot inteiro e mantém as rodadas restauradas fechadas. Recusa-se a sobrescrever um host com dados. Restaure o ID original de transmissão/sessão no popup antes de retomar as rodadas; o resultado da recuperação lista as sessões do backup. Este backup não substitui as configurações gerais do popup. Nunca execute o host antigo e o recuperado como autoridades independentes da mesma economia. Um backup é um retrato do momento: não inclui transações ocorridas depois de ser salvo.

Importações apenas de saldo não restauram reservas pendentes. Redefinições de pontos e substituições manuais são rejeitadas quando os fundos afetados estão reservados. Redefinir pontos não apaga recibos/histórico de sorteios. Os saldos pertencem a este perfil de navegador/aplicativo, enquanto as rodadas são vinculadas à sessão. Perfis/dispositivos separados não são sincronizados automaticamente. Limpar os dados do navegador pode remover registros locais, então mantenha backups fora desse perfil.

Backup/sincronização opcional no servidor é um recurso futuro, fora desta versão. Esta implementação não adiciona uploads, credenciais de servidor, moeda comprada nem saque.

Quando algo não funcionar

• Sem participação: verifique o ID/palavra-chave, a restrição a membros, o estado aberto e a plataforma capturada. Entradas de bots, privadas, históricas, repetidas e marcadas como teste são excluídas.
• Conta alterada: uma alteração de nome/identidade pode tornar uma carteira ambígua. Revise no host; contas nunca são mescladas silenciosamente entre plataformas.
• Sem resposta: verifique se o host SSN pretendido está em execução e se os controles de host estão ativados. Atualize o estado confirmado antes de tentar novamente.
• Não é possível redefinir/importar: primeiro conclua ou cancele compras reservadas. Use recuperação completa para um backup que contenha obrigações.
• Recompensa desconhecida: !spend exige uma recompensa configurada e um preço correspondentes; não consome mais pontos para um nome de recompensa arbitrário.

Referência da API · Contratos de eventos · Enquetes e listas de espera

Recuperar um backup passo a passo

1. Mantenha o host antigo parado. Abra o SSN em um perfil novo do navegador e abra o gerenciador de sorteios.
2. Em Recuperar em um host novo, escolha seu backup completo. Aguarde a mensagem de recuperação e anote o ID de sessão original que ela lista.
3. Na seção do popup Opções de sessão, insira esse ID de sessão original.
4. Volte ao gerenciador, escolha o ID do sorteio e selecione Atualizar. Verifique as regras, participantes e histórico de ganhadores. Rodadas abertas recuperadas ficam fechadas para revisão.
5. Reabra com as mesmas regras, sorteie ou selecione Cancelar e reembolsar para devolver bilhetes reservados. Salve um novo backup após revisar o resultado.

No OBS, comece com uma fonte de navegador de 1280 × 720. A roleta gerenciada se ajusta à altura restante da fonte. O fundo padrão é transparente sem CSS personalizado; todos os controles rotineiros ficam no popup, gerenciador ou Stream Deck.