🔧 DonationTrain Konfiguration – Erklärung der Einstellungen

Alle zentralen Einstellungen des DonationTrain stehen in der Datei
`config/donationTrainConfig.json`.

Jeder Eintrag steuert einen klar abgegrenzten Teil der Logik:

Basis-Einstellungen

- **cooldownMinutes**
Globale Wartezeit in Minuten nach Ende eines DonationTrain.
In dieser Zeit kann kein neuer Zug starten und es wird kein Pre-Start angezeigt.

- **secondsPerLevel**
Zeit in Sekunden pro Level.
Jede gültige Spende setzt den Timer des aktuellen Levels wieder auf die volle Zeit zurück.

- **maxLevel**
Maximale Anzahl an Leveln, die innerhalb eines Laufes erreicht werden können.
Sobald dieses Level erreicht ist, endet der Train nach Ablauf des Timers.

- **startGoal**
Benötigte Punktzahl für **Level 1**.
Beispiel:
`startGoal = 1000` und `pointsPerEuro = 100` → 10 € für Level 1.

- **pointsPerEuro**
Wieviele Punkte pro Euro vergeben werden.
Typischer Wert: `100` (1 € = 100 Punkte).

Startlogik & Zeitfenster

- **minutesPerPerson**
Länge des persönlichen Zeitfensters (in Minuten), in dem ein Spender zur Startbedingung zählt.
Innerhalb dieses Fensters werden seine Beträge aufsummiert.
Nur Spender, deren Fenster noch läuft, werden für „Anzahl verschiedener Spender“ und den Gesamtbetrag berücksichtigt.

- **startDonors**
Anzahl verschiedener Spender, die zum Start benötigt werden.
Standard bei fehlendem Eintrag: `3`.
Wird zusammen mit dem Gesamtbetrag (mindestens 5 €) zur Startbedingung verwendet.

Levelwachstum

- **goalGrowthPercent**
Prozentsatz, um den das Ziel pro Level wächst.
Beispiel: `30` → jedes neue Level braucht 30 % mehr Punkte als das vorherige.
Die Levelziele werden intern automatisch als Liste berechnet (Level 1 = `startGoal`, Level 2 = `startGoal × (1 + goalGrowthPercent/100)`, usw.).

Overlay-Darstellung

- **showLastDonator**
- `true`: der letzte Spender wird im Overlay sichtbar angezeigt.
- `false`: keine Spenderanzeige, mehr Platz für Balken/Timer.

- **thankDonatorsOnEnd**
- `true`: am Ende des Zugs wird im Chat automatisch eine Sammel-Dankesnachricht an alle beteiligten Spender gesendet.
- `false`: kein automatischer Dank.

- **widgets**
Liste der StreamElements-Widgets, die beim Start/Ende des DonationTrain automatisch ein- bzw. ausgeblendet werden.
Beispiel:
`["DonationTrain"]` → Hauptwidget
In Kombination mit Hinweiswidget siehe unten.

Hinweis-Overlay (Pre-Start)

- **hinweisTrain**
- `true` (Standard): Pre-Start-Logik ist aktiv, das Hinweis-Overlay wird entsprechend geschaltet.
- `false`: Pre-Start wird komplett unterdrückt.

- **hinweisTrainWidget**
Name des StreamElements-Widgets, das als Pre-Start-Hinweis genutzt wird (z. B. `"HinweisTrain"`).