Dynamic Title Orchestrator

1. Kern-Funktion
Der Bot überwacht den eingehenden Raid-Event. Bei Erfüllung definierter Kriterien wird der aktuelle Stream-Titel um einen String (z.B. | Raid von: [Name]) erweitert.

2. Modul-Konfiguration (Das "Mod-Panel")
Damit das System nicht den Titel „zerschießt“ oder zu lang wird, ist eine Konfigurations-Maske notwendig. Hier sind die Parameter, die das System steuern:

Raid-Schwellenwert (Size Gate): „Raid ab X Zuschauern auslösen.“ (Verhindert, dass Mini-Raids den Titel füllen).

Whitelist-Filter: „Nur Raids von [Team-Mitglieder/Bestimmte User] werden in den Titel geschrieben.“ (Schützt vor ungewollten oder „unbekannten“ Raid-Namen).

Cap-Limit (Name-Count): „Maximal Y Namen im Titel.“ (z.B. max. 3 Namen gleichzeitig).

Rotation-Policy: „Wenn voll, dann:

Option A: Ältesten Namen löschen (FIFO-Prinzip).

Option B: Ältesten Namen mit '...' kürzen.

Option C: Raid-Kette beenden und Titel zurücksetzen.“

Format-String: Du legst fest, wie es aussieht.

Beispiel: [Dein Titel] | Raid-Support: [Name1], [Name2]

3. Logik-Ablauf
Event-Eingang: OnRaidDetected.

Filter-Check: Entspricht der Raid der Konfiguration (Größe, User-Status)?

String-Processing:

Ist das Cap-Limit erreicht? Wenn ja: Entferne den ersten Raid-Namen aus dem String.

Füge den neuen Namen hinzu.

API-Update: Der Bot sendet per Twitch API (UpdateChannelInformation) den neuen Titel an deinen Stream.

4. Besondere Features für dich als Streamer
Cooldown: „Keine Raid-Aktualisierung innerhalb von X Minuten.“ (Damit nicht zwei Raids gleichzeitig den Titel sekündlich überschreiben).

Auto-Reset: Das System erkennt das Ende des Streams (oder ein definiertes Zeitfenster) und setzt den Titel beim nächsten Start automatisch auf deinen Standard-Titel zurück.

Manuelles Override: Ein Chat-Befehl für dich oder deine Leitmods (!reset-title), falls du den Titel sofort bereinigen willst.