💬 DonationTrain Chatbefehle

Die folgenden Befehle stehen im Twitch-Chat zur Verfügung.

!donotrain / !donationtrain

Zeigt den aktuellen Status des DonationTrain:

- Läuft der Zug gerade?
- Ist ein Cooldown aktiv und wie lange noch?
- Oder kann der Train jederzeit wieder starten?

Zusätzlich prüft der Befehl, ob der Overlay-Zugriff mit dem hinterlegten Token funktioniert.  
Bei einem Tokenfehler, wird eine Warnung, für den Streamer, im Chat ausgegeben.

!donotrainrecord

Zeigt den aktuell gespeicherten Rekordlauf an, z. B.:

> 🚂 Train-Rekord vom 15.06.2025: Level 19 mit 111 323 Punkten und 34 Spendern!

Für Moderatoren und Streamer

!resettrain

Bricht einen laufenden DonationTrain sofort ab und setzt den Zustand zurück:

- Timer
- Punkte
- Level/Fortschrittsbalken
- Overlay-Anzeige (Widgets werden ausgeblendet)

Sinnvoll, wenn ein Testlauf schiefging oder das Overlay bewusst zurückgesetzt werden soll.

!donocooldownreset

Setzt den globalen Cooldown des DonationTrain manuell zurück.

- Der Train kann danach sofort wieder starten.
- Pre-Start (HinweisTrain) ist danach ebenfalls wieder möglich.

!testdono [anzahl]

Simuliert mehrere Testspenden hintereinander, um den Train und das Overlay zu überprüfen.

- `anzahl` wird auf den Bereich **3–20** begrenzt:
  - kleiner als 3 → es werden 3 Testspenden erzeugt
  - größer als 20 → es werden maximal 20 Testspenden erzeugt
- Jede Testspende nutzt zufällige Namen und Beträge und läuft über die **normale Startlogik** (sie können also einen echten Train starten).

Beispiel:

- `!testdono 5`  
  → 5 Testspenden werden nacheinander simuliert.

!donotrainshow

Funktion:
Blendet das DonationTrain-Overlay sofort ein – unabhängig davon, ob gerade ein Zug läuft oder nicht.

Einsatz:

• Zum Testen des Overlays in OBS/StreamElements

• Um das Overlay manuell sichtbar zu machen (z. B. vor einem Event oder nach einer manuellen Anpassung)

!donotrainhide

Funktion:
Blendet das DonationTrain-Overlay vollständig aus.

Einsatz:

• Nach Tests

• Wenn der DonationTrain vorübergehend nicht sichtbar sein soll

• Um das Overlay nach einem Stream manuell zu schließen

!donotrainfehler

Funktion:
Dient zur Überprüfung und Korrektur eines laufenden DonationTrains, wenn die Punkte und das Level nicht passen.

Überprüft zudem auch den DonationTrainRecord und korrigiert ihn gegebenenfalls, wenn die Werte nicht passen

Neue Backup-/Restore-Befehle, nur Streamer

!donotrainbackup

Funktion:
Erstellt ein vollständiges Backup der aktuellen DonationTrain-Overlay-Einstellungen bei StreamElements (Layout, Farben, Texte, Ausrichtungen usw.) und speichert es serverseitig mit Zeitstempel.

Einsatz:

• Vor Layout-Tests oder größeren Änderungen am Overlay

• Um funktionierende Stände des DonationTrain-Overlays abzusichern

!donotrainrestore

Syntax (Beispiel):
!donotrainrestore <timestamp | midTimestamp>

Funktion:
Stellt ein zuvor angelegtes Backup des DonationTrain-Overlays wieder her.
Dabei wird die gespeicherte Konfiguration (Einstellungen/Texte) zurück zu StreamElements geschrieben.

Einsatz:

• Wenn ein Overlay-Layout „zerschossen“ wurde

• Um gezielt auf einen früheren Stand zurückzuspringen (z. B. vor einem bestimmten Datum/Event)

!donotrainrestoreinfo

Funktion:
Listet die vorhandenen DonationTrain-Backups mit Datum/Uhrzeit und der zugehörigen ID (z. B. midTimestamp) auf.

Einsatz:

• Um schnell zu sehen, welche Backup-Stände verfügbar sind

• Um die passende ID/den passenden Zeitstempel für !donotrainrestore nachzuschlagen