Gewinnspiele, Tickets und Punktepreise

Kostenloses Gewinnspiel in 5 Schritten durchführen

Öffne im Popup Gewinnspieloptionen. Lass die ID auf default und das Stichwort auf !enter. Belasse Lospreis und Punktepreis bei 0.
Wähle ein Gewinnerkarte, Namensrolle, oder Community-Rad. Prüfe die Vorschau und kopiere den Link als Browserquelle.
Klicke auf Teilnahme öffnen. Zuschauer geben das Stichwort im Chat ein, um teilzunehmen.
Klicke auf Teilnahme schließen, dann Gewinner ziehen. (Die Ziehung schließt Einträge automatisch, falls du es vergisst.)
Klicke auf Neue Runde für eine weitere Ziehung. Frühere Gewinner bleiben im Verlauf.

Lass Social Stream Ninja laufen. Es führt die Ziehung aus. In der OBS-Quelle musst du nie klicken.

Das alte eigenständige Community-Rad funktioniert weiterhin, wenn du &managed aus dem Link weglässt. Punkte und Fernsteuerung benötigen den verwalteten Link.

Lose für SSN-Punkte verkaufen

Aktiviere die Treuepunktesystem im Popup. (Dies sind SSN-Punkte, keine Twitch-Kanalpunkte.)
Öffne in den Gewinnspieloptionen Tickets und Punktepreise. Setze Punkte pro Los und Maximale Anzahl Lose pro Zuschauer.
Klicke auf Teilnahme öffnen. Bei einem Gewinnspiel namens fridaykauft ein Zuschauer 5 Lose mit !ticket friday 5.
Sieh dir Teilnehmer an unter Gewinnspiele und Verlauf verwalten.

Wenn dies passiert …	Die Punkte …
Ein Zuschauer kauft Lose	Werden reserviert und sind anderweitig nicht ausgebbar.
Der Zuschauer hat nicht genügend	Werden nicht abgebucht. Keine Lose.
Du ziehst einen Gewinner	Werden ausgegeben.
Du klickst auf Abbrechen und erstatten	Gehen an alle zurück.
Du entfernst einen Zuschauer vor der Ziehung	Gehen an diesen Zuschauer zurück.

Die Regeln werden nach dem ersten Eintrag gesperrt. Zum Ändern abbrechen und erstatten, dann eine neue Runde starten. „Neue Runde“ verwirft keine bezahlte Runde. Schließen und Wiederöffnen pausiert sie nur.

Punkte verschenken

Lege vor dem Öffnen der Einträge Folgendes fest: Punktepreis pro Gewinner und Anzahl der Preise.
Öffne Einträge wie gewohnt.
Ziehe jeweils einen Gewinner. Jedem Gewinner wird der Preis zum Punkteguthaben addiert.

Preispunkte sind neue Punkte, nicht Erlöse aus Losverkäufen. Die maximale Auszahlung ist Preis × Anzahl der Preise.

Eine abgeschlossene Ziehung lässt sich nicht rückgängig machen. Korrigiere Fehler, indem du die Punkte des Zuschauers manuell anpasst. Erneutes Verbinden der Anzeige zahlt nie doppelt aus.

Spiele mit Punktebelohnungen

Number Hunt

Setze den Typ auf Number Hunt (vom Host gesteuert), Punkte pro Los 0, und Anzahl der Preise 1. Füge bei Bedarf einen Punktepreis hinzu.
Social Stream wählt eine geheime Zahl von 1 bis 100.
Spieler raten mit !guess friday 50 (verwende deine Gewinnspiel-ID).

Falsche Antworten verengen den Bereich für alle. Die erste richtige Antwort gewinnt. Pro Zuschauer ein Versuch alle 5 Sekunden.

Zeige es mit der Gewinnspielanzeige oder games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Die normalen Spiele vergeben keine SSN-Punkte.

Coin Flip Pot

Setze den Typ auf Coin Flip Pot, Punkte pro Los 1, Anzahl der Preise 1, und Punktepreis pro Gewinner 0.
Zuschauer setzen mit !ticket friday 3 heads oder !ticket friday 3 tails.
Einträge schließen und ziehen. Die Chance ist unabhängig vom Einsatz 50:50.

Gewinner erhalten ihren Einsatz plus einen nach Einsatzhöhe berechneten Anteil der Verlierereinsätze. Keine Gebühr, keine neuen Punkte. Beispiel: Gewinner setzen 2 und 1, Verlierer 5; der Pot von 8 zahlt 5 und 3 aus.

Beide Seiten brauchen einen Spieler, sonst wird die Ziehung abgelehnt. Brich vor der Ziehung ab, um allen Punkte zu erstatten.

Wie übrige Einzelpunkte verteilt werden

Übrige Punkte gehen zuerst an die größten Bruchteilsreste. Bei Gleichstand zählt der frühere Eintritt.

Mehrere Gewinnspiele gleichzeitig durchführen

Gib jedem eine kurze Gewinnspiel-ID (Buchstaben, Zahlen, -, _) und füge &giveaway=ID zu seinem OBS-Link hinzu.
Los- und Ratebefehle nennen das Gewinnspiel, etwa !ticket friday 5.
Gib jedem kostenlosen Gewinnspiel ein eigenes Stichwort. Ein gemeinsames Stichwort trägt nicht in beide ein.
Alle Lose werden aus demselben Punkteguthaben des Zuschauers bezahlt.

Das Popup richtet neue Runden ein. Die tatsächlichen Regeln einer laufenden Runde stehen im Manager. Änderungen am OBS-Link betreffen nur das Aussehen.

Die OBS-Anzeige

Verwende einen 1280 × 720 Browserquelle. Der Hintergrund ist durchsichtig, außer du wählst Designhintergrund.
Das Rad zeigt bis zu 120 Namen, zieht den Gewinner aber aus allen Losen.
Nach erneutem Verbinden erscheint das gespeicherte Ergebnis. Bei reduzierter Bewegung wird die Animation übersprungen.
Social Stream erkennt nicht, ob die OBS-Szene live ist.

Halte Folgendes privat: Steuerungslinks, Sitzungs-IDs und Backupdateien.

Event Flow

Füge Gewinnspiel / Tickets Aktion (unter den Punkteaktionen).
Wähle die Aktion: Kostenlos teilnehmen, Lose kaufen, kostenlose Lose vergeben, Einträge schließen, Gewinner ziehen, abbrechen und erstatten oder Status abfragen.
Wähle Gewinnspiel-ID und Losanzahl. Wähle bei einem Pot Kopf oder Zahl.

„Buy tickets“ gibt die Punkte bereits aus. Setze keine Punkte-ausgeben-Aktion davor.

Es handelt für den Absender der Nachricht. Setze vor Vergaben und Host-Steuerung einen vertrauenswürdigen Auslöser oder Filter.

Mehr Details zu Event Flow

Bei einem Fehler stoppen abhängige Aktionen. Die Chatnachricht bleibt sichtbar.
Das Ergebnis steht in meta.giveawayControlResult.
Das Testpanel simuliert es nur. Nutze für echte Tests einen separaten Host oder ein separates Profil.
Das Guthaben wird bei der Ausführung geprüft. Die Eintrittsnachricht kann daher ihren eigenen letzten Punkt nicht verdienen.
Der Wiederholungsschutz ist bei Quellen mit eigenen Nachrichten-IDs am stärksten.
Geplante Ereignisse ohne Zuschauer können keine Lose kaufen.

Stream Deck und API

Das Stream-Deck-Plugin bietet: Gewinnspiel öffnen, Gewinnspiel schließen, Gewinnspiel auslosen, Abbrechen und erstatten, Neue Gewinnspielrunde, und Gewinnspielstatus.

Sie verwenden die default Gewinnspiel. Für ein anderes gib {"giveawayId":"friday"} ins Wertefeld ein. Gewinnspiel öffnen akzeptiert außerdem ein config Objekt stehen.
Eine Taste bestätigt die Antwort von Social Stream, nicht die Anzeige in OBS. Prüfe bei Zeitüberschreitung den Zustand vor einer erneuten Ziehung.

Lose über die API kaufen

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

operationId benennt den Kauf; get benennt die Antwort.
Behalte bei Wiederholungsversuchen dieselbe Vorgangs-ID. Verwende für einen neuen Kauf eine neue ID.

Host-API-Zugriff kann die Punkte beliebiger Zuschauer ausgeben. Stelle ihn niemals als öffentliches Formular bereit.

Verlauf und Backups

Gewinnspiele und Verlauf verwalten zeigt Runden, Einträge und Gewinner. Du kannst Gewinnerverlauf exportieren (JSON) oder speichere ein vollständiges Punkte- und Gewinnspielbackup. Nichts wird hochgeladen.

Nach einem Neustart kehren offene Runden geschlossen zurück, mit weiterhin reservierten Losen. Öffne sie erneut, ziehe oder brich mit Erstattung ab.

Backup wiederherstellen

Funktioniert nur bei einem neuen Host ohne Punkte oder Gewinnspiele.

Lass den alten Host ausgeschaltet. Öffne SSN in einem neuen Browserprofil und den Gewinnspielmanager.
Unter Auf einem neuen Host wiederherstellenwähle dein vollständiges Backup. Warte auf die Meldung und notiere die darin genannte Sitzungs-ID.
Im Popup unter Sitzungsoptionengib diese Sitzungs-ID ein.
Wähle zurück im Manager die Gewinnspiel-ID und klicke auf Aktualisieren. Prüfe Regeln, Einträge und Gewinner. Runden werden geschlossen wiederhergestellt.
Wieder öffnen, ziehen oder Abbrechen und erstatten. Speichere danach ein neues Backup.

Betreibe niemals den alten und den wiederhergestellten Host gleichzeitig. Ein Backup enthält keine späteren Änderungen und keine Popup-Einstellungen.

Mehr zum Speicherort der Daten

Punkte bleiben in diesem Browser- oder App-Profil und werden nicht anderweitig synchronisiert. Runden werden pro Sitzung gespeichert.
Das Löschen von Browserdaten kann sie entfernen. Bewahre Backups außerhalb dieses Profils auf.
Reine Guthabenimporte stellen reservierte Lose nicht wieder her. Das Zurücksetzen der Punkte ist bei reservierten Losen blockiert und löscht keinen Gewinnspielverlauf.
Unbestätigte Aufkleberkäufe werden nach einem Zeitlimit freigegeben.
Kein Cloud-Backup und keine Auszahlung in Geld. Ein Serverbackup könnte später kommen.

Probleme beheben

Problem	Versuche Folgendes
Ein Zuschauer kann nicht teilnehmen	Prüfe ID, Stichwort, Mitgliederbeschränkung, geöffnete Einträge und Plattform-Erfassung. Bot-, private, alte, erneut zugestellte und Testnachrichten zählen nie.
Das Konto eines Zuschauers wirkt falsch	Eine Namensänderung kann Guthaben durcheinanderbringen. Prüfe es auf dem Host. Plattformen werden nie zusammengeführt.
Schaltflächen reagieren nicht	Prüfe, ob der richtige SSN-Host mit aktivierter Host-Steuerung läuft. Aktualisiere vor einem erneuten Versuch.
Punkte lassen sich nicht zurücksetzen oder importieren	Schließe reservierte Loskäufe zuerst ab oder storniere sie. Nutze bei einem Backup mit reservierten Losen die vollständige Wiederherstellung.
`!spend` meldet „Unbekannte Belohnung“	Es benötigt eine eingerichtete Belohnung mit Preis.