26,99 €
Beschreibung
Chatlotto V1.0.0
CHATLOTTO
Deine Community. Deine Zahlen. Deine Ziehung.
Gib mit !lotto 05 55 42 deinen Tipp ab! Pro Runde kannst du bis zu 10 unterschiedliche Zahlen wählen.
Jeder Tippschein kostet den eingestellten Taler-Einsatz – Änderungen sind bis zum Annahmeschluss kostenlos.
🔢 Pro Ziehung werden 10 Glückszahlen gezogen.
🏆 Deine Treffer bestimmen den Gewinn. Taler werden automatisch gutgeschrieben.
⏱️ Den Countdown siehst du im Stream.
📋 !meinlotto – deinen Tipp anzeigen
📡 !lottostatus – aktuelle Runde prüfen
————————————————————————————————
Chatlotto – Anleitung für Streamer
Chatlotto ist dein interaktives Zahlenspiel für Streamlabs Chatbot. Deine Zuschauer geben im Chat einen Tippschein ab und bezahlen dafür einen festgelegten Betrag deiner Chatbot-Taler. Nach Ablauf der Tippannahme zieht das System zehn Glückszahlen, wertet die Tippscheine aus und schreibt eingestellte Gewinne automatisch gut.
Das kompakte Science-Fiction-Overlay zeigt den Countdown, die Ziehungsanimation und die gezogenen Zahlen.
————————————————————————————————
Voraussetzungen
Das Projekt wurde für folgende Zielumgebung erstellt:
• Streamlabs Chatbot Desktop, Version 1.0.2.87
• Eingerichtete Python-Scripting-Funktion mit Python 2.7.13
• Twitch-Kanal mit verbundenem Chatbot
• Lokales Chatbot-Punktesystem für Einsätze und Gewinne
• OBS Studio oder Streamlabs Desktop mit Browser-Quelle
Verwendet werden die Punkte des lokalen Streamlabs Chatbots – nicht Twitch-Kanalpunkte oder Cloudbot-Punkte.
Hinweis zum Entwicklungsstand: Das Projekt wurde mit simulierten Backend-Tests geprüft. Ein vollständiger Praxistest in der genannten Chatbot-, Python- und OBS-Umgebung steht noch aus. Teste deshalb vor dem regulären Einsatz alle Abläufe mit kleinen Beträgen.
————————————————————————————————
Installation
Script installieren
1. Entpacke das vollständige Chatlotto-Projekt.
2. Kopiere den Ordner Chatlotto in das Script-Verzeichnis:
%APPDATA%\Streamlabs\Streamlabs Chatbot\Services\Scripts\
3. Starte den Chatbot neu oder lade die Scripts neu.
4. Wähle Chatlotto aus und aktiviere es.
5. Öffne die Script-Einstellungen.
config.json und die Rundendaten werden bei der Nutzung erzeugt.
————————————————————————————————
Einstellungen vor der ersten Runde
Allgemeine Einstellungen
Einstellung Bedeutung
Tipp-Befehl Standardmäßig !lotto
Kleinste Zahl Untere Grenze des erlaubten Zahlenbereichs
Größte Zahl Obere Grenze des erlaubten Zahlenbereichs
Maximale Zahlen je Tippschein Zwischen 1 und 10
Doppelte Ziehungszahlen Erlaubt oder verhindert Wiederholungen bei der Ziehung
Kurzform Aktiviert beispielsweise !54 06 04
Der Zahlenbereich muss innerhalb von 1–99 liegen. Das Tippmaximum darf nicht größer als die Anzahl verfügbarer unterschiedlicher Zahlen sein.
Wenn du doppelte Ziehungszahlen ausschaltest, muss der Zahlenbereich mindestens zehn unterschiedliche Zahlen enthalten.
————————————————————————————————
Einsatz
Unter „Taler pro Tippschein“ legst du den Preis fest.
Beispiel: Bei einem Einsatz von 50 Talern kosten alle diese Tippscheine jeweils 50 Taler:
!lotto 05
!lotto 05 55
!lotto 05 55 42 68 12
Der Preis gilt für den gesamten Tippschein, nicht pro Zahl.
————————————————————————————————
Zeiten
Einstellung Bedeutung
Dauer der Tippannahme Zeit in Minuten bis zum Annahmeschluss
Dauer der gesamten Ziehung Gesamtzeit für die Animation aller zehn Zahlen, mindestens 10 Sekunden
Ergebnis-Nachlauf Anzeigedauer nach Abschluss aller Auszahlungen
Beispiel:
Tippannahme: 15 Minuten
Ziehung: 60 Sekunden
Ergebnis-Nachlauf: 15 Sekunden
Die nächste Runde beginnt nach diesen Phasen automatisch. Die Bearbeitung der Auszahlungen kann zusätzliche Zeit beanspruchen.
————————————————————————————————
Gewinnstaffeln einstellen
Chatlotto unterscheidet zwischen:
1. Der Anzahl abgegebener Zahlen
2. Der Anzahl richtiger Treffer
Für einen Tippschein mit drei Zahlen gibt es beispielsweise drei mögliche Gewinnwerte:
Gewinne: 3 Tippzahlen
1 Treffer: 10 Taler
2 Treffer: 100 Taler
3 Treffer: 500 Taler
Diese Beträge sind Beispiele. Du bestimmst die tatsächlichen Werte.
Für Tippscheine mit einer bis zehn Zahlen gibt es insgesamt 55 einstellbare Gewinnwerte.
Wichtig vor dem Start
Alle Gewinnwerte stehen im ursprünglichen Projekt zunächst auf 0. Mindestens ein Wert muss größer als null sein, sonst startet keine neue Runde.
Prüfe trotzdem alle Stufen, die du anbieten möchtest. Eine auf null gesetzte Stufe zahlt auch bei entsprechend vielen Treffern nichts aus.
————————————————————————————————
Auszahlungsregel
Es wird ausschließlich die passende Gewinnstufe ausgezahlt.
Bei drei richtigen Zahlen gibt es also den Betrag für drei Treffer – nicht zusätzlich die Beträge für einen und zwei Treffer.
Der angegebene Gewinn ist der gesamte Auszahlungsbetrag. Der Einsatz wird bei einem Gewinn nicht zusätzlich erstattet.
————————————————————————————————
So geben Zuschauer ihre Tipps ab
Der Standardbefehl lautet:
!lotto 05 55 42
Dabei gelten folgende Regeln:
• Mindestens eine Zahl angeben.
• Höchstens so viele Zahlen abgeben, wie du eingestellt hast.
• Alle Zahlen müssen im erlaubten Bereich liegen.
• Keine Zahl darf auf einem Tippschein doppelt vorkommen.
• Führende Nullen sind optional: 5 und 05 gelten als dieselbe Zahl.
• Jeder Chatter hat einen Tippschein pro Runde.
Prüfung und Bezahlung
Bei einer neuen Abgabe prüft das Script:
1. Ist die Tippannahme geöffnet?
2. Sind die Zahlen gültig?
3. Hat der Chatter genügend Taler?
4. War der Einsatzabzug erfolgreich?
Erst dann wird der bezahlte Tippschein angenommen.
Bei ungültigen Zahlen oder zu wenig Guthaben wird kein neuer Tippschein angenommen und kein regulärer Einsatzabzug durchgeführt.
————————————————————————————————
Tippschein ändern
Ein Chatter kann seinen vorhandenen Tippschein bis zum Annahmeschluss durch einen neuen gültigen Tipp ersetzen:
!lotto 05 55 42
Später:
!lotto 06 12
Diese Änderung kostet keinen weiteren Einsatz. Es gilt anschließend nur der zuletzt angenommene Tippschein.
Eine ungültige Änderung lässt den bisherigen Tippschein unverändert.
Optionale Kurzform
Wenn du die Kurzform aktivierst, wird auch Folgendes angenommen:
!54 06 04
Das entspricht:
!lotto 54 06 04
Lasse die Kurzform ausgeschaltet, wenn du andere Chat-Befehle verwendest, die mit einer Zahl beginnen.
————————————————————————————————
Wie Treffer gezählt werden
Die Reihenfolge spielt keine Rolle.
Beispiel:
Tippschein:
05 55 42
Gezogene Zahlen:
01 06 55 14 36 22 74 65 25 05
Ergebnis: Zwei Treffer – 05 und 55.
Doppelt gezogene Glückszahlen
Wenn Wiederholungen erlaubt sind, kann eine Zahl mehrfach unter den zehn Glückszahlen stehen.
Beispiel:
05 05 55 14 36 22 74 65 25 14
Eine getippte 05 zählt trotzdem nur als ein Treffer. Jede Zahl des Tippscheins kann höchstens einmal richtig sein.
————————————————————————————————
Eine Runde starten und durchführen
Runde starten
Sende als Kanalinhaber im Chat:
!lottoadmin start
Das System öffnet die Tippannahme. Im Overlay erscheint:
NÄCHSTE ZIEHUNG IN
14:59
Der Countdown richtet sich nach dem tatsächlichen Annahmeschluss der Runde.
Automatische Ziehung
Nach Ablauf der Annahmezeit:
1. Die Tippannahme wird geschlossen.
2. Zehn Glückszahlen werden festgelegt.
3. Die LED-Sequenz beginnt.
4. Die erste Zahl rollt durch und bleibt auf ihrem Ergebnis stehen.
5. Die LED-Laufrichtung wechselt für das nächste Zahlenfeld.
6. Der Ablauf wiederholt sich bis zur zehnten Zahl.
7. Die Tippscheine werden ausgewertet.
8. Gewinne werden gutgeschrieben und im Chat angekündigt.
Während der Animation zeigt der Countdown die verbleibende Ziehungszeit.
Nächste Runde
Nach Abschluss der Auszahlungen und des Ergebnis-Nachlaufs öffnet die nächste Runde automatisch.
Während Auswertung und Nachlauf zeigt das Overlay einen Status statt einer geschätzten Zeit bis zur nächsten Ziehung. Sobald die neue Tippannahme geöffnet ist, erscheint wieder der korrekte Countdown.
————————————————————————————————
Zuschauerbefehle
Befehl Funktion
!lotto 05 55 42 | Tippschein abgeben oder ändern
!meinlotto | Eigenen aktuellen Tippschein anzeigen
!lottostatus | Rundenstatus und verbleibende Annahmezeit anzeigen
Wenn du den Tipp-Befehl in den Einstellungen änderst, betrifft das die Tippabgabe. Die Status- und Verwaltungsbefehle bleiben unverändert.
————————————————————————————————
Streamerbefehle
Die Verwaltungsbefehle sind ausschließlich für das im Chatbot eingestellte Kanalinhaber-Konto vorgesehen.
Befehl Funktion
!lottoadmin start | Neue Runde starten oder pausierte Annahme fortsetzen
!lottoadmin pause | Offene Tippannahme pausieren
!lottoadmin ziehen | Annahme sofort schließen und eine echte Ziehung starten
!lottoadmin abbrechen | Offene, pausierte oder noch laufende Ziehungsrunde abbrechen und Einsätze erstatten
!lottoadmin stop | Im Ergebnis-Nachlauf stoppen, bevor die nächste Runde beginnt
!lottoadmin pruefen | Internen Status und gegebenenfalls eine unklare Buchung anzeigen
Wichtige Unterschiede
pause ist für die Tippannahme gedacht, nicht für eine bereits laufende Ziehung.
ziehen ist kein Testbefehl. Die Runde wird regulär ausgewertet und Gewinne werden ausgezahlt.
abbrechen beendet die Runde mit Erstattung der bezahlten Einsätze. Eine bereits laufende Auszahlung
lässt sich damit nicht rückgängig machen.
stop ist für den Ergebnis-Nachlauf gedacht. Möchtest du eine offene Runde beenden, verwende abbrechen; möchtest du sie nur unterbrechen, verwende pause.
————————————————————————————————
Speicherung und Neustarts
Das Projekt speichert:
Datei Inhalt
config.json Einstellungen
data/state.json Aktuelle Runde, Tippscheine und Buchungsstatus
data/round_XXXXXX.json Abgeschlossene Rundendaten
Dateien mit .bak Vorherige gespeicherte Dateistände
Lösche diese Dateien nicht während des Betriebs.
Verhalten nach einem Neustart
Eine gespeicherte Runde wird fortgesetzt. Die Zeiten basieren auf tatsächlichen Uhrzeiten:
• Ist die Tippannahme während der Abschaltung abgelaufen, wird sie beim Fortsetzen geschlossen.
• Eine bereits festgelegte, inzwischen abgelaufene Ziehung kann nach dem Neustart ausgewertet werden, auch
wenn die Animation nicht vollständig zu sehen war.
Plane Neustarts deshalb möglichst zwischen den Runden.
————————————————————————————————
Unklare Punktebuchungen
Das Script speichert einen Buchungsauftrag vor dem Aufruf des Punktesystems. Trotzdem kann ein Absturz genau zwischen Punktebuchung und anschließender Speicherung passieren.
In diesem Fall hält das System weitere Spielvorgänge an, statt die möglicherweise schon erfolgte Buchung automatisch zu wiederholen.
Vorgehen
1. Status anzeigen:
!lottoadmin pruefen
2. Betroffenen Chatter, Betrag und Buchungsart prüfen.
3. Im Chatbot feststellen, ob die Buchung tatsächlich erfolgt ist.
4. Erst danach den passenden Verwaltungsbefehl verwenden.
Bereits ausgeführte Buchung bestätigen:
!lottoadmin bestaetigen
Dieser Befehl markiert die Buchung als erledigt, ohne erneut Punkte zu übertragen.
Nicht ausgeführte Buchung verwerfen:
!lottoadmin verwerfen
Bei einer Auszahlung oder Erstattung wird anschließend ein neuer Versuch möglich. Bei einem Einsatz wird der zugehörige Tippschein nicht angenommen.
Diese Befehle niemals auf Verdacht verwenden. Eine falsche Entscheidung kann doppelte Auszahlungen oder fehlende Einsätze verursachen.
————————————————————————————————
Empfohlener erster Funktionstest
1. Einsatz auf 0 stellen.
2. Einige Gewinnstufen auf kleine Werte setzen.
3. Runde mit !lottoadmin start öffnen.
4. Mit einem Zuschauer-Konto einen Tippschein abgeben.
5. Den Tippschein ändern.
6. Eine ungültige Änderung versuchen und prüfen, ob der alte Tipp erhalten bleibt.
7. Mit !lottoadmin ziehen die echte Ziehung auslösen.
8. Overlay, Sounds, Chatmeldung und Kontostand prüfen.
9. Eine weitere Runde mit kleinem Einsatz testen.
10. Diese Runde abbrechen und die Erstattung kontrollieren.
11. Im Ergebnis-Nachlauf mit !lottoadmin stop die automatische Folgerunde verhindern.
————————————————————————————————
Häufige Probleme
Das Overlay zeigt keine aktuellen Daten
Prüfe:
• Ist das Script aktiviert?
• Zeigt die Browser-Quelle auf den installierten Projektordner?
• Wird overlay/state.js regelmäßig aktualisiert?
• Hat der Chatbot Schreibrechte?
• Wurde der Browser-Cache nach einem Update neu geladen?
Eine Runde startet nicht
Prüfe insbesondere:
• Sind alle Gewinnwerte noch 0?
• Ist der Zahlenbereich gültig?
• Sind ohne Wiederholungen mindestens zehn Zahlen verfügbar?
• Ist der Absender tatsächlich der Kanalinhaber?
• Liegt eine unklare Buchung vor?
Beschriftungen sind zu klein oder abgeschnitten
Stelle die Browser-Quelle tatsächlich auf 900 × 200 ein. Entferne alte benutzerdefinierte CSS-Regeln, die das aktuelle Layout überschreiben.
Wenn du die fertige Quelle im Stream stark verkleinerst, werden auch die Beschriftungen kleiner.
Es ist kein Ton hörbar
Prüfe:
• Ton im Script aktiviert
• Lautstärke größer als null
• Sounddateien vorhanden
• Browser-Audio und Routing im Streamingprogramm
• In der normalen Browser-Demo gegebenenfalls Tonfreigabe erforderlich
Gewinnernachrichten kommen verzögert
Chatmeldungen werden über eine Warteschlange ausgegeben. Bei vielen Tippbestätigungen oder Gewinnern kann die Chatmeldung später erscheinen als die eigentliche Punktebuchung.
Doktor Vin
ich wünsche viel Spaß damit!





