Chatlotto V1.0.0

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!