Giveaway, biglietti e premi in punti

Non conosci lo strumento Giveaway? Inizia da Il tuo primo giveaway: una guida con screenshot.

Usa un solo host per gestire l'estrazione. Il popup, Stream Deck ed Event Flow controllano quell'host; le visualizzazioni per il pubblico mostrano il suo risultato registrato.

Esegui il tuo primo giveaway gratuito

1. Nel popup, apri Opzioni giveaway. Lascia l'ID come default, parola chiave come !enter, e prezzo del biglietto e premio in punti a zero.
2. Scegli una scheda vincitore, un rullo dei nomi o una ruota della community. Visualizza l'anteprima, poi copia il link in una sorgente browser OBS.
3. Seleziona Apri partecipazioni. Gli spettatori partecipano inviando la parola chiave in una chat acquisita.
4. Seleziona Chiudi partecipazioni, poi Estrai vincitore. L'estrazione chiude anche le partecipazioni se hai dimenticato di chiuderle prima.
5. Seleziona Nuovo turno per avviare un'altra estrazione. I vincitori precedenti restano nella cronologia dell'host.

Mantieni l'host SSN in esecuzione. Non serve interagire con la sorgente browser OBS. La ruota autonoma della community rimane disponibile senza &managed; punti e controlli remoti usano la modalità gestita.

Biglietti pagati con punti SSN

1. Abilita l'esistente Sistema di punti fedeltà nel popup. Sono punti SSN, separati dai punti canale Twitch e dai punteggi dei singoli giochi.
2. Sotto Biglietti e premi in punti, imposta i punti per biglietto e un numero massimo di biglietti per spettatore. Un prezzo di 1 significa un biglietto per punto.
3. Apri le partecipazioni. Per un giveaway chiamato friday, uno spettatore acquista cinque biglietti con !ticket friday 5.
4. Controlla i partecipanti in Gestisci giveaway e cronologia. Un acquisto riuscito addebita i punti e iscrive lo spettatore insieme. Se i fondi sono insufficienti, non vengono creati biglietti.

Gli acquisti dei biglietti prenotano subito i punti, così gli stessi punti non possono anche acquistare sticker o partecipare a un'altra estrazione a pagamento. L'estrazione consuma quei punti. Annulla e rimborsa restituisce i punti prenotati. Rimuovere un partecipante prima di un'estrazione restituisce la sua prenotazione. I turni a pagamento non possono essere scartati silenziosamente con Nuovo turno.

Le regole si bloccano dopo la prima partecipazione. Chiudere/riaprire può mettere in pausa un turno mantenendo le regole esistenti. Per modificare prezzo o idoneità, annullalo e crea un altro turno. Uno spettatore non può cambiare portafoglio o lato del montepremi dopo la partecipazione.

Regala punti

Imposta Premio in punti per vincitore e Numero di premi prima dell'apertura. Ogni premio aggiunge quel numero di punti SSN all'account esistente dello spettatore selezionato. Questo crea punti; non li preleva dai ricavi dei biglietti o dal portafoglio dell'operatore. L'emissione totale è limitata dall'importo del premio e dal numero di vincitori configurati.

Per più premi, estrai un vincitore alla volta. Ogni vincitore confermato viene registrato prima dell'animazione. Un'estrazione completata non può essere annullata per eliminare un risultato noto. Correggi gli errori con una modifica deliberata dei punti da parte dell'host; cambiare una visualizzazione o riconnettersi non assegna mai di nuovo il premio.

Giochi con ricompense in punti

Number Hunt gestito

Scegli Number Hunt (controllato dall'host), costo del biglietto 0, un premio e un premio in punti facoltativo. L'host sceglie un numero da 1 a 100. I giocatori usano !guess friday 50, sostituendo l'ID del giveaway. Le risposte corrette premiano una sola volta il primo partecipante idoneo che indovina; quelle errate restringono l'intervallo per tutti. Ogni spettatore può provare una volta ogni cinque secondi.

Usa la visualizzazione gestita del giveaway, oppure games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Number Hunt ordinario e gli altri giochi esistenti mantengono il comportamento locale originale. I loro punteggi locali e le etichette dei vincitori non assegnano automaticamente punti SSN.

Montepremi testa o croce

È un gioco d'azzardo. Scegli Montepremi testa o croce, prezzo 1, un risultato e premio aggiuntivo 0. Gli spettatori puntano con !ticket friday 3 heads oppure !ticket friday 3 tails. Entrambi i lati devono avere un partecipante. Chiudi le partecipazioni ed estrai: l'host sceglie testa o croce con la stessa probabilità, indipendentemente dai totali puntati.

Gli spettatori vincitori recuperano la propria puntata e si dividono le puntate perdenti in proporzione alla loro puntata. I punti interi residui vanno alle quote frazionarie maggiori, poi l'ordine di partecipazione risolve le parità. Non viene trattenuta alcuna commissione e non vengono creati punti aggiuntivi. Con puntate vincenti di 2 e 1 contro 5 punti perdenti, il montepremi di 8 punti paga 5 e 3. Annulla prima dell'estrazione per rimborsare tutti. Se un lato è vuoto, l'estrazione viene rifiutata e puoi annullare/rimborsare.

Giveaway multipli

Assegna a ogni estrazione un ID breve con lettere, numeri, trattini o underscore. Gli acquisti di uno spettatore tra tutti gli ID condividono lo stesso saldo disponibile del portafoglio. Ogni URL OBS include &giveaway=ID. I comandi dei biglietti e dei tentativi indicano esplicitamente l'estrazione. Assegna parole chiave diverse alle estrazioni gratuite simultanee: una parola chiave gratuita ambigua non iscrive accidentalmente a più estrazioni.

I campi del popup sono valori di configurazione. Aggiorna o apri il gestore per esaminare le regole registrate sull'host. Modificare un link per il pubblico cambia solo le sue impostazioni di visualizzazione; non riscrive le regole dei biglietti di un turno in corso.

OBS e presentazione

Lo sfondo predefinito della modalità gestita è trasparente. Se vuoi, seleziona un pannello a tema. Scheda, rullo e ruota della community condividono lo stesso risultato e sei stili di colore. Le preferenze per il movimento ridotto saltano le animazioni di rivelazione. La ruota mostra al massimo 120 nomi in anteprima; è un'animazione di rivelazione, non una rappresentazione completa delle probabilità di ogni biglietto. La selezione usa tutti i biglietti idonei.

Alla riconnessione, la visualizzazione mostra il risultato salvato. Una visualizzazione connessa non indica a SSN se quella scena OBS sia attualmente visibile. Mantieni privati gli URL dei controller, gli ID sessione e i file di backup.

Event Flow

Aggiungi Giveaway / Biglietti dalle azioni dei punti. Seleziona Partecipa a giveaway gratuito, Acquista biglietti, Concedi biglietti gratuiti, Chiudi partecipazioni, Estrai vincitore, Annulla e rimborsa oppure Interroga stato. Seleziona l'ID e il numero di biglietti; scegli testa/croce per un acquisto nel montepremi. L'azione usa l'identità acquisita dello spettatore. Usa un trigger/filtro attendibile prima delle concessioni o dei controlli dell'operatore.

Acquista biglietti spende già i punti. Non inserire Spendi punti prima di questa azione. Un errore interrompe le azioni dipendenti senza nascondere la chat originale. Il risultato è disponibile in meta.giveawayControlResult. Il pannello di test Event Flow simula questa azione senza acquistare biglietti reali. Usa un host/profilo isolato per i test completi che comportano modifiche reali dei turni.

L'idoneità all'acquisto usa il saldo registrato al momento dell'azione. Non fare affidamento sul fatto che lo stesso messaggio di partecipazione faccia guadagnare l'ultimo punto necessario. Gli ID messaggio nativi della sorgente forniscono protezione persistente dalla ripetizione; le sorgenti che ne sono prive offrono garanzie di identità più deboli tra i riavvii. Gli eventi generici programmati senza ID spettatore/messaggio acquisito non possono acquistare per conto di qualcuno.

Stream Deck e API

Il plugin nativo include Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round e Giveaway State. Il loro ID predefinito è default. Inserisci {"giveawayId":"friday"} nel campo valore per selezionare un altro turno. Open può anche accettare un config oggetto; altrimenti un turno esistente mantiene le regole registrate e un nuovo ID usa i valori predefiniti del popup.

Usa la connessione P2P esistente o il trasporto WebSocket configurato. Il tasto segnala una risposta di SSN; non dichiara che OBS sia in diretta. Se una risposta scade, interroga lo stato prima di tentare una nuova estrazione.

{"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"}}}

Un ID operazione identifica un'operazione; l'ID callback identifica una risposta. Mantieni l'ID operazione nei nuovi tentativi. Riutilizzarlo con parametri diversi causa un errore. Usa un nuovo ID operazione per un nuovo acquisto intenzionale. L'accesso API dell'operatore può spendere per l'attore fornito: non esporlo come modulo d'acquisto pubblico senza autenticazione.

Cronologia, backup e recupero

Il gestore elenca turni, partecipanti e cronologia dei vincitori. Esporta la cronologia dei vincitori in JSON oppure salva un backup completo versione 2 di punti/giveaway. I backup completi contengono insieme saldi, prenotazioni, turni e ricevute delle operazioni. Nulla viene caricato su un server.

Al riavvio dell'host, i turni aperti salvati vengono chiusi per la revisione. I relativi biglietti restano prenotati. Riapri con le stesse regole, estrai oppure annulla/rimborsa. Le transazioni del database interrotte vengono completate interamente oppure non lasciano acquisti/pagamenti parziali. Le prenotazioni degli sticker senza conferma di consegna registrata vengono recuperate dopo la scadenza.

Il recupero completo è disponibile su un nuovo host senza saldi o registrazioni giveaway esistenti. Ripristina l'intera istantanea e mantiene chiusi i turni ripristinati. Rifiuta di sovrascrivere un host con dati esistenti. Ripristina l'ID originale della diretta/sessione nel popup prima di riprendere i relativi turni; il risultato del recupero elenca le sessioni del backup. Questo backup non sostituisce le impostazioni generali del popup. Non eseguire mai l'host precedente e quello recuperato come autorità indipendenti per la stessa economia. Un backup è un'istantanea: non può includere transazioni avvenute dopo il salvataggio.

Le importazioni dei soli saldi non possono ripristinare le prenotazioni in sospeso. L'azzeramento dei punti e la sovrascrittura manuale vengono rifiutati quando i fondi interessati sono prenotati. Azzerare i punti non cancella ricevute/cronologia dei giveaway. I saldi appartengono a questo profilo browser/app, mentre i turni sono limitati alla sessione. Profili/dispositivi separati non si sincronizzano automaticamente. Cancellare i dati del browser può rimuovere le registrazioni locali, quindi conserva i backup fuori da quel profilo.

Il backup/la sincronizzazione facoltativi sul server sono una funzionalità futura, non parte di questa versione. Questa implementazione non aggiunge caricamenti, credenziali server, valuta acquistata o prelievi in denaro.

Quando qualcosa non funziona

• Nessuna partecipazione: controlla ID/parola chiave, restrizione ai membri, stato aperto e piattaforma acquisita. Le partecipazioni bot, private, storiche, riprodotte e contrassegnate come test sono escluse.
• Account cambiato: un cambiamento di nome/identità può rendere ambiguo un portafoglio. Controllalo sull'host; gli account non vengono mai uniti silenziosamente tra piattaforme.
• Nessuna risposta: assicurati che l'host SSN desiderato sia in esecuzione e che i controlli dell'host siano abilitati. Aggiorna lo stato registrato prima di riprovare.
• Impossibile azzerare/importare: completa o annulla prima gli acquisti prenotati. Usa il recupero completo per un backup che contiene impegni in sospeso.
• Ricompensa sconosciuta: !spend richiede una ricompensa configurata e un prezzo corrispondenti; non consuma più punti per un nome arbitrario di ricompensa.

Riferimento API · Contratti degli eventi · Sondaggi e liste d'attesa

Recupera un backup passo dopo passo

1. Mantieni arrestato il vecchio host. Apri SSN in un nuovo profilo browser e apri il gestore dei giveaway.
2. Sotto Recupera su un nuovo host, scegli il backup completo. Attendi il messaggio di recupero e annota l'ID sessione originale indicato.
3. Nel campo del popup Opzioni sessione, inserisci quell'ID sessione originale.
4. Torna al gestore, scegli l'ID giveaway e seleziona Aggiorna. Controlla regole, partecipanti e cronologia dei vincitori. I turni aperti recuperati vengono chiusi per la revisione.
5. Riapri con le stesse regole, estrai oppure seleziona Annulla e rimborsa per restituire i biglietti prenotati. Salva un nuovo backup dopo aver controllato il risultato.

Per OBS, inizia con una sorgente browser da 1280 × 720. La ruota gestita si adatta all'altezza rimanente della sorgente. Lo sfondo predefinito è trasparente senza CSS personalizzato; tutti i controlli di routine restano nel popup, nel gestore o in Stream Deck.