🛠️ DonationTrain – Changelog

2025-12-04
Manuelle Overlay-Steuerung & Backup-/Restore-System

Neue Kommandos zur Overlay-Steuerung:

• `!donotrainshow` blendet das DonationTrain-Overlay manuell ein – unabhängig davon, ob gerade ein Zug läuft.
• `!donotrainhide` blendet das Overlay vollständig aus, z. B. nach Tests oder nach dem Stream.
• `!donotrainfehler` prüft einen laufenden DonationTrain auf Unstimmigkeiten (Punkte, Level, Fortschrittsbalken) und korrigiert den Zustand sowie den gespeicherten Rekordlauf automatisch, falls nötig.

 Backup- und Restore-Funktionen für das Overlay (nur Streamer):

• `!donotrainbackup` erstellt ein vollständiges Backup der aktuellen DonationTrain-Overlay-Einstellungen bei StreamElements (Layout, Farben, Texte, Ausrichtung etc.) mit Zeitstempel auf dem Server.
• `!donotrainrestore` stellt ein ausgewähltes Backup wieder her und schreibt die gespeicherte Konfiguration zurück nach StreamElements.
• `!donotrainrestoreinfo` listet alle verfügbaren Backups mit Datum/Uhrzeit und passender ID auf, damit gezielt ein bestimmter Stand gewählt werden kann.

2025-10-23

Robustere Spendenerkennung, Namensvalidierung & Selbstkorrektur

• Spendenerkennung verbessert

  • Parser akzeptiert mehr Chat-/System-Varianten (SE, Ko-fi, freie Chattexte), unterschiedliche Währungsformen („€“, „EUR“) sowie Dezimaltrennzeichen („, “/ „.“).
  • Tolerant gegenüber Emojis/Sonderzeichen; irrelevante Prä-/Suffixe werden entfernt, Beträge sicher extrahiert.
  • Duplikat- und Rauscherkennung: Mehrfachmeldungen derselben Spende innerhalb kurzer Zeitfenster werden dedupliziert.

• Erkennung fehlerhafter/nicht existierender Namen

  • Namens-Sanitizer (Trim, Unicode-Normalisierung, Entfernung unsichtbarer Zeichen, Längen-/Zeichenprüfung).
  • Ungültige oder leere Namen werden als „anonym-<laufendeNr>“ gezählt (Case-insensitive Mapping von anonym/anonymous/Anonymous usw.), damit mehrere anonyme Spender korrekt als verschiedene Personen für die Startlogik gezählt werden.
  • Schutz vor Fake-/Placebo-Namen (z.B. nur Sonderzeichen): automatische Umstufung zu anonym-IDs.

• Selbstkorrektur & Validierung

  • Nach jeder Spende: Rebuild der Session-Summen aus dem Ereignislog; Abgleich der Invarianten
  • (progressInLevel = totalPoints − Σ levelGoals(<currentLevel); 0 ≤ progressInLevel < currentGoal).
  • Bei Abweichung: automatischer Self-Fix des States (Level, Progress, Goal, TotalPoints).
  • Beim Beenden: Konsistenzprüfung des donationTrainRecord (Datum, maxLevel, totalPoints, donatorCount) gegen die Session; atomare Korrektur bei Unstimmigkeiten inklusive Fix-Logeintrag.
  • Overlay-Watchdog: Nach Endsignal wird die Widget-Sichtbarkeit geprüft (mehrfache Retry-Versuche in kurzem Intervall). Bleibt etwas sichtbar, erfolgt ein forceHide für alle in der Konfiguration gelisteten Widgets.

• Logging & Nachvollziehbarkeit

  • Einheitliche Konsolen-Tags: [PARSE], [VALIDATE], [SELF-FIX], [RECORD], inkl. betroffener Donation-ID/Name und Korrekturdetails.
  • Zusammenfassung der vorgenommenen Auto-Fixes am Ende einer Session.

2025-08-06

• 🔁 Levelberechnung überarbeitet:
  Die Fortschrittslogik berechnet nun den Level live anhand der aktuellen Punktezahl – unabhängig vom gespeicherten Overlay-Zustand (hypeData.level).
  → Dadurch wird garantiert, dass der angezeigte Level und Fortschrittsbalken immer korrekt sind, auch nach Neustarts oder JSON-Fehlern.

• ✅ Korrekte Fortschrittsanzeige auch bei Spenden mit Kommastellen:
  Spenden wie „8,50 €“ oder „20,99 €“ werden exakt verarbeitet und fließen korrekt in die Level- und Fortschrittsberechnung ein.

2025-08-01

• Hintergrundfarbe der Box nun im Menü frei einstellbar

• Hintergrunddurchsichtigkeit über Menü regelbar (Standardwert: 0.6)

• Timer-Schriftgrößen über Menü einstellbar:
  • Normal: 18 • Vergrößert: 28

2025-07-30

• PM2 Watch Delay überarbeitet: Watcher-Script prüft nach Änderung von donationTrain.js die Instanzlaufzeit erst nach 4 Sekunden – damit die neu gestarteten Instanzen korrekt erkannt werden.

• Verkettete Watch-Probleme gelöst: Der Watch-Mechanismus wird jetzt unabhängig von der Datei-Verlinkung korrekt ausgewertet.

2025-07-26

• Spenderdank verbessert: Alle Spender werden am Ende des Zugs automatisch gedankt (thankDonatorsOnEnd aktiviert).

• Spenderliste bereinigt: Fehlerhafte doppelte Spendernamen werden korrekt gefiltert.

• Levelbalken überarbeitet: Fortschrittsbalken zeigt nun korrekt den Fortschritt innerhalb des aktuellen Levels.

• Neue Leveltexte: Erweiterte Auswahl an Level-Textnachrichten für mehr Abwechslung und Immersion.

2025-07-08

• Best-of-Version umgesetzt: Eigenständige donationTrain.js-Version mit JWT-Unterstützung, automatischem Overlay-Handling und Twitch-Chat-Integration.

• Dynamische Fortschrittsberechnung: Spendenpunkte, Levelziele und Countdown-Zeiten vollständig konfigurierbar über donationTrainConfig.json.

2025-06-15

• Neuer Zug-Rekord: Level 19 mit 111.323 Punkten durch 34 Spender (gespeichert in donationTrainRecord.json).

• Overlay aktualisiert: Fortschritt, Zeit und Spenderdaten in hypeOverlay.json live synchronisiert.

2025-06-07

• Spendenplattform-Erkennung erweitert: Unterstützung für StreamElements, Ko-fi und individuelle Spendenformate per donationTrigger.json.

• Kommandos hinzugefügt: !donotrain, !testdono, !donocooldownreset, !resettrain im Twitch-Chat verfügbar.

• Simulationsmodus: Zufällige Testspenden durch Moderatoren möglich, zur Vorschau von Animation und Overlay-Verhalten.

2025-05-07

• 🚀 Projekt gestartet: Erste Ideen und Grundkonzept für den DonationTrain entworfen. Ziel: ein vollautomatischer Spendenzug mit Twitch-Integration, Overlay-Ansteuerung und Konfigurierbarkeit.
  (Hatte Zeit – war an meinem Geburtstag ^^)