Gewinnspiele, Tickets und Punktepreise

Neu beim Gewinnspiel-Werkzeug? Beginne mit Dein erstes Gewinnspiel: Anleitung mit Screenshots.

Verwende einen Host zur Durchführung der Auslosung. Popup, Stream Deck und Event Flow steuern diesen Host; Zuschaueranzeigen zeigen sein verbindlich gespeichertes Ergebnis.

Dein erstes kostenloses Gewinnspiel durchführen

1. Öffne im Popup Gewinnspieloptionen. Lass die ID auf default, Schlüsselwort auf !enter, und Ticketpreis sowie Punktepreis auf null.
2. Wähle Gewinnerkarte, Namensrolle oder Community-Rad. Sieh dir die Vorschau an und kopiere den Link dann in eine OBS-Browserquelle.
3. Auswählen Teilnahme öffnen. Zuschauer nehmen teil, indem sie das Schlüsselwort in einem erfassten Chat senden.
4. Auswählen Teilnahme schließen, dann Gewinner ziehen. Die Auslosung schließt die Teilnahme auch, wenn du das vorher vergessen hast.
5. Auswählen Neue Runde um eine weitere Auslosung zu starten. Frühere Gewinner bleiben im Host-Verlauf.

Lass den SSN-Host laufen. Die Interaktion mit der OBS-Browserquelle ist nicht erforderlich. Das eigenständige Community-Rad bleibt verfügbar ohne &managed; Punkte und Fernsteuerung verwenden den verwalteten Modus.

Mit SSN-Punkten bezahlte Tickets

1. Aktiviere die vorhandene Treuepunktesystem im Popup. Dies sind SSN-Punkte, getrennt von Twitch-Kanalpunkten und einzelnen Spielständen.
2. Unter Tickets und Punktepreise, lege die Punkte pro Ticket und die maximale Ticketanzahl pro Zuschauer fest. Ein Preis von 1 bedeutet ein Ticket pro Punkt.
3. Öffne die Teilnahme. Für ein Gewinnspiel namens friday, kauft ein Zuschauer fünf Tickets mit !ticket friday 5.
4. Prüfe Teilnehmer unter Gewinnspiele und Verlauf verwalten. Ein erfolgreicher Kauf belastet das Konto und meldet den Zuschauer gleichzeitig an. Bei unzureichendem Guthaben entstehen keine Tickets.

Ticketkäufe reservieren Punkte sofort. Dieselben Punkte können daher nicht zusätzlich Sticker kaufen oder an einer weiteren bezahlten Auslosung teilnehmen. Die Auslosung verbraucht diese Punkte. Abbrechen und erstatten gibt reservierte Punkte zurück. Das Entfernen eines einzelnen Teilnehmers vor einer Auslosung gibt dessen Reservierung zurück. Bezahlte Runden lassen sich nicht stillschweigend mit „New round“ verwerfen.

Regeln werden nach der ersten Teilnahme gesperrt. Schließen/Öffnen kann eine Runde mit bestehenden Regeln pausieren. Um Preis oder Berechtigung zu ändern, brich sie ab und erstelle eine neue Runde. Nach der Teilnahme kann ein Zuschauer weder das Punktekonto noch die gewählte Pot-Seite ändern.

Punkte verschenken

Setze Punktepreis pro Gewinner und Anzahl der Preise vor dem Öffnen. Jeder Preis fügt dem bestehenden Konto des gewählten Zuschauers diese Anzahl SSN-Punkte hinzu. Dabei werden Punkte erzeugt; sie stammen weder aus Ticketeinnahmen noch aus einem Betreiberkonto. Die Gesamtausgabe ist durch eingestellte Preishöhe und Gewinneranzahl begrenzt.

Lose mehrere Preise nacheinander aus. Jeder bestätigte Gewinner wird aufgezeichnet, bevor die Anzeige animiert. Eine abgeschlossene Auslosung lässt sich nicht abbrechen, um ein bekanntes Ergebnis rückgängig zu machen. Korrigiere Fehler durch eine bewusste Punkteanpassung auf dem Host; eine geänderte Anzeige oder erneute Verbindung vergibt nie erneut Punkte.

Spiele mit Punktebelohnungen

Verwaltetes Number Hunt

Wähle Number Hunt (vom Host gesteuert), Ticketkosten 0, ein Preis und optional ein Punktepreis. Der Host wählt eine Zahl von 1–100. Spieler verwenden !guess friday 50, wobei du die Gewinnspiel-ID ersetzt. Richtige Tipps belohnen den ersten berechtigten Löser einmal; falsche Tipps grenzen den Bereich für alle ein. Jeder Zuschauer darf alle fünf Sekunden einmal raten.

Verwende die verwaltete Gewinnspielanzeige oder games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Das normale Number Hunt und andere bestehende Spiele behalten ihr ursprüngliches lokales Verhalten. Ihre lokalen Punktestände und Gewinneranzeigen vergeben nicht automatisch SSN-Punkte.

Coin Flip Pot

Dies ist ein Glücksspiel. Wähle Coin Flip Pot, Preis 1, ein Ergebnis und Zusatzpreis 0. Zuschauer setzen mit !ticket friday 3 heads oder !ticket friday 3 tails. Beide Seiten benötigen einen Teilnehmer. Schließe die Teilnahme und lose aus: Der Host wählt Kopf oder Zahl mit gleicher Wahrscheinlichkeit, unabhängig von den Einsatzsummen.

Gewinnende Zuschauer erhalten ihren Einsatz zurück und teilen die verlorenen Einsätze proportional zu ihrem Einsatz. Restpunkte gehen an die größten Bruchteilsanteile; bei Gleichstand entscheidet die Reihenfolge der Teilnahme. Es wird keine Gebühr einbehalten und es entstehen keine zusätzlichen Punkte. Bei Gewinnereinsätzen von 2 und 1 gegenüber 5 verlorenen Punkten zahlt der 8-Punkte-Pot 5 und 3 aus. Brich vor der Auslosung ab, um allen zu erstatten. Wenn eine Seite leer ist, wird die Auslosung abgelehnt und du kannst abbrechen/erstatten.

Mehrere Gewinnspiele

Gib jeder Auslosung eine kurze ID aus Buchstaben, Zahlen, Bindestrichen oder Unterstrichen. Käufe eines Zuschauers über alle IDs teilen sich dasselbe verfügbare Guthaben. Jede OBS-URL enthält &giveaway=ID. Ticket- und Ratebefehle benennen die Auslosung ausdrücklich. Verwende unterschiedliche Schlüsselwörter für gleichzeitig laufende kostenlose Auslosungen: Ein mehrdeutiges kostenloses Schlüsselwort meldet nicht versehentlich zu mehreren Auslosungen an.

Die Popup-Felder sind Einrichtungswerte. Aktualisiere oder öffne den Manager, um die verbindlich gespeicherten Regeln auf dem Host zu prüfen. Das Ändern eines Zuschauerlinks ändert nur dessen Darstellungseinstellungen, nicht die Ticketregeln einer laufenden Runde.

OBS und Darstellung

Der Standardhintergrund im verwalteten Modus ist transparent. Wähle bei Bedarf einen Designhintergrund. Karte, Rolle und Community-Rad teilen dasselbe Ergebnis und sechs Farbstile. Bei aktivierter Einstellung für reduzierte Bewegung werden Enthüllungsanimationen übersprungen. Die Rad-Vorschau zeigt höchstens 120 Namen; sie ist eine Enthüllungsanimation, keine vollständige Darstellung der Chancen jedes Tickets. Die Auswahl verwendet den gesamten berechtigten Ticketpool.

Bei erneuter Verbindung zeigt die Anzeige das gespeicherte Ergebnis. Eine verbundene Anzeige verrät SSN nicht, ob diese OBS-Szene gerade sichtbar ist. Halte Steuerungs-URLs, Sitzungs-IDs und Sicherungsdateien privat.

Event Flow

Hinzufügen Gewinnspiel / Tickets aus den Punkteaktionen. Wähle Enter free giveaway, Buy tickets, Grant free tickets, Close entries, Draw winner, Cancel and refund oder Query state. Wähle ID und Ticketanzahl; beim Pot-Kauf Kopf/Zahl. Die Aktion verwendet die erfasste Zuschaueridentität. Verwende vor Vergaben oder Betreibersteuerung einen vertrauenswürdigen Auslöser/Filter.

„Buy tickets“ gibt die Punkte bereits aus. Schalte „Spend Points“ nicht davor. Ein Fehler stoppt abhängige Aktionen, ohne die ursprüngliche Chatnachricht auszublenden. Das Ergebnis steht in meta.giveawayControlResult. Das Event-Flow-Testfeld simuliert diese Aktion, ohne echte Tickets zu kaufen. Verwende einen isolierten Host/ein isoliertes Profil für Tests des gesamten Ablaufs mit echten Rundenänderungen.

Die Kaufberechtigung verwendet das verbindlich gespeicherte Guthaben zum Ausführungszeitpunkt. Verlasse dich nicht darauf, dass die Teilnahmenachricht selbst den letzten benötigten Punkt verdient. Native Nachrichten-IDs der Quelle bieten dauerhaften Schutz gegen erneute Verarbeitung; Quellen ohne sie bieten schwächere Identitätsgarantien über Neustarts hinweg. Allgemeine geplante Ereignisse ohne erfasste Zuschauer-/Nachrichten-ID können nicht im Namen einer Person kaufen.

Stream Deck und API

Das native Plugin enthält Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round und Giveaway State. Ihre Standard-ID ist default. Trage {"giveawayId":"friday"} in das Wertefeld ein, um eine andere Runde auszuwählen. Open kann auch ein config Objekt akzeptieren; andernfalls behält eine bestehende Runde ihre gespeicherten Regeln und eine neue ID verwendet die Popup-Standardwerte.

Verwende die bestehende P2P-Verbindung oder den eingerichteten WebSocket-Transport. Die Taste meldet eine Antwort von SSN; sie behauptet nicht, dass OBS live ist. Wenn eine Antwort ausbleibt, frage den Zustand ab, bevor du eine neue Auslosung versuchst.

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

Eine Vorgangs-ID bezeichnet einen Geschäftsvorgang; die Callback-ID bezeichnet eine Antwort. Behalte die Vorgangs-ID bei Wiederholungen. Ihre Wiederverwendung mit anderen Parametern schlägt fehl. Verwende für einen beabsichtigten neuen Kauf eine neue Vorgangs-ID. Bedienerzugriff auf die API kann für den angegebenen Akteur Punkte ausgeben: Stelle ihn nicht als öffentliches Kaufformular ohne Authentifizierung bereit.

Verlauf, Sicherungen und Wiederherstellung

Der Manager zeigt Runden, Teilnehmer und Gewinnerverlauf. Exportiere den Gewinnerverlauf als JSON oder speichere eine vollständige Punkte-/Gewinnspielsicherung der Version 2. Vollständige Sicherungen enthalten gemeinsam Guthaben, Reservierungen, Runden und Vorgangsbelege. Es wird nichts auf einen Server hochgeladen.

Beim Neustart des Hosts werden gespeicherte offene Runden zur Prüfung geschlossen. Ihre Tickets bleiben reserviert. Öffne sie mit denselben Regeln erneut, lose aus oder brich sie ab und erstatte. Unterbrochene Datenbanktransaktionen werden entweder vollständig übernommen oder hinterlassen keinen Teilkauf/keine Teilauszahlung. Stickerreservierungen ohne bestätigte Zustellung werden nach Ablauf ihres Zeitlimits wieder freigegeben.

Eine vollständige Wiederherstellung ist auf einem neuen Host ohne bestehende Guthaben oder Gewinnspielaufzeichnungen. Sie stellt die gesamte Momentaufnahme wieder her und hält wiederhergestellte Runden geschlossen. Sie überschreibt keinen bereits mit Daten gefüllten Host. Stelle vor dem Fortsetzen der Runden im Popup die ursprüngliche Stream-/Sitzungs-ID wieder ein; das Wiederherstellungsergebnis listet die gesicherten Sitzungen auf. Diese Sicherung ersetzt nicht deine allgemeinen Popup-Einstellungen. Betreibe den alten und den wiederhergestellten Host niemals als unabhängige Instanzen für dasselbe Punktesystem. Eine Sicherung ist eine Momentaufnahme: Sie kann keine Transaktionen enthalten, die nach dem Speichern stattgefunden haben.

Reine Guthabenimporte können ausstehende Reservierungen nicht wiederherstellen. Punkte-Reset und manuelles Überschreiben werden abgelehnt, wenn betroffene Guthaben reserviert sind. Das Zurücksetzen von Punkten löscht keine Gewinnspielbelege/-verläufe. Guthaben gehören zu diesem Browser-/App-Profil, Runden dagegen zur Sitzung. Getrennte Profile/Geräte synchronisieren sich nicht automatisch. Das Löschen von Browserdaten kann lokale Aufzeichnungen entfernen; bewahre Sicherungen daher außerhalb dieses Profils auf.

Optionale Server-Sicherung/-Synchronisierung ist eine künftige Funktion und nicht Teil dieser Version. Diese Umsetzung fügt keine Uploads, Serverzugangsdaten, käufliche Währung oder Auszahlung hinzu.

Wenn etwas nicht funktioniert

• Keine Teilnahme: prüfe ID/Schlüsselwort, Mitgliedschaftsbeschränkung, offenen Zustand und erfasste Plattform. Bot-, private, historische, erneut abgespielte und als Test markierte Teilnahmen sind ausgeschlossen.
• Konto geändert: eine Namens-/Identitätsänderung kann ein Punktekonto mehrdeutig machen. Prüfe es auf dem Host; Konten werden niemals stillschweigend plattformübergreifend zusammengeführt.
• Keine Antwort: prüfe, ob der gewünschte SSN-Host läuft und Host-Steuerung aktiviert ist. Aktualisiere den gespeicherten Zustand, bevor du es erneut versuchst.
• Zurücksetzen/Import nicht möglich: schließe reservierte Käufe zuerst ab oder brich sie ab. Verwende die vollständige Wiederherstellung für eine Sicherung mit offenen Verpflichtungen.
• Unbekannte Belohnung: !spend erfordert eine passende eingerichtete Belohnung mit Preis; für einen beliebigen Belohnungsnamen werden keine Punkte mehr verbraucht.

API-Referenz · Ereignisverträge · Umfragen und Wartelisten

Eine Sicherung Schritt für Schritt wiederherstellen

1. Lass den alten Host beendet. Öffne SSN in einem neuen Browserprofil und öffne den Gewinnspielmanager.
2. Unter Auf einem neuen Host wiederherstellen, wähle deine vollständige Sicherung. Warte auf die Wiederherstellungsmeldung und notiere die darin genannte ursprüngliche Sitzungs-ID.
3. Im Popup unter Sitzungsoptionen, gib diese ursprüngliche Sitzungs-ID ein.
4. Kehre zum Manager zurück, wähle die Gewinnspiel-ID und dann Aktualisieren. Prüfe Regeln, Teilnehmer und Gewinnerverlauf. Wiederhergestellte offene Runden werden zur Prüfung geschlossen.
5. Öffne mit denselben Regeln erneut, lose aus oder wähle Abbrechen und erstatten um reservierte Tickets zurückzugeben. Speichere nach Prüfung des Ergebnisses eine neue Sicherung.

Beginne für OBS mit einer Browserquelle von 1280 × 720. Das verwaltete Rad passt sich der verbleibenden Quellenhöhe an. Der Standardhintergrund ist ohne eigenes CSS transparent; alle üblichen Bedienelemente bleiben im Popup, Manager oder Stream Deck.