Handbuch

Inhalt

Teil A Grundlagen · B Mandanten-Panel · C Öffentlich · D Plattform · E Hilfe · Anhang

1. A1 – Worum geht es?
2. A2 – Einloggen, Konto & Setup
3. A3 – Panel-Übersicht (alle Menüs)
4. A4 – Streamer vs. Plattform-Inhaber
5. B5 – Module
6. B6 – Team & Rechte
7. B7 – Chat-Befehle
8. B8 – Bausteine (Kurz)
9. B9 – Befehl-Typen & Limits
10. B10 – Glücksrad · B11 – Gewinnspiel · B12 – Würfel
11. B13 – Watchtime · B13b – Community-Punkte · B13bb – Belohnungen · B13c – Bot-Datenexport
12. B14 – Chat-Duell · B14b – Community-Build · B14c – Galgenmännchen · B14d – Chat-Safari · B14e – Wartelisten · B14f – Zitate
13. B15 – Shoutout, Sound, Begrüßungen, Lurk
14. B16 – Live jetzt · B16b – Live-Steuerung · B17 – OBS-Timer & Overlays · B17b – Stream-Alerts · B17c – Stream-Outro
15. B18 – Stream-Statistik · B19 – Community & Verzeichnis · B19b – Streamplan
16. B20 – Multistream · B21 – Discord-Alarme
17. B22 – Protokoll · B23 – Datenschutz Self-Service · B23b – Ideen-Board (Mandant)
18. B24 – Bot: kann / kann nicht
19. C25 – Öffentliche URLs & Landing
20. D26 – Mandanten-Verwaltung · Auszeichnungen · D27 – Bot-Alarme · D27b – Ideen-Board (Plattform)
21. D28 – DSGVO-Postfach · D29 – System & SMTP
22. D30 – !dev & Wartung
23. E31 – Daten & Hilfe
24. Anhang A – Alle Bausteine · B – Rechte-Matrix

A1. Worum geht es?

Streamheim ist eine Plattform für Twitch-Streamer: Bot, Glücksrad, Gewinnspiele, Watchtime, Chat-Spiele und Team-Zugänge – gesteuert über das Browser-Panel.

Der Bot antwortet nur auf Befehle, die mit ! beginnen und die du im Panel angelegt hast (oder die zu aktivierten Modulen gehören). Er liest den Chat, speichert aber keine vollständigen Chatverläufe und führt keine Twitch-Moderation aus.

Jeder Mandant (Kanal) hat eigene Einstellungen, Befehle, Module und Team-Zugänge. Der Bot-Name steht unter Setup → Twitch & Discord.

A2. Einloggen, Konto & Setup

1. Registrierung auf panel.streamheim.de oder Login mit Twitch.
2. Im Menü Setup → Twitch & Discord: Broadcaster- und Bot-OAuth verbinden.
3. Im Chat einmal /mod DEIN_BOT_NAME eingeben – Twitch erlaubt Bots oft nur als Mod zu schreiben.
4. Prüfe die Setup-Checkliste (grüne Häkchen = bereit).
5. Unter Module die gewünschten Funktionen aktivieren.
6. Optional: OBS-Browser-Quellen für Overlays aus dem Setup kopieren.

Konto & Anmeldung

• Login mit Benutzername (nicht nur Anzeigename) oder Twitch-OAuth
• Mein Konto: Passwort, E-Mail, Anzeigename, Datenschutz-Bestätigung
• Passwort vergessen → Link auf Login-Seite (E-Mail muss hinterlegt sein)
• Mehrere Kanäle: Channel-Switcher oben (Owner sieht alle Mandanten)
• Bei erstem Login: Datenschutz-Hinweis bestätigen (Version wird gespeichert)

Was die beiden OAuth-Verbindungen bedeuten

A3. Panel-Übersicht (alle Menüs)

Das Menü links ist nach dem geordnet, was du vorhast: Start (Dashboard, Live jetzt), Bot (Chat-Befehle, Texte, Timer-Nachrichten, Live-Steuerung), Spiele, Community (Punkte, Belohnungen, Watchtime …), Stream (Streamplan, Statistik, Outro), Overlays (alles, was in OBS zu sehen ist) und Kanal (verbinden, Module, Export, Protokoll). Was du nicht eingeschaltet hast, steht nicht im Menü – unter Kanal → Module schaltest du es zu.

A4. Streamer vs. Plattform-Inhaber – wer darf was?

Als Streamer (Broadcaster) steuerst du deinen Kanal selbst. Der Inhaber / Entwickler betreibt die Plattform.

B5. Module aktivieren & deaktivieren

Unter Kanal → Module schaltest du Funktionen pro Kanal frei. Deaktivierte Module liefern keine Bot-Befehle und keine zugehörigen Overlays – bestehende Befehle dieses Typs werden ignoriert.

B6. Team, Moderatoren & Rechte

6.1 Benutzer anlegen (Team → Benutzer)

• Neue Zugänge für Leitenden Mod, Moderator oder VIP
• Passwort setzen oder automatisch generieren lassen
• Accounts deaktivieren, wenn jemand das Team verlässt
• E-Mail trägt jeder selbst unter „Mein Konto“ ein

6.2 Rechte & Rollen (Team → Rechte & Rollen)

In der Matrix stellst du pro Rolle und Bereich ein:

• – Kein Zugriff – Menüpunkt unsichtbar
• 👁 Ansehen – lesen, nichts ändern (ideal für VIPs)
• ✓ Bearbeiten – anlegen, ändern, löschen

6.3 Rollen im Überblick

B7. Chat-Befehle anlegen (Schritt für Schritt)

Menü Chat-Befehle → + Befehl hinzufügen

1. Trigger-Wort ohne !, z. B. hallo → im Chat !hallo
2. Typ wählen – siehe Kapitel 9
3. Antwort-Vorlage mit Bausteinen – farbige Chips unter dem Textfeld
4. Vorschau prüfen – zeigt ungefähre Chat-Ausgabe
5. Cooldown in Sekunden (Mindestabstand pro User)
6. Nutzungslimit – z. B. „Einmal pro Stream“ für Würfel
7. Chat-Berechtigung – Alle, VIP+, Mods+, Nur Streamer
8. Panel-Icon: Optionales Emoji/Bild pro Befehl – erscheint in {roll_icon} bei Würfeln
9. Eigene URL: Feld für {url} im Befehl

Beispiel: Einfacher Begrüßungsbefehl

Trigger: hallo · Typ: Eigener Text
Vorlage: Hey, {author} – schön, dass du da bist! 👋
Im Chat: „Hey, MaxMusti – schön, dass du da bist! 👋“

Beispiel: Umarmung mit Zähler

Trigger: hug · Vorlage: {author} umarmt {target_user} 🤗 Das war schon {count_next}×!
Im Chat: !hug @MaxMusti
{count_next} zählt mit und zeigt den neuen Stand; {count} nur anzeigen ohne +1.

Befehl pausieren oder löschen

• Deaktivieren: Häkchen „Aktiv“ entfernen – Befehl bleibt gespeichert
• Löschen: Papierkorb in der Liste – Zähler-Daten gehen mit
• Daten zurücksetzen: Im Bearbeiten-Fenster unten – nur Zähler/Würfe, nicht der Befehl selbst

B8. Bausteine – {author} & Co.

Geschweifte Klammern werden beim Antworten ersetzt. Im Panel als farbige Chips einfügbar (Menü Bausteine).

Personen

Baustein	Bedeutung	Beispiel
{author}	Wer den Befehl geschrieben hat (Display-Name)	MaxMusti
{target_user}	Angesprochener User bei !hug @Name	Lisa
{login} / {author_login}	Twitch-Login kleingeschrieben	maxmusti

Zähler (bei „Eigener Text“)

Baustein	Bedeutung
{count} / {count_next}	Gesamt-Nutzungen – nur anzeigen bzw. +1 zählen
{author_count} / {author_count_next}	Nutzungen dieses Users
{pair_count} / {pair_count_next}	Wie oft Autor + dieses Ziel zusammen
{others_count} / {others_count_next}	Alle anderen (Gesamt minus Autor)
{target_count} / {target_count_next}	Wie oft dieses Ziel genannt wurde

Würfel & Stufen

Baustein	Bedeutung
{random_percent}	Gewürfelter Wert 0–100
{random_tier}	Stufen-Text passend zum Prozentwert
{roll_icon}	Emoji aus Befehl-Einstellung „Panel-Icon“
{schulleiter_suffix}	Zusatz bei neuem Stream-Rekord in Top-Stufe
{daily_leader_name} / {daily_leader_percent}	Tages-Rekord Name und Wert
{board}	Gruppierte Stream-Liste + Spitzenreiter
{klassen_stat} / {stats_summary}	Komplette oder kurze Statistik
{participant_count}	Anzahl Würfe im Stream

Stream, Watchtime, Links

Baustein	Bedeutung
{uptime} / {timer}	Laufzeit seit !streamstart
{countdown}	Verbleibende Countdown-Zeit
{args}	Alles nach dem Trigger, z. B. 5m bei !countdown 5m
{channel}	Dein Twitch-Kanalname
{watchtime} / {watchtime_detailed}	Zuschauer-Zeit kurz oder detailliert
{rank} / {total_users}	Platz und Anzahl im Leaderboard
{wt_url} / {wtr_url} / {wto_url} / {points_url}	Watchtime-, Würfel-, Overlay- und Punkte-Board-URL
{streamer} / {game_played}	Shoutout: Name und zuletzt gespieltes Spiel
{prize} / {author}	Glücksrad: Gewinn und Auslöser ({user} = Alias)
{winners} / {duration}	Gewinnspiel: Gewinner, verbleibende Zeit
{limit_when}	Text zum Nutzungslimit („heute“, „diesen Stream“)
{project} / {emoji} / {unit}	Community-Build: Projektname, Emoji, Zähleinheit
{progress} / {goal} / {contributors}	Community-Build: Fortschritt, Ziel, Anzahl Mitwirkender

Tipp: Bausteine exakt mit geschweiften Klammern schreiben – am besten die Chips aus dem Panel nutzen. Groß/Klein ist meist egal ({Author} = {author}).

B9. Befehl-Typen, Limits & Chat-Berechtigungen

Alle Befehl-Typen

Typ	Wofür?
Eigener Text	Freie Antwort mit Bausteinen und Zählern
Zufalls-Spruch	Zufällige Zeile aus Liste – eine Zeile pro Satz oder mit 'satz' getrennt
Shoutout	Streamer empfehlen – Ziel nach Trigger, z. B. !so LRDE_Alex
Zufalls-Prozent	Würfelt 0–100 % mit Stufen & Spitzenreiter
Prozent-Liste	Alle Würfe des laufenden Streams
Wurf-Statistik	Kompakte Statistik (Teilnehmer, Stufen, Spitzenreiter)
Stream starten / stoppen	!streamstart / !streamstop – Uptime & Limits
Streamzeit / Timer	Laufzeit anzeigen
Countdown	Countdown mit automatischen Chat-Updates
Glücksrad drehen	Rad im Overlay + Ergebnis im Chat
Gewinnspiel starten / beitreten	Lostopf öffnen / Teilnahme
Watchtime / Rang	Eigene Zeit oder Platz in der Rangliste
Sound	Sound oder Musik in OBS (eigene Datei, Streamheim-Pool oder externe URL)

Nutzungslimit

Einstellung	Bedeutung
Immer (nur Cooldown)	Unbegrenzt – nur Sekunden-Abstand pro User
Einmal pro Stream	Pro Person einmal – ab !streamstart
Einmal pro Tag	Pro Person einmal pro Kalendertag
Einmalig pro Person	Nur ein einziges Mal insgesamt

Chat-Berechtigung

Einstellung	Wer darf?
Alle	Jeder im Chat
VIP+	Subs, VIPs, Mods und Streamer
Mods+	Mods und Streamer
Nur Streamer	Nur der Kanal-Inhaber – z. B. !rad

Höhere Rollen dürfen immer mit – ein Mod kann auch Befehle nutzen, die „VIP+“ erlauben.

B10. Glücksrad

1. Modul Glücksrad aktivieren
2. Unter Glücksrad → Preise: Segmente anlegen – Gewicht = relative Wahrscheinlichkeit
3. Chat-Befehl vom Typ Glücksrad drehen anlegen (z. B. Trigger rad → !rad)
4. OBS: Browser-Quelle aus Setup – zeigt Animation und Ergebnis live
5. Drehungen erscheinen im Protokoll unter „Auslosungen“

Typisch: !rad nur für Nur Streamer – damit nicht jeder Zuschauer das Rad triggert.

B11. Gewinnspiel

1. Modul Gewinnspiel aktivieren
2. Befehl Gewinnspiel starten anlegen (Mods+) – setzt Dauer, Ausschlüsse, Gewinner-Anzahl
3. Befehl Beitreten anlegen (z. B. !join oder !teilnehmen) – für Zuschauer
4. Im Panel: laufendes Gewinnspiel sehen, Teilnehmerliste, vorzeitig auslosen oder abbrechen
5. Nachlosung möglich – ausgeschlossene Gewinner, neue Ziehung

Bausteine: {join}, {duration}, {winners}, {reason} (Ausschluss-Grund).

B12. Würfel & Stufen (Killer)

Zuschauer würfeln 0–100 % in Stufen. Drei Befehle arbeiten zusammen:

Befehl	Wer?	Was passiert?
!streamstart	Mods+	Startet Stream-Logik für Uptime und „Einmal pro Stream“-Limits. Einmal am Stream-Anfang reicht.
!killer (Beispiel-Trigger)	Alle	Würfelt Prozentwert – typisch einmal pro Stream pro Person.
!killerliste	Alle	Zeigt alle Würfe dieses Streams gruppiert nach Stufen.

Die drei Stufen (Standard)

Prozent	Stufe	Beispiel-Text
0 %	Start / Eingeschult	wirst gerade eingeschult
1–49 %	Mittel / Schüler	solide Mittelstufe
50–100 %	Top / Lehrer	Top-Stufe – stark!

Stufen-Namen und Texte sind pro Befehl konfigurierbar (Schul-Thema optional).

Spitzenreiter & Tages-Rekord

Wer im Stream den höchsten Wert in der Top-Stufe würfelt, wird Spitzenreiter – der Bot hängt {schulleiter_suffix} an. Der Tages-Rekord gilt kalendertags über alle Streams hinweg bis Mitternacht.

Nochmal würfeln?

Bei „Einmal pro Stream“ würfelt der Bot nicht neu, sondern erinnert freundlich an den bestehenden Wert – das zählt als normale Bot-Antwort im Protokoll, kein Fehler.

Daten zurücksetzen

• Alles zurücksetzen – alle Würfe und Zähler (Tests)
• Nur dieser Stream – Stream-Würfe löschen, alle dürfen neu würfeln
• Nur Tages-Rekord – Rekord zurück, Stream-Würfe bleiben
Nach „Nur dieser Stream“ muss !streamstart erneut laufen – sonst blockiert „Einmal pro Stream“.

Öffentliches Board: {wtr_url} oder Link im Panel unter Community / Killer-Board.

B13. Watchtime

Menü Community → Watchtime. Trackt Chat-Anwesenheit pro Zuschauer – kein vollständiger Chat-Log.

Deploy-Schutz: Nach Bot-Neustart oder Deploy bleiben laufende Stream-Sessions für ca. STREAM_BOOT_GRACE_SEC Sekunden (Standard 120 s) erhalten – Watchtime-Timer und !streamstart werden nicht fälschlich beendet. Die Downtime wird der Session gutgeschrieben (bis max. 2 h). Community-Punkte aus Watchtime speichern Restsekunden über Neustarts hinweg.

Tabs im Panel

Tab	Inhalt
Leaderboard	Rangliste, Suche, manuelle Korrektur (+/− Zeit), Einträge löschen
Einstellungen	Tick-Intervall (1s / 1min / 10min), ignorierte Logins (Bots), Vergleichs-Sprüche (Gemini)
Import	StreamElements JWT, CSV (StreamLabs/SE), Vorschau vor Import

Chat-Befehle

• watchtime / watchtime_rank – eigene Zeit bzw. Platz (Trigger frei wählbar, z. B. !wt, !wtr)
• Bausteine: {watchtime}, {watchtime_detailed}, {rank}, {total_users}, Zeit-Anteile {hours} …
• Öffentliches Board: /watchtime?channel=LOGIN · OBS: /overlay/watchtime?channel=LOGIN&limit=10

StreamElements-Import

1. Bei StreamElements: JWT-Token kopieren (Account → API)
2. Im Tab Import einfügen → Token speichern
3. Vorschau prüfen → Alle Watchtime importieren
4. Bestehende Zeiten pro User werden überschrieben – vorher exportieren wenn nötig

Datenexport (Migration & Backup)

Vor dem Import oder beim Bot-Wechsel: Watchtime und andere Bot-Daten unter Kanal → Datenexport sichern — Details in Abschnitt 13c. Im Tab Import gibt es außerdem den Export des letzten Streams als CSV.

Gemini-Vergleichs-Sprüche (optional)

Beim Watchtime-Vergleich zweier User kurze KI-Sprüche – eigener Google-Gemini-API-Key im Panel, Modell wählbar. Ohne Key: statische Fallback-Texte.

Ignorierte Logins

StreamElements, Pokémon Community Game, eigener Bot etc. bekommen keine Watchtime. Der Kanal-Bot wird zusätzlich automatisch ignoriert.

B13b. Community-Punkte

Menü Community → Community-Punkte. Internes Punktesystem – nicht dasselbe wie Twitch-Kanalpunkte.

• Modul unter Module aktivieren (community_points)
• Punkte verdienen: Watchtime (Intervall im Panel, z. B. 1 Punkt alle 5 Min. – Watchtime-Modul muss aktiv sein) und/oder Chat-Nachrichten (Cooldown, optional nur live)
• Watchtime-Punkte sammeln Restsekunden zwischen; nach Deploy/Neustart geht der Fortschritt nicht verloren
• Befehle: points / points_rank – Trigger frei (Standard !punkte, !top)
• Bausteine: {points}, {currency}, {rank}, {total}
• Mods: !punkte give @user 100, take, set
• Panel: Rangliste durchsuchen, Punkte pro User bearbeiten (geben/nehmen/setzen), Sperren/Entsperren
• Öffentliches Board: /punkte?channel=LOGIN — Rangliste und Shop-Vorschau; Baustein {points_url}

Sperren

Im Panel kann der Streamer Zuschauer für Community-Punkte sperren (1h, 24h, 7 Tage oder permanent). Gesperrte User verdienen keine Punkte und erhalten bei !punkte, !top, !shop und !kaufen eine Hinweis-Nachricht. Mod-Anpassungen im Panel bleiben möglich.

Shop (optional)

Im Panel Shop aktivieren – dann zusätzlich:

• Artikel anlegen: ID, Titel, Kosten, Aktion (Chat, Sound über OBS aus eigener Bibliothek/Pool, oder nur Abzug)
• Befehle: points_shop / points_buy (Standard !shop, !kaufen sound1)
• Limits: pro Stream (gesamt), pro User (gesamt), pro User pro Stream, Cooldown – Einlösung wird im Punkte-Log gespeichert
• Bei Fehlern (z. B. Sound-URL fehlt) werden Punkte automatisch zurückerstattet
• Shop nur im Chat einlösbar — die öffentliche Seite zeigt Artikel und Preise zur Ansicht
• Export: Salden und Buchungsverlauf unter Kanal → Datenexport (Abschnitt 13c)

B13bb. Belohnungen

Menü Community → Belohnungen. Eigenes Rewards-Modul für Daily Login und einen Belohnungs-Katalog.

• Modul unter Module aktivieren (rewards)
• Daily Login: zwei Zähl-Modi im Panel — Stream-Streak (wie Twitch: ein ausgelassener Stream setzt zurück) oder Gesamt-Check-ins (jeder Check-in +1, reißt nie ab). Immer einmal pro Person pro Stream. Gespeichert werden Stream-Streak, längste Streak und kumulative Check-ins.
• Check-in-Wege (frei kombinierbar): Chat-Befehl (Trigger unter Bot → Befehle, z. B. !daily / !dailylogin) und/oder Twitch-Kanalpunkte-Einlösung — beide teilen sich denselben Check-in (1× pro Person pro Stream)
• Twitch optional: Zuschauer lösen eine Kanalpunkte-Belohnung ein — der Bot antwortet im Chat und zählt nur den Daily-Login-Zähler
• Ohne Community-Punkte: Der Daily Login ist vom Punktesystem entkoppelt — es gibt keine Punkte-Gutschrift und keine Einlösung über den Community-Shop
• Öffentliche Rangliste: zeigt je nach Modus aktuelle Streak + Rekord oder Check-ins gesamt; die eigene Position lässt sich per Suche finden
• Öffentliches Board: /daily?channel=LOGIN — Rangliste für Zuschauer; Link im Panel unter Belohnungen

B13c. Bot-Datenexport

Menü Kanal → Datenexport. Im Gegensatz zu vielen Mitbewerbern kannst du Zuschauer-Daten aus Streamheim einzeln als CSV oder gesamt als ZIP herunterladen — für Backup, Excel-Auswertung oder Wechsel zu anderen Bots.

Was kann exportiert werden?

Export	Inhalt	Formate
Watchtime (Gesamt)	Alle Zuschauer mit Watchtime, Rang	Streamheim-CSV, StreamElements (username;minutes), einfach (login;seconds)
Watchtime (letzter Stream)	Recap inkl. reiner Chat-Anwesenheit	CSV (auch unter Watchtime → Übernehmen)
Community-Punkte	Salden inkl. Lifetime earned/spent	CSV
Punkte-Verlauf	Buchungen aus dem Ledger (bis 50.000 Einträge)	CSV
Chat-Duell	Siege, Niederlagen, Runden gewonnen	CSV
Killer / Würfel	Rollen, Bestwerte, Schulleiter-Zähler	CSV (falls Modul genutzt)
Gesamt-Export	Alle vorhandenen Datensätze + README	ZIP

Technik & Hinweise

• CSV: Semikolon-Trennung, UTF-8 mit BOM (Excel-kompatibel)
• Auch deaktivierte Module werden exportiert, solange noch Daten in der Datenbank sind
• Jeder Export wird im Protokoll (Audit) vermerkt
• Berechtigung: Bot-Steuerung (Ansehen reicht für Download)
• Zurück nach Streamheim: Watchtime unter Community → Watchtime → Übernehmen
Datenschutz: Du lädst Zuschauer-Daten auf dein Gerät. Wenn du sie an andere Dienste weitergibst, informiere deine Community — Details in der Datenschutzerklärung (Abschnitt Bot-Datenexport).

B14. Chat-Duell

Menü Spiele → Chat-Duell. Schere-Stein-Papier-Echse-Spock (SSPS) im Chat – zwei Zuschauer duellieren im Best-of-Modus. Der Bot würfelt die Züge und wertet jede Runde aus.

Ablauf im Chat

1. !duell @Gegner — Spieler A fordert B heraus
2. B antwortet mit !duell (Annahme) oder !duell nein (Ablehnung)
3. Beide senden !zug — der Bot wählt pro Person zufällig einen Zug (kein Zugname nötig)
4. Wer zuerst die konfigurierte Rundenanzahl gewinnt, siegt im Match und erscheint in der Bestenliste

Befehl	Funktion
!duell @Gegner	Herausforderung senden
!duell	Herausforderung annehmen
!duell nein	Herausforderung ablehnen
!duell abbrechen	Eigene offene Herausforderung zurückziehen
!duell rang	Bestenliste im Chat anzeigen
!zug	Zug wählen — Bot würfelt aus Schere, Stein, Papier, Echse, Spock (Liste im Panel anpassbar)

Zeitlimits

Einstellung	Standard	Bedeutung
Herausforderung läuft ab	120 s	Gegner muss in dieser Zeit mit !duell antworten, sonst verfällt die Einladung
Zug-Timeout	90 s	Nach dem ersten !zug einer Runde muss der Gegner ebenfalls ziehen
Erinnerung nach	45 s	Bot erinnert den fehlenden Spieler noch einmal im Chat
Runden zum Sieg	3	Best-of-3 — im Panel 1–9 einstellbar

Zug-Timeout — faire Auswertung

Wenn ein Spieler nach der Erinnerung immer noch nicht !zug sendet, endet das Duell automatisch. Damit niemand absichtlich wartet und trotzdem gewinnt, gilt:

• Pünktlicher führt im Punktestand → er gewinnt das Match (Sieg in der Bestenliste)
• Unentschieden oder Langsamer führt → Duell endet ohne Sieger (kein Eintrag, kein Gewinn durch Timeout)

Beispiele bei Best-of-3: Stand 2:1, A hat gezogen, B nicht → A gewinnt. Stand 1:2, A wartet, B zieht nicht → Abbruch ohne Sieger.

Chat-Vorlagen: Alle Bot-Nachrichten (Herausforderung, Runde, Erinnerung, Timeout-Sieg, Timeout ohne Sieger, Sieg …) sind im Panel unter Einstellungen → Chat-Texte anpassbar. Bausteine u. a. {challenger}, {winner}, {missing}, {score_a}, {score_b}, {seconds_left}.

Panel-Funktionen

• Laufendes Duell live sehen, im Panel abbrechen (optional Chat-Hinweis)
• Trigger für Herausforderung und Zug frei wählen (z. B. !ssps statt !duell)
• Zugliste und Schlag-Regeln bearbeiten (Standard: SSPS)
• Chat-Vorlagen pro Ereignis mit Bausteinen
• Duell-Sperren im Modul – keine Twitch-Bans, nur Spielregeln für !duell
• Bestenliste + öffentliches Board: /duell?channel=LOGIN
• Reset der Rangliste mit optionalem Chat-Ankündigung
• Bestenliste exportieren: Kanal → Datenexport (Abschnitt 13c)

Wenn StreamElements oder ein anderer Bot ebenfalls auf !duell reagiert, dort das Duell-Modul deaktivieren oder im Panel einen anderen Trigger wählen.

B14b. Community-Build

Menü Community → Community-Build. Die Community baut im Chat ein gemeinsames Projekt — z. B. Sandburg, Blumenwiese oder Rieseneis. Ziel ist Zusammenhalt, kein Wettkampf: Es gibt keine öffentliche Rangliste und kein Einzel-Ranking im Chat.

Vorlagen & Start

1. Modul Community-Build unter Kanal → Module aktivieren
2. Im Panel eine Vorlage wählen oder Eigenes Projekt anlegen (Name, Emoji, Einheit, Trigger)
3. Mod startet mit !{steuer} start — z. B. !sandburg start
4. Chat hilft mit !{mitmach} — z. B. !bau, !giessen, !toppings

Vorlage	Steuer / Stand	Mitmachen	Einheit
🏖️ Sandburg	!sandburg · !sandburg start	!bau	Sandhände
🌼 Blumenwiese	!wiese · !wiese start	!giessen	Tropfen
🍦 Rieseneis	!eis · !eis start	!toppings	Toppings
✨ Eigenes Projekt	frei wählbar	frei wählbar	frei wählbar

Steuer- und Stand-Befehl dürfen gleich sein: !sandburg zeigt den Fortschritt, !sandburg start startet ein neues Projekt. Alle Trigger sind im Panel unter Chat-Befehle pro Vorlage anpassbar.

Befehle im Chat

Befehl	Wer?	Funktion
!{steuer} start	Mod (oder wie konfiguriert)	Neues Projekt starten
!{steuer} pause / stop / reset	Mod	Pausieren, beenden oder zurücksetzen
!{steuer}	Alle	Aktuellen Fortschritt anzeigen (eigener Cooldown)
!{mitmach}	Alle	Beitrag leisten — Erfolg per Zufall, Punkte variieren

Du musst keine eigenen Einträge unter Chat-Befehle anlegen — das Modul fängt die Trigger selbst ab (wie beim Chat-Duell).

Spielregeln (Panel)

• Ziel: Gesamtpunkte bis 100 % (Standard 2.000 Einheiten — anpassbar)
• Erfolgschance: Wahrscheinlichkeit, dass ein !{mitmach} Punkte bringt (Standard 40 %)
• Punkte pro Treffer: Mindest- und Höchstwert (z. B. 1–4 Sandhände)
• Cooldown: Abstand zwischen Mitmach-Versuchen pro Person
• Meilensteine: Chat-Hinweise bei 5 %, 10 %, … 100 %
• Stream offline: optional pausieren statt weiterlaufen lassen

Panel & Live-Vorschau

• Oben: Live-Karte mit Fortschritt, Status und Mitwirkenden-Zähler
• Texte für Start, Erfolg, Fehlschlag, Meilenstein, Fertigstellung und Status — mit Bausteinen aus der Gruppe Community-Build
• Bei aktivem oder pausiertem Build aktualisiert sich die Vorschau per Socket; sonst alle paar Sekunden per Abruf

Wenn ein anderer Bot auf dieselben Trigger reagiert, dort das Modul deaktivieren oder im Panel andere Trigger wählen.

B14e. Wartelisten

Menü Community → Wartelisten. Für Abende, an denen die Community mitspielt: Es können mehrere Listen gleichzeitig offen sein — je Spiel eine. Wer bei Fall Guys und bei Among Us dabei sein will, trägt sich in beide ein; du nimmst die nächste Runde im Panel dran, und der Bot sagt im Chat an, wer los darf.

Einrichten

1. Modul Wartelisten unter Kanal → Module einschalten
2. Im Panel ein Spiel suchen — Name, Bild und Chat-Wort entstehen daraus — oder einen eigenen Namen eingeben
3. Optional Plätze begrenzen (0 = so viele wie kommen)
4. Die Liste mit dem Schalter aufmachen — erst dann nimmt sie jemanden auf

Befehle im Chat

Befehl	Wer?	Funktion
!mitspielen <Wort>	Alle	Eintragen, z. B. !mitspielen fallguys. Ist nur eine Liste offen, reicht !mitspielen; sind mehrere offen, fragt der Bot nach. Was dahinter steht, wird als kurzer Zusatz übernommen
!joinfg (frei wählbar)	Alle	Eigenes Wort je Liste. Trägt sofort in genau diese Liste ein, ohne Zusatz — praktisch für einen Community-Abend: !joinfg für Fall Guys, !joinpa für Party Animals. Im Panel je Liste einstellbar, leer heißt „nur über den Sammelbefehl"
!raus · !raus <Wort>	Alle	Ohne Zusatz von allen Listen runter, mit Zusatz nur von dieser
!warteliste	Alle	Übersicht aller Listen mit Anzahl; geschlossene mit Schloss
!warteliste <Wort>	Alle	Eine Liste mit den Namen in ihrer Reihenfolge
!platz	Alle	Wo man selbst gerade steht — über alle Listen hinweg
!warteliste auf|zu <Wort>	Mod	Liste öffnen oder schließen
!warteliste nächster <Wort> [Anzahl]	Mod	Die vordersten dran nehmen; sie kommen von der Liste und werden angesagt
!warteliste leeren <Wort>	Mod	Alle Namen dieser Liste streichen, die Liste bleibt

Das Wort je Liste entsteht aus dem Namen („Fall Guys" wird fallguys) und ist im Panel änderbar. Steuerwörter wie zu oder leeren sind dafür gesperrt — sonst wäre nicht zu unterscheiden, ob jemand eine Liste meint oder einen Befehl. Die vier Befehle selbst stehen wie gewohnt unter Bot → Befehle (Modul: Wartelisten) und sind dort umbenennbar.

Öffentliche Seite

Jede Liste hat im Panel den Schalter „Auf der Kanalseite zeigen" (Vorgabe: an). Freigegebene Listen stehen unter /c/<name>/warteliste und erscheinen als Bereich auf deiner Kanalseite. Dort können Zuschauer

• ohne Anmeldung sehen, wer eingetragen ist und wie voll es ist,
• sich mit Twitch anmelden und selbst eintragen bzw. wieder austragen.

Für Betreiber: In der Twitch-App müssen die Rückkehradressen der Kanalseiten eingetragen sein — https://www.streamheim.de/api/zuschauer/callback und dieselbe ohne www. Fehlt die passende, scheitert Twitch nicht, sondern nimmt die erste registrierte Adresse; die Anmeldung landet dann beim Tauschmarkt statt auf der Kanalseite.

Die Anmeldung fordert keine Berechtigungen an — nur Name und Kennung, damit die Liste weiß, wer eingetragen wird. Sie gilt nur für die Kanalseiten, nicht fürs Panel. Auf der Seite stehen Anzeigename, Platz, Zeitpunkt und der Zusatz aus dem Chat; der Twitch-Login und die Liste „wer war zuletzt dran" bleiben im Panel. Eine Liste, die du nicht freigibst (z. B. eine Mod-Runde), taucht dort nicht auf — auch nicht über eine geratene Adresse.

Panel

• Jede Liste als Karte: offen/zu, Plätze, Teilnehmer in der Reihenfolge, wer zuletzt dran war. Jede Karte speichert sich selbst — unter den Feldern steht eine Zeile mit Speichern und Verwerfen. Beide sind ausgegraut, solange nichts geändert ist, und werden aktiv, sobald du etwas eintippst; nach dem Speichern steht dort kurz „✓ Gespeichert". Kein Scrollen ans Seitenende, und was ein Mod parallel an einer anderen Liste ändert, wird dabei nicht überschrieben. Der Knopf unten speichert nur noch die Einstellungen und Chat-Texte
• Dran nehmen mit frei wählbarer Anzahl — z. B. vier auf einmal für eine Lobby
• Du entscheidest, wer mitspielen darf. An jeder Person stehen drei Knöpfe:
  • ✓ zulassen — die Person bleibt auf der Liste und ist als zugelassen markiert, im Panel und auf der Kanalseite („✓ dabei"). Nochmal klicken nimmt die Zulassung zurück
  • ✕ ablehnen — darf nicht mitspielen, kommt von der Liste und steht mit Vermerk im Verlauf
  • 🗑 — ohne Vermerk weg (Tippfehler, versehentlich eingetragen)
  Wer noch keinen Haken hat, sieht auf der Kanalseite „warte auf Freigabe". Auf Wunsch sagt der Bot eine Zulassung im Chat an (Schalter in den Einstellungen, Vorgabe aus — bei dreißig Anmeldungen wären es dreißig Zeilen). Ablehnungen werden nie angesagt — das wäre eine Bloßstellung
• Am Stream-Ende einstellbar: Listen schließen (Vorgabe), schließen und leeren, oder nichts tun
• Eintragungen von der Kanalseite im Chat ansagen (Vorgabe: an) — wer sich im Chat einträgt, bekommt dort ohnehin eine Antwort; über die Seite passiert im Stream sonst gar nichts. Aus heißt: keine Ansage, damit dreißig Anmeldungen nicht dreißig Zeilen schreiben. Abgesagt wird nie angesagt (voll, schon drin) — das sieht nur die Person auf der Seite
• Alle Chat-Texte sind Vorlagen mit Bausteinen aus der Gruppe Wartelisten

B14f. Zitate

Menü Bot → Zitate. Sätze aus dem Stream, die nicht vergessen werden sollen: Mods speichern sie im Chat, alle holen sie mit einem Befehl wieder hervor. Die Sammlung gehört nur deinem Kanal, und jede Nummer bleibt für immer dieselbe — #42 ist auch nach dem Löschen anderer Zitate noch #42.

Einrichten

1. Modul Zitate unter Kanal → Module einschalten — dabei entstehen !zitat und !quote
2. Unter Bot → Zitate einstellen, wer speichern darf (Vorgabe: Mods)
3. Einen Stil für die Anzeige wählen; die Vorschau zeigt, wie es im Chat aussieht
4. Wer umzieht: die alte Sammlung unter Zitate übernehmen hochladen

Befehle im Chat

Befehl	Wer?	Funktion
!zitat	Alle	Ein zufälliges Zitat — die zuletzt gezeigten kommen nicht gleich wieder
!zitat 42	Alle	Zitat Nummer 42
!zitat <Wort>	Alle	Ein Zitat, in dem das Wort vorkommt (im Text, bei der Person oder im Spiel)
!zitat add <Text>	Mod (einstellbar)	Speichern. "Text" - Name am Ende trennt die Person ab; das live gespielte Spiel merkt sich der Bot. Gibt es den Satz schon, nennt der Bot dessen Nummer
!zitat edit 42 <Text>	Mod	Text ändern, die Nummer bleibt
!zitat del 42	Mod	Löschen — im Panel aus dem Papierkorb wiederherstellbar

!quote tut dasselbe wie !zitat — das gewohnte Wort aus Mix It Up. Beide stehen unter Bot → Befehle (Modul: Zitate) und lassen sich dort umbenennen, löschen oder um weitere Wörter ergänzen (Befehlstyp „Zitate“).

Auch die Wörter hinter dem Befehl sind deine: Unter Bot → Zitate → Wörter hinter dem Befehl stellst du ein, womit gespeichert, geändert und gelöscht wird — etwa plus statt add. Mehrere mit Komma trennen; das erste nennt der Bot in seinen Texten. Die Tabelle oben zeigt die Vorgaben.

Aussehen

Twitch-Chat kennt keine Formatierung — kein Fett, keine Farben. Was geht, sind Emojis und Anführungszeichen. Fünf Stile dienen als Ausgangspunkt (Klassisch, Elegant, Verspielt, Schlicht, wie bei Mix It Up, mit Uhrzeit). Bausteine wie {von_teil} oder {spiel_teil} bringen ihren Trenner selbst mit und bleiben leer, wenn nichts bekannt ist. Die Uhrzeit ({uhrzeit}, {datum_uhrzeit_teil}) erscheint nur, wenn sie bekannt ist — bei übernommenen Zitaten, deren Datei nur ein Datum hatte, bleibt sie weg.

Übernehmen aus Mix It Up und anderen Quellen

In Mix It Up unter Zitate exportieren und die Datei im Panel ablegen. Gelesen werden auch CSV-Tabellen mit Kopfzeile (Excel, Google Tabellen), JSON und einfache Listen mit einem Zitat pro Zeile. Vor dem Speichern zeigt eine Vorschau, wie die Datei gelesen wurde und was übersprungen wird. Nummern aus der Datei bleiben erhalten, wo sie frei sind. Mit Als Datei sichern nimmst du die Sammlung jederzeit mit.

B14c. Galgenmännchen

Menü Spiele → Galgenmännchen. Die Community rät gemeinsam ein Wort oder eine Phrase. Start nur im Panel (nie per Chat-Befehl – sonst wäre das Wort spoilernd). Leben sind geteilt; wer das ganze Wort zuerst trifft, gewinnt.

Ablauf

1. Im Panel eigenes Wort oder Zufallswort starten – Bot kündigt maskiert an
2. Chat rät: !rate A (Buchstabe) oder !rate Wort (Volltreffer)
3. Falscher Buchstabe oder falsches Wort → +1 gemeinsamer Fehler
4. Schon geratener Buchstabe → Hinweis, kein Fehler (Antworten drosselbar)
5. Leben leer → Wort wird aufgelöst; Panel kann jederzeit abbrechen

Bestenliste

Siege werden getrennt gezählt: Buchstaben = der letzte korrekte Buchstabe füllt die Maske (kein Wort-Volltreffer nötig) und Wort = Volltreffer per !rate Wort. Rang nach Gesamt; bei Gleichstand zählen mehr Wort-Siege. In Panel und Board erscheint zusätzlich das{' '} zuletzt gelöste Wort. Eine Legende auf der öffentlichen Seite erklärt die Spalten.

• Chat: !rate rang (oder bestenliste / top)
• Öffentliches Board: /c/<slug>/galgen (Portal-Form wie Watchtime)
• Panel: Top-10, Reset, Link zur öffentlichen Seite

Blind-Start (Mitspielen)

Unter Zufallswort wählt der Bot ein Wort. Standard ist die Streamheim-Standardliste (mitgeliefert, im Panel einsehbar) — das ist keine eigene Liste. Optional legst du unter Einstellungen eigene Wortlisten an. Die Lösung erscheint nicht im Panel — Streamerin und Mods können im Chat mitraten. Kürzlich genutzte Wörter werden optional vermieden.

Chat-Spam & OBS

• Treffer/Falsch-Ankündigungen drosselbar (jeden Tipp / Meilensteine / nur Overlay)
• OBS-Browser-Quelle: /overlay/hangman?channel=… — Maske, Leben, geratene Buchstaben

Befehl	Funktion
!rate Buchstabe	Einen Buchstaben raten (Trigger im Panel änderbar)
!rate Wort	Ganzes Wort / Phrase raten – Treffer = Wort-Sieg
!rate rang	Top-5 der Bestenliste im Chat

Panel: Trigger, max. Fehler (3–12), Chat-Texte mit Bausteinen ({mask}, {wrong}, {guess_trigger}, {word}, {author} …). Eigene Texte für richtig, Buchstabe falsch und Wort falsch (z. B. „ney falsch“). Live-Stand auch unter Live jetzt inkl. Abbruch.

B14d. Chat-Safari

Menü Spiele → Chat-Safari. Während des Streams taucht in zufälligem Abstand eine Kreatur im Chat auf. Wer mitjagt, hat eine Chance sie zu fangen und füllt seine Sammlung. Das Modul ist standardmäßig aus.

Kein Wettrennen

Die Kreatur bleibt ein Fenster lang (Standard 45 Sekunden). Wer in dieser Zeit !jagen schreibt, ist dabei — die Reihenfolge ist egal. Danach wird für jede Person einzeln gewürfelt. Mehrere können dieselbe Kreatur fangen, es gibt nichts wegzuschnappen. Mehrfach tippen bringt nichts.

Seltenheitsstufen

Stufe	Taucht auf	Fang-Chance	Punkte
🌿 Häufig	Gewicht 60	90 %	5
✨ Ungewöhnlich	Gewicht 25	60 %	15
💎 Selten	Gewicht 12	30 %	50
🔮 Episch	Gewicht 6	20 %	100
🌟 Legendär	Gewicht 3	10 %	250

Das Gewicht gilt je Kreatur: Zwanzig häufige Arten teilen sich also nicht 60 %, sondern bringen jede das Gewicht 60 mit. Wer möchte, dass Seltenes auch selten wirkt, sollte nicht fast alles auf „Häufig“ stehen lassen.

Kreaturen verwalten

• Drei fertige Sets zum Anlegen: Wald & Wiese, Tiefsee, Fantasy
• Eigene Kreaturen ergänzen; Name, Seltenheit und Artikel jederzeit änderbar
• Artikel (der/die/das) sorgt für richtiges Deutsch: „Eine Waldmaus taucht auf … fängt die Waldmaus“
• Einzelne Arten abschalten statt löschen — gefangene Exemplare bleiben erhalten
• Zwei Bilder je Kreatur (Tier und Sondervariante) direkt in der Tabelle hochladen
• Kurzbeschreibung (300 Zeichen) — erscheint im öffentlichen Sammelalbum
Namen ohne gebeugtes Adjektiv wählen. Aus „gefleckter Stinkkäfer“ wird im Chat „fängt den gefleckter Stinkkäfer“. Die deutsche Adjektivbeugung bildet der Bot nicht nach — „Fleckenstinkkäfer“ o. ä. umgeht das.

Sondervariante (Standard: Plüschi 🧸)

Nach einer erfolgreichen Jagd zieht der Bot manchmal eine der Fängerinnen und gibt ihr zusätzlich die Sondervariante der Kreatur. Höchstens eine pro Runde, nur unter den Fängern, und es gibt keine Punkte dafür — reines Angeberstück. Damit bekommt die Sammlung eine zweite, deutlich schwerere Reihe. Chance einstellbar (Standard 15 % je Runde mit mindestens einem Fang).

Wie sie heißt, bestimmst du. Plüschi ist nur die Vorgabe — Statue, Abbild oder Schatten geht genauso. Einzahl, Mehrzahl und Symbol stehen getrennt im Panel, weil sich die Mehrzahl im Deutschen nicht ableiten lässt (Statue → Statuen, Abbild → Abbilder).

Öffentliches Sammelalbum

Unter /c/<slug>/safari gibt es alle Arten als Sammelkarten, nach Seltenheit gruppiert. Zuschauer tragen ihren Twitch-Namen ein und sehen ihren eigenen Stand — ohne Anmeldung, der Name wird im Browser gemerkt. Gefangene Arten erscheinen farbig, fehlende als Silhouette mit Fragezeichen. Ein Klick auf eine Karte zeigt beide Varianten nebeneinander samt Beschreibung. !sammlung verlinkt direkt auf die eigene Ansicht.

Ruhe im Chat

• Kreaturen erscheinen nur bei laufendem Stream
• Abstand zufällig zwischen Minimum und Maximum (Standard 8–20 Minuten)
• Zuletzt gezogene Arten werden kurz ausgespart, damit sich nichts direkt wiederholt
• Ein Neustart des Bots verschiebt den Termin nicht — er steht in der Datenbank

Befehl	Funktion
!jagen	An der laufenden Runde teilnehmen (Trigger im Panel änderbar)
!sammlung	Eigener Stand: Arten, Plüschis, Fänge und was noch fehlt

Panel: Countdown bis zur nächsten Kreatur, Knopf „Jetzt auftauchen lassen“ (auch außerhalb des Streams, zum Testen), Rangliste der größten Sammlungen. Jede Runde landet mit Kreatur, Fängern und Danebengreifern im Protokoll.

B15. Shoutout, Sound, Begrüßungen & Lurk

Shoutout (!so Name)

Mods empfehlen andere Streamer. Der Bot holt Anzeigename und zuletzt gespieltes Spiel von Twitch (Broadcaster-OAuth nötig). Bausteine: {streamer}, {game_played}, {streamer_login}.

Sound-Overlay & Sound-Bibliothek

Sounds laufen in OBS (Browser-Quelle), nicht auf dem PC der Zuschauer. Einmal einrichten, danach per Chat-Befehl oder Community-Punkte-Shop auslösen.

1. OBS: Browser-Quelle mit URL aus Bot → Sounds oder Glücksrad → OBS Browser-Quellen (/overlay/sound?channel=LOGIN), Hintergrund transparent.
2. Audio wählen: Unter Bot → Sounds hochladen, aus dem Streamheim-Pool (von anderen Mandanten freigegeben) wählen oder im Befehl eine externe https://-URL eintragen.
3. Chat-Befehl vom Typ Sound anlegen (Menü Chat-Befehle) — Sound zuweisen, Lautstärke 0–1, Chat-Antwort optional (leer = nur Sound).

Eigene Bibliothek (pro Mandant)

• Menü Bot → Sounds — Upload vom PC (kein eigener Webspace nötig)
• Kategorien: Sound-Schnipsel (kurze Effekte, max. 3 MB) und Musik (längere Tracks, max. 8 MB) — erleichtert Sortierung im Pool
• Anhören, Kategorie ändern, löschen

Streamheim-Pool (optional, plattformweit)

• Haken „Für alle Streamheim-Mandanten freigeben“ beim Upload oder bei jedem eigenen Sound — erscheint dann im Pool für alle eingeloggten Mandanten im Panel (nicht öffentlich im Internet)
• Nur freigeben, wenn du die Rechte hast (eigene Aufnahme, Lizenz, freie Nutzung); Freigabe jederzeit widerrufbar
• Pool filterbar nach Kategorie (Schnipsel / Musik) und sortierbar (Name, Streamer, neu)
• Im Befehl-Dialog: Quelle Eigene · Streamheim-Pool · Externe URL

Community-Punkte-Shop

Shop-Artikel können als Aktion Sound (OBS) einen Eintrag aus eigener Bibliothek oder Pool nutzen — gleiche OBS-Quelle nötig.

Chat-Begrüßungen

Unter Live-Steuerung: automatische Nachrichten bei Follow, Sub, Gift, Prime, Erstem Chat im Stream sowie wenn jemand die Zuschauerserie im Chat teilt (z. B. „3-Streams-Serie“). Vorlagen mit Bausteinen – kein manueller !-Befehl nötig.

Ereignis	Bausteine	Hinweis
Erstchat, Follow, Sub …	{author}, {recipient}, {months}, {gift_count}	{user} = Alias für Autor
Zuschauerserie geteilt	{author}, {streak}, {channel_points}	EventSub channel.chat.notification – Bot braucht user:read:chat, nur wenn der Zuschauer aktiv teilt

Lurk

Klassischer Lurk-Modus unter Live-Steuerung (Modul Lurk): Zuschauer melden sich ab – der Bot speichert das. Schreibt die Person danach wieder, kommt automatisch „Willkommen zurück“. Trigger und Chat-Texte sind frei wählbar unter Bot → Befehle (Standard !lurk / !unlurk, z. B. auch !afk / !back). Bei Stream-Ende können alle Lurk-Status geleert werden.

B16. Live jetzt

Menü Start → Live jetzt – zentrale Ops-Fläche während des Streams. Panel-Recht: Live jetzt & Steuerung (bot_controls). Schnell senden / Freitext braucht zusätzlich Chat als Bot (bot_chat) – Standard nur Streamerin, Leitende Mods nur nach Freigabe in Rechte & Rollen. Auf dem Dashboard gibt es einen kurzen Teaser mit Link hierher.

• Stream – live/offline, Zuschauer, Titel/Spiel
• Stream-Timer – Uptime, Start/Stop (wenn Modul aktiv)
• Lurk – Namen der aktiven Lurker, alle löschen
• Sounds – Now Playing + Warteschlange (Skip/Leeren), solange die OBS-Browser-Quelle offen ist
• Gewinnspiel – Status + Link zur Auslosungsseite
• Chat-Duell – offene Herausforderung oder laufendes Match live (Score/Runde), Abbrechen mit Chat-Hinweis
• Galgenmännchen – Maske, Fehlerstand, Abbrechen; Start unter Spiele → Galgenmännchen
• Schnell senden – Vorlagen und Freitext (Recht bot_chat)

Einstellungen (Texte, Intervalle, Lurk-Vorlagen, Sound-Bibliothek) bleiben unter Live-Steuerung bzw. den Modul-Seiten – hier nur Ops.

B16b. Live-Steuerung

Menü Bot → Live-Steuerung – Einstellungen und Vorlagen. Panel-Recht: Live jetzt & Steuerung (bot_controls). Module hier: Stream-Timer, Auto-Streamstart, Chat-Begrüßungen, Lurk. „In Chat senden“ bei Schnell-Nachrichten braucht bot_chat. Für den laufenden Stream besser Live jetzt nutzen.

Stream-Aktionen (Panel-Buttons)

• Stream starten / stoppen – wie !streamstart / !streamstop
• Countdown – Dauer eingeben (z. B. 5m), Updates im Chat
• Uptime anzeigen – sofortige Chat-Antwort

Schnell-Nachrichten

Vordefinierte Texte mit einem Klick in den Chat – z. B. „Pause“, „Technik-Problem“, Social-Link. Mit Bausteinen editierbar.

Timer-Nachrichten

Eigene Seite im Menü: Timer-Nachrichten (früher „Automatische Nachrichten“ in der Live-Steuerung).

• Intervall per Knopf (5, 10, 15, 30 Min., 1 oder 2 Std.) oder eigene Zeit von 30 Sekunden bis 24 Stunden, dazu Text-Vorlage und ein/aus je Nachricht
• Ein Schalter Timer läuft / pausiert für alle Nachrichten zusammen
• Option nur senden, wenn der Stream läuft – wartet auf !streamstart
• Balken und „nächste in …“ je Nachricht live im Panel

Auto-Streamstart

Eigene Start-/Stop-Befehle bei Twitch live/offline – Trigger und Antwort-Vorlagen pro Kanal.

Chat-Begrüßungen

Follow, Sub, Gift, Prime, Erstchat, geteilte Zuschauerserie – je Ereignis eigene Vorlage, Modul Chat-Begrüßungen muss aktiv sein. Für Zuschauerserien: EventSub aktiv, Bot mit Berechtigung user:read:chat (unter Setup neu verbinden, falls nötig).

Lurk

Zuschauer melden sich ab und werden begrüßt, wenn sie wieder schreiben. Trigger frei wählbar unter Bot → Befehle (Standard !lurk / !unlurk). Modul und Willkommen-zurück-Text unter Live-Steuerung.

B17. Stream-Timer, OBS & Overlays

Stream-Timer-Befehle

Befehl	Funktion
!streamstart	Startet Uptime und Stream-Zähler
!streamstop	Beendet Stream-Logik, optional Zusammenfassung
!uptime	Zeigt aktuelle Laufzeit
!countdown 5m	Countdown starten – Updates automatisch im Chat
!countdown stop	Countdown abbrechen

Auto-Streamstart

Start- und Stop-Befehle werden automatisch ausgeführt, wenn Twitch live/offline meldet – eigene Trigger pro Kanal in Live-Steuerung konfigurierbar.

OBS-Szenen-Timer (Menü OBS-Timer)

Countdown-Uhren in OBS – je Timer eigene Browser-Quelle-URL.

Feature	Details
Timer-Aktionen	Zeit +/−, setzen, Start, Pause, Reset
Event-Trigger	Follow, Sub (T1–T3), Gift Sub, Raid, Kanalpunkte
Chat-Befehl	Standard !zeit – konfigurierbar
OBS-WebSocket	Verbindung im Setup für Szenen-Wechsel optional

Overlay-URLs (Setup → OBS Browser-Quellen)

Overlay	URL
Glücksrad	/overlay?channel=LOGIN
Sound	/overlay/sound?channel=LOGIN
Watchtime Top-10	/overlay/watchtime?channel=LOGIN&limit=10
Galgenmännchen	/overlay/hangman?channel=LOGIN
Szenen-Timer	/overlay/timer?channel=LOGIN&id=TIMER_ID (pro Timer)
Watchtime-Board	/watchtime?channel=LOGIN
Würfel-Board	/killer?channel=LOGIN
Duell-Board	/duell?channel=LOGIN
Daily-Login-Board	/daily?channel=LOGIN (Streak- oder Check-in-Rangliste je nach Modus)
Streamplan	/c/SLUG/schedule bzw. /schedule?channel=LOGIN
Community-Punkte	/punkte?channel=LOGIN (Rangliste + Shop-Vorschau)
Stream-Alerts	/overlay/alerts?channel=LOGIN
Stream-Outro	/overlay/outro?channel=LOGIN

Als Browser-Quelle in OBS – Hintergrund transparent, empfohlene Größe steht unter jeder URL im Panel.

B17b. Stream-Alerts

Menü Overlays → Stream-Alerts. Einblendungen im Stream bei Follow, Abo, Resub, Prime, Gift-Sub, Raid und Bits — mit eigenem Bild, Sound und Text. Standardmäßig aus.

• Je Ereignis eigene Einstellungen — Text, Medien und Effekte können vom Standard abweichen
• Animationen beim Einblenden (Fade, Pop, Bounce, Zoom, Slide, Drop, Flip, Swing, Blur, Tada) und beim Ausblenden
• Text-Effekte — wortweise oder als Schreibmaschine einlaufend, Name hervorhebbar
• Bild-Bewegung (schweben, pulsieren, wackeln, drehen) und Anordnung (über, links, rechts, hinter dem Text)
• Alerts laufen in einer Warteschlange — mehrere Ereignisse überlagern sich nicht

Eigene Bilder und Sounds werden im Panel hochgeladen. OBS-Browser-Quelle: /overlay/alerts?channel=LOGIN. Nach Änderungen die Quelle in OBS neu laden, sonst läuft dort noch die alte Fassung.

B17c. Stream-Outro

Menü Stream → Stream-Outro. Die Endkarte für die Outro-Szene: Was in diesem Stream passiert ist, als Overlay — Karte für Karte. Standardmäßig aus.

Karte	Inhalt
👋 Begrüßung	Stream-Zeit und Zuschauer-Höchststand
💜 Neue Follower	Anzahl, auf Wunsch mit Namen
⭐ Abos & Gifts	inklusive verschenkter Abos
🚀 Raids	wer kam, mit wie vielen Leuten
💎 Bits	Summe der Bits im Stream
🎲 Würfel-Ergebnis	mit eigenem Titel
🦊 Chat-Safari	Fänge des Streams, seltenster Fund, Jäger
⏰ Top-Zuschauer	Podium aus der Watchtime
🙌 Danke-Liste	alle Zuschauer, durchlaufend
📈 Vergleich	Unterschied zum letzten Stream
💫 Abschied	eigener Schlusssatz

Karten ohne Inhalt werden übersprungen — bei einem ruhigen Stream bleiben nur Begrüßung und Abschied. Sekunden pro Karte und Wiederholung sind einstellbar, dazu zwei Designs. OBS-Browser-Quelle: /overlay/outro?channel=LOGIN.

Wichtig: Das Outro rechnet gegen den laufenden Stream. Solange !streamstop nicht gelaufen ist, zeigt es die Zahlen der aktuellen Sitzung — genau so ist es gedacht, denn die Endkarte läuft ja noch im Stream.

B18. Stream-Statistik (Recap)

Menü Stream → Stream-Statistik – Auswertung pro abgeschlossenem Stream.

• Watchtime-Podium – Top-3 Zuschauer des Streams
• Top-Befehle – meistgenutzte !-Befehle mit Zähler
• Würfel-Highlights – Würfe, Spitzenreiter, beste Werte
• Spiel-Segmente – Kategorie-Wechsel alle 5 Min. (Twitch Helix, ab nächstem Stream)
• Trends – Vergleich zu vorherigen Streams (Streams/Woche, Ø-Zuschauer …)

B19. Community & Streamer-Verzeichnis

Im Dashboard (Bereich Community & Sichtbarkeit) – wenn Modul Watchtime oder Würfel aktiv.

Community-Boards

Automatische Links für Chat und Socials – Watchtime-, Würfel-, Duell-, Daily-Login- und Community-Punkte-Board je nach aktiven Modulen. URLs kopierbar.

Streamer-Verzeichnis (freiwillig)

1. Schalter Gelistet aktivieren
2. Banner hochladen (max. 2 MB, JPEG/PNG/WebP/GIF)
3. Kurzbeschreibung (max. 500 Zeichen), Lieblingsspiele (IGDB-Suche), Social-Links
4. Speichern → Profil unter /c/DEIN_LOGIN und in /streamer

Opt-out jederzeit – kein Listing ohne aktiven Schalter. Aktionen erscheinen im Protokoll (Panel).

Auszeichnungen (vom Plattform-Inhaber)

Der Plattform-Inhaber kann Mandanten freiwillige Labels mit Bild und Text zuweisen (z. B. „Mandant der ersten Stunde“, „Streamheim-Verdienste“). Du als Streamer legst diese nicht selbst fest — sie werden dir im Owner-Panel zugeordnet.

• Sichtbar nur, wenn dein Kanal im Verzeichnis opt-in ist (/streamer, /c/DEIN_LOGIN)
• Anzeige als hervorgehobene Badges auf der Profilkarte und in der Streamer-Liste; Besucher können nach Auszeichnung filtern
• Enthalten: Bezeichnung, optional Kurzbeschreibung (Tooltip), optional Icon/Bild (vom Inhaber hochgeladen)
• Kein Einfluss auf Bot-Rechte oder Modul-Funktionen — reine Hervorhebung in der Community-Ansicht

Details zur Datenverarbeitung: Datenschutzerklärung (Abschnitt Streamer-Verzeichnis).

B19b. Streamplan

Menü Stream → Streamplan (/admin/bot/streamplan). Hier trägst du ein, wann du streamst — als Einzeltermin oder wöchentliche Serie. Modul Streamplan zuvor unter Kanal → Module aktivieren (plattformweit kann Streamheim das Modul in Wartung setzen).

Termine anlegen & verwalten

• Wöchentlich mit mehreren Wochentagen in einem Termin (z. B. Mo + Mi + Fr) und optionalem Wiederhol-Ende („wiederholen bis …“)
• Über Nacht & Mehrtages: 20:00 → 06:00 oder 24h/48h-Streams werden über alle betroffenen Tage angezeigt
• Spiele aus der Twitch-/IGDB-Datenbank (Cover & Infos); Showcase-Spiele als Schnellvorschläge; optional mit einem Klick ins Showcase-Profil übernehmen
• Besonderer Stream hervorheben (Event, Geburtstag, 24h-Marathon): Symbol + freies Label, leuchtend auf dem Board
• Partnerstream: Twitch-Namen eintragen. Ist der Partner bei Streamheim, verlinkt „Partnerstream mit X“ auf sein Profil und er bekommt eine Einladung, den Termin in seinen eigenen Plan zu übernehmen; sonst wird auf seinen Twitch-Kanal verlinkt
• Kalender in Woche oder Monat. Termine per Drag & Drop auf einen anderen Tag ziehen (bei Serien fragt ein Menü „nur diese Woche“ oder „ganze Serie“), auf einen Tag klicken → dort anlegen
• Das ⋯-Menü auf jeder Karte bündelt: Bearbeiten, Verschieben (nur diese Ausgabe auf eine andere Zeit), Absagen/Absage zurücknehmen und ganze Serie löschen

Öffentliches Board & Kalender-Abo

• Öffentliches Board: /c/DEIN_SLUG/schedule (wie Watchtime/Punkte), Fallback /schedule?channel=DEIN_LOGIN — Timeline mit „Heute“-Marker
• Live-Status: „Jetzt live“ (mit rotem Live-Punkt), wenn du sendest, sonst „beginnt in …“ für den nächsten Stream
• Klick auf einen Termin öffnet ein Detail-Panel inkl. „zu diesem Termin in den Kalender“
• Kalender abonnieren: Zuschauer holen sich deinen Plan per Klick in Google/Apple Calendar (webcal) oder laden eine .ics. Änderungen kommen beim nächsten Abgleich automatisch nach; Absagen verschwinden

Im Chat: !plan

Unter Bot → Befehle einen Befehl mit Typ „Nächster Stream (Streamplan)“ anlegen (Trigger frei, z. B. plan). Er postet den nächsten geplanten Stream — online wie offline; steht nichts an, meldet der Bot das automatisch.

• Platzhalter: {plan} (fertiger Satz), {plan_when}, {plan_game}, {plan_title}, {plan_url}, {plan_emoji}, {plan_label}, {plan_partner}
• Board-Link als Chat-Baustein überall: {schedule_url}

Termine ohne Spiel sind möglich. Die Spielesuche braucht die Twitch-App (IGDB) auf dem Server. Ein einzeln verschobener oder abgesagter Serien-Termin ändert nur diese Ausgabe, nicht die Serie.

B20. Multistream & Shared Chat

Menü Setup → Multistream – nur bei zwei Mandanten im Panel oder Spiegel-Kanal.

Modus	Verhalten
Einzel-Chat	Bot antwortet nur in deinem Kanal (Standard)
Haupt-Chat	Bei Multistream: Bot antwortet hier, nicht im Zweitkanal
Spiegel-Kanal	Bot antwortet nur im gewählten Haupt-Chat, nicht hier

Bei Twitch Shared Chat (ein Chat, mehrere Streamer) gilt standardmäßig nur dein Kanal. Ohne chat:edit-Scope können Antworten kurzzeitig in allen Chats sichtbar sein – Setup-Hinweis beachten, OAuth erneuern.

B21. Discord: Alarme & Community-Server

Menü Setup → Discord (wenn der Plattform-Inhaber Discord-Community aktiviert hat).

Bot-Watch per DM (persönlich)

1. Bot zum Discord-Server einladen (Link im Panel, falls nötig)
2. Link-Code erzeugen → in Discord: /link CODE
3. Abonnenten erhalten persönliche Alarme nur für diesen Kanal (/botstatus, /abos)

Alarm-Typen (Bot offline, Token abgelaufen …) konfiguriert der Inhaber unter Plattform → Bot-Alarme.

Community-Server (optional)

Im Panel kannst du der Streamheim-Community auf Discord beitreten:

• Community beitreten – Einladungslink aus dem Panel
• Live-Ankündigung – optional: bei stream.online Post in #live
• Support-Ticket – privater Kanal oder /ticket open betreff:…
• Nach /link erhältst du automatisch die Rolle @Streamer

Plattform-News (Rundmail) können zusätzlich einmal in #rundschreiben erscheinen — parallel zur E-Mail, nicht stattdessen.

B22. Protokoll & Mandanten-Audit

Unter Protokoll siehst du dauerhaft gespeicherte Ereignisse für deinen Kanal.

Die Kategorien

Zähler / Filter	Was zählt?
Auslosungen	Glücksrad-Drehungen
Befehle	Erfolgreiche Chat-Befehle inkl. Bot-Antwort
Panel	Panel-Aktionen, DSGVO-Zuordnungen (🔒), Timer, Countdown
Gewinnspiele	Start, Auslosung, Nachlosung

Symbole in der Liste

Symbol	Art
🎡	Glücksrad
💬	Chat-Befehl – darunter oft „Bot im Chat: …“
⚙️	Panel-Aktion
🔒	DSGVO (Zuordnung, Antwort, Anfrage)
🎁 / 🔄	Gewinnspiel / Nachlosung

Nur für den Plattform-Inhaber sichtbar

• ⚠️ Befehl-Fehler – Befehl existiert nicht, keine Berechtigung, Cooldown, Stream nicht gestartet
• SMTP, Server-Logs, Login-Audit aller Panel-User

Was nicht protokolliert wird

• Normaler Smalltalk („Hi“, „lol“, …)
• Unbekannte !-Befehle ohne Panel-Eintrag
• Private Nachrichten (Whispers)
Der Bot führt keine Bans oder Timeouts auf Twitch aus – Moderation bleibt bei dir und deinen Mods.

B23. Datenschutz im Panel (Self-Service)

Unter Mein Konto → Datenschutz (nach Login):

Datenexport (JSON – persönlich)

• Profil, Kanal-Mitgliedschaften mit Rollen
• Modul-Status pro Kanal inkl. letzter Statusänderung
• Login-Verlauf (eigene Anmeldungen)
• E-Mail-Protokoll (an dich gesendete System-Mails)
• Deine DSGVO-Anfragen und Antworten

Bot-Datenexport (CSV/ZIP – Kanal)

Mit Berechtigung Bot-Steuerung unter Kanal → Datenexport: Watchtime, Community-Punkte, Chat-Duell, Killer-Statistik — einzeln oder als ZIP. Für Streamer/Mods zum Backup oder Bot-Wechsel, nicht für Endnutzer-Zuschauer. Siehe Abschnitt 13c.

Weitere Rechte

• Berichtigung: Name/E-Mail im Profil selbst ändern
• Anfrage stellen: Auskunft, Löschung, Widerspruch, Einschränkung, Datenübertragbarkeit
• Löschung: Konto-Löschanfrage mit Passwort-Bestätigung
• Per E-Mail: dsgvo@streamheim.de

Details und Rechtsgrundlagen: Datenschutzerklärung

B23b. Ideen-Board (Mandant)

Menü Start → Ideen-Board (/ideas) — plattformweit für alle eingeloggten Mandanten mit Dashboard-Zugriff. Nicht öffentlich und kein Ersatz für DSGVO-Anfragen (dafür Mein Konto → Datenschutz oder dsgvo@streamheim.de).

Abgrenzung: Hier schreiben und abstimmen Mandanten. Die Moderations-Ansicht für den Plattform-Inhaber steht unter D27b · Plattform: Ideen-Board.

Was du dort machen kannst

• Neue Idee — Titel, Text, Kategorie (Modul-Idee, Bug, Diskussion, Sonstiges)
• Abstimmen — eine Stimme pro Person und Beitrag (👍)
• Antworten — Diskussion mit anderen Mandanten; der Plattform-Inhaber antwortet als „Streamheim“
• Sortierung — zuletzt aktiv, meiste Stimmen oder neueste

Sichtbarkeit & Daten

• Alle Beiträge sind für alle berechtigten Panel-Nutzer sichtbar (intern, nicht im Web)
• Gespeichert werden u. a. Anzeigename, zugeordneter Mandant (@twitch_login), Titel, Text, Stimmen und Antworten
• Bitte keine Zuschauer-Daten und keine sensiblen personenbezogenen Daten Dritter posten
• Bei neuer Idee kann der Inhaber per E-Mail benachrichtigt werden

Plattform-Inhaber (Moderation)

Menü Plattform → Ideen-Board (/platform/ideas) — zusätzlich:

• Status: Offen → Geplant → In Arbeit → Umgesetzt / Abgelehnt / Geschlossen
• Anpinnen wichtiger Themen
• Schließen — keine neuen Antworten (Inhaber kann weiter antworten)
• Statistik: offen, in Arbeit, umgesetzt
Abgrenzung: Feature-Wünsche und Community-Feedback gehören ins Ideen-Board. Auskunft, Löschung, Widerspruch und vergleichbare Rechte nur über Datenschutz (B23) — nicht als normaler Forum-Post.

B24. Was der Bot kann – und was nicht

✅ Das macht der Bot

• Glücksrad-Ergebnis im Chat posten
• Nur auf !-Befehle reagieren, die du anlegst
• Timer, Countdown, Uptime, Würfel, Watchtime
• Gewinnspiele, Chat-Duelle, Galgenmännchen, Community-Build, Shoutouts, Begrüßungen, Lurk
• Overlays in OBS triggern (Rad, Sound, Watchtime)
• Per API anbinden (Stream Deck, Streamer.bot) — Setup → API

🚫 Das macht der Bot nicht

• Keine privaten Nachrichten lesen
• Keinen normalen Chat archivieren
• Niemanden bannen, timeouten oder modden
• Keine Channel-Einstellungen ändern
• Nur auf deinem eigenen Kanal aktiv
• Kein Zugriff auf Streamer-Passwort oder Stream-Key

Mod-Rechte (/mod BOT_NAME) braucht er nur zum Schreiben im Chat – er nutzt keine Mod-Funktionen wie Ban oder Timeout. Den Bot-Namen findest du unter Setup → Twitch & Discord.

Öffentliche API

Streamheim ist per API-Schlüssel an Stream Deck, Streamer.bot und eigene Webseiten anbindbar — ohne Programmieren, mit fertigen No-Code-Vorlagen unter Setup → API. Lesen (Status, Watchtime, Punkte, Gewinnspiel), Auslösen (Sound, Rad, Gewinnspiel, Stream-Timer), Webhooks (Streamheim meldet sich bei deiner URL) und Live-WebSocket für eigene Overlays (Scope overlay:live).

Schlüssel: Setup → API · Handbuch: panel.streamheim.de/api-handbuch

C25. Öffentliche URLs & Landing

URL	Inhalt
streamheim.de / /	Landing – Produktinfo, Streamer-Verzeichnis-Link
/streamer	Öffentliches Streamer-Verzeichnis (nur Opt-in-Profile)
/c/LOGIN	Einzelprofil eines gelisteten Streamers
/watchtime?channel=…	Watchtime-Bestenliste
/killer?channel=…	Würfel-/Prozent-Board
/c/LOGIN/galgen	Galgenmännchen-Bestenliste (Portal)
/duell?channel=…	Chat-Duell-Rangliste
/daily?channel=…	Daily-Login-Rangliste (Streak oder Check-ins)
/c/…/schedule bzw. /schedule?channel=…	Streamplan (Woche/Monat)
/punkte?channel=…	Community-Punkte-Rangliste (+ Shop-Vorschau)
/overlay/…	OBS-Browser-Quellen (Rad, Sound, Watchtime, Galgenmännchen, Timer)
/handbuch · /handbuch.pdf	Dieses Handbuch
/api-handbuch · /handbuch/api	API-Handbuch (No-Code, REST v1)
/api/v1/…	Öffentliche REST-API (mit Schlüssel, Setup → API)
/datenschutz · /agb · Impressum	Rechtstexte
/maintenance	Wartungsseite wenn Wartungsmodus aktiv
/admin	Panel-Login

D26. Plattform: Mandanten-Verwaltung

Nur Inhaber – Menü Plattform → Channels (oder ohne aktiven Kanal nach Login).

Aktion	Beschreibung
Öffnen	In Mandanten-Kontext wechseln (Channel-Switcher)
Mitglieder	Team-Liste, Passwort zurücksetzen (Support)
Datenexport	JSON-Export aller Mandanten-Daten (Art. 15)
Sperren	Mandant deaktivieren – Bot & Panel-Zugang gesperrt, Grund protokolliert
Entsperren	Sperre aufheben
Löschen	Soft-Delete mit Bestätigung – irreversibel nach Frist
Live-Badge	Twitch-Live-Status, Titel, Spiel, Zuschauerzahl

Ereignisse landen im Mandanten-Audit (Plattform → Mandanten-Audit) und teils im Mandanten-Protokoll.

D26b. Plattform: Auszeichnungen

Nur Inhaber – Menü Plattform → Auszeichnungen (/platform/awards).

Eigene Kategorien/Labels für Mandanten, die im Streamer-Verzeichnis besonders hervorgehoben werden sollen.

Katalog verwalten

Feld	Bedeutung
Bezeichnung	Anzeigetext im Verzeichnis (z. B. „Mandant der ersten Stunde“)
Beschreibung	Optional — Tooltip auf Profil und in der Liste
Bild	Optionales Icon/Badge (JPEG/PNG/WebP/GIF, max. 512 KB) — wird auf unserem Server gespeichert
Slug	Interne Kennung (URL-freundlich), automatisch aus der Bezeichnung
Sortierung	Reihenfolge bei mehreren Auszeichnungen pro Kanal
Aktiv	Deaktivierte Auszeichnungen werden weder zugewiesen noch öffentlich angezeigt

Mandanten zuweisen

1. Mandant in der Dropdown-Liste wählen (Hinweis „im Verzeichnis“, wenn showcase_opt_in aktiv)
2. Passende Auszeichnungen per Checkbox setzen
3. Zuweisungen speichern — Zuordnung gilt sofort für die öffentliche Anzeige (sofern Opt-in)

In der Mandanten-Übersicht (Plattform → Channels) siehst du zugewiesene Auszeichnungen direkt in der Channel-Spalte.

Öffentliche Wirkung

• /streamer — Badges auf den Karten, Filter-Chips nach Kategorie
• /c/LOGIN — eigener Abschnitt „Auszeichnungen“ auf dem Profil
• Startseiten-Spotlight — kompakte Badge-Anzeige bei gelisteten Streamern

Zuweisungen werden im Zugriffs-Audit (Owner-Protokoll) protokolliert.

D27. Plattform: Bot-Alarme & Discord-Bot

Menü Plattform → Bot-Alarme.

Alarm-Kanäle

Kanal	Einstellung
E-Mail	An Streamer, Owner, Extra-Adressen – pro Alarm-Typ
Discord Webhook	Server-Kanal-Benachrichtigungen
SMS (Twilio)	Handy-Nummern für kritische Alarme
Discord-Bot	Persönliche DMs für verknüpfte Team-Mitglieder (Setup → Discord)

Alarm-Typen (Auszug)

Typ	Wer wird benachrichtigt?
Bot nicht im IRC / Token abgelaufen	Streamer + Owner
Broadcaster-Token abgelaufen	Streamer + Owner
MySQL / PM2 offline	Nur Owner / Ops
Token erneuert, Reconnect	Nur Fehler-Logs (kein Alarm)

Test-Alarm senden zum Prüfen der Konfiguration. Discord-Bot: API-Key, Invite-URL, Enable-Schalter.

Discord-Community (Support-Server)

Menü Plattform → Bot-Alarme → Discord-Community — Server-ID, Einladungslink, Kanal-IDs, Rollen.

Funktion	Kanal / Rolle
Live-Posts	#live — pro Mandant im Setup aktivierbar
Support-Tickets	Private Kanäle unter SUPPORT · Team: /ticket zuweisen, /ticket schliessen
Rundschreiben	#rundschreiben — optional einmal pro Panel-Rundmail (Embed + @Streamer-Ping; Anhänge nur per E-Mail)
Rollen	@Streamer (automatisch bei /link), @Team (Ticket-Zugriff)

D27b. Plattform: Ideen-Board

Menü Plattform → Ideen-Board — gleiche Oberfläche wie Mandanten unter /ideas, mit Moderations-Werkzeugen und Statistik. Siehe auch B23b.

Funktion	Beschreibung
Übersicht	Alle Mandanten-Beiträge, Filter, Sortierung
Status	Offen, Geplant, In Arbeit, Umgesetzt, Abgelehnt, Geschlossen
Anpinnen	Wichtige Themen oben halten
Schließen	Thread für Mandanten sperren (Support-Antworten weiter möglich)
E-Mail	Benachrichtigung bei neuer Idee (System-SMTP)

Rechtliche Einordnung: internes Panel, nicht öffentlich — Details in der Datenschutzerklärung (Ideen-Board).

D28. Plattform: DSGVO-Postfach

Menü Plattform → DSGVO & Eingänge.

1. E-Mails an dsgvo@streamheim.de – IMAP-Import, Auto-Sync ca. alle 3 Min., manuell „Mails abrufen“
2. Panel-Anfragen aus „Mein Konto → Datenschutz“ in derselben Liste
3. Zuordnung: Mandant, optional Panel-User, Anfragetyp (Auskunft, Löschung, Widerspruch …)
4. Fristen: 30 Tage – Badges bei bald ablaufend / überfällig
5. Antworten per SMTP aus dem Panel – signiert mit Bearbeitername, Thread-Erhalt
6. Status: offen → in Bearbeitung → erledigt; interne Notizen; Auto-Vorschläge bei Zuordnung
7. Löschung ausführen – Konto anonymisieren (nur bei Lösch-Anfragen)
8. Export pro User oder Mandant inkl. Modul-Status, Korrespondenz, Login-Audit
9. Zuordnungen im Mandanten-Protokoll (🔒) und Mandanten-Audit

IMAP/SMTP (Plattform)

Postfach-Einstellungen unter DSGVO-Panel: IMAP für Import, SMTP für Antworten – getrennt vom System-SMTP unter „SMTP“.

D29. Plattform: System, SMTP, Logs & Wartung

Menüpunkt	Funktion
System-Health	MySQL, PM2, Bot-IRC, Speicher, Uptime
Wartung	Wartungsmodus für Landing/Panel – öffentliche Hinweis-Seite
Twitch-App	Plattform-OAuth Client-ID/Secret, Redirect-URLs
SMTP	System-Mail (Passwort-Reset, Alarme, Rundmail)
Rundmail	E-Mail an Mandanten; optional parallel ein Post in #rundschreiben auf dem Discord-Server
Ideen-Board	Mandanten-Feedback, Diskussion, Moderation
E-Mail-Protokoll	Versand-Log (sent/failed), Typ, Empfänger
Logins	Panel-Anmeldungen aller User (Zeit, IP, Erfolg)
Zugriffs-Audit	Owner-Aktionen: Channel-Wechsel, Sperren, Export, Auszeichnungen …
Mandanten-Audit	Sperren, Löschen, DSGVO pro Kanal
Fehler-Logs	Server-Debug-Log, filterbar, für Support

D30. Plattform: !dev & Sonstiges

Chat !dev (nur Betreiber)

Menü Plattform → Chat !dev – erlaubte Twitch-Nicks (ein Name pro Zeile). Nur diese dürfen !dev im Chat nutzen – erscheint nicht in der Mandanten-Befehlsliste. Ohne Eintrag: niemand (auch keine Mods).

Owner ohne Kanal

Owner landet ohne gewählten Kanal direkt auf der Plattform-Übersicht. Mit Channel-Switcher in einen Mandanten wechseln für Stream-Setup.

E31. Daten, Sorgfalt & Hilfe

Was gespeichert wird

• Panel-Benutzer: Login, Anzeigename, gehashtes Passwort, Rolle; E-Mail freiwillig
• Glücksrad / Befehle / Panel: siehe Protokoll
• Würfel & Watchtime: Werte für Listen, Rang und Erinnerungen
• Daily Login: Stream-Streak, längste Streak (Rekord), kumulative Check-ins, letzter Check-in (Datum + Stream) und Check-in-Verlauf — Zuordnung primär über Twitch-User-ID (Login nur Anzeige/Fallback); zusätzlich pro Kanal die Stream-Startzeitpunkte (ohne Personenbezug) für die stream-basierte Serie — optional öffentliche Rangliste
• Community-Build: Fortschritt, Mitwirkungszähler pro Login (Versuche/Erfolge) — nur bei aktivem Modul, keine öffentliche Rangliste
• DSGVO: Anfragen, Zuordnungen, Bearbeitungsstatus (Plattform)
• Ideen-Board: Beiträge, Antworten, Abstimmungen (Panel-intern, plattformweit unter Mandanten)

Was nicht gespeichert wird

• Normaler Twitch-Chat-Smalltalk
• Viewer-IPs oder Gerätedaten der Zuschauer
• Twitch-Passwörter oder Stream-Keys

Gute Praxis

• Passwörter nicht weitergeben; bei Verdacht unter „Mein Konto“ ändern
• Team-Zugänge deaktivieren, wenn jemand geht
• VIPs nur „Ansehen“, Mods nur was sie brauchen
• Server in Deutschland (Hetzner) – Panel-Daten auf eurem Server

Wer hilft wann?

Situation	Wer?
Befehle, Module, Mods, Rechte, Würfel zurücksetzen	Du / dein Team
Bot antwortet nicht, Setup-Häkchen rot	Setup & FAQ, dann Plattform-Support
Panel-Fehler, E-Mail, DSGVO-Anfragen	Plattform-Inhaber
Feature-Wünsche, Ideen-Board, Produkt-Feedback	Ideen-Board; Moderation durch Inhaber
Neue Features, Server, Updates	Plattform-Inhaber

• Handbuch: panel.streamheim.de/handbuch
• Support: kontakt@streamheim.de
• Datenschutz: dsgvo@streamheim.de
• FAQ im Panel: Dashboard → „Was kann der Bot?“

Anhang A – Alle Bausteine (Vollständig)

Im Panel unter Bausteine als Chips einfügbar. _next = mitzählen, ohne _next = nur anzeigen.

Personen & Shoutout

Baustein	Bedeutung
{author}	Auslöser (Display-Name); Aliase: {name}, {user}
{target_user}	Ziel bei !befehl @User
{login} {author_login}	Twitch-Login klein
{streamer} {streamer_login} {streamer_url}	Shoutout-Ziel
{game_played} {game} {streamer_plus}	Spiel / Kombi

Zähler

Baustein	Bedeutung
{count} / {count_next}	Gesamt-Nutzungen
{author_count} / {author_count_next}	Pro Autor
{pair_count} / {pair_count_next}	Autor + Ziel
{others_count} / {others_count_next}	Alle außer Autor
{target_count} / {target_count_next}	Pro Ziel

Würfel & Statistik

Baustein	Bedeutung
{random_percent} {random_tier} {roll_icon}	Wurf & Stufe
{schulleiter_suffix} {leader_title} {scope}	Spitzenreiter
{daily_leader_name} {daily_leader_percent}	Tages-Rekord
{board} {klassen_stat} {stats_summary}	Listen & Statistik
{rivalry_line} {rivalry_result}	Stufen-Vergleich
{participant_count} {pct_tier_1} … {count_tier_3}	Teilnehmer & Stufen-%
{random_number} {random_letter}	Zufall 1–100 / A–Z

Stream, Watchtime, Gewinnspiel, Rad, Links

Baustein	Bedeutung
{uptime} {timer} {countdown}	Stream-Zeiten
{watchtime} … {seconds} {watchtime_seconds}	Watchtime-Anteile
{rank} {total_users}	Leaderboard
{join} {duration} {winners} {reason}	Gewinnspiel
{prize} {author}	Glücksrad ({user} = Alias)
{url} {wt_url} {wtr_url} {wto_url} {points_url}	URLs (Board/Overlay)
{args} {channel} {limit_when}	Argumente, Kanal, Limit-Text

Community-Build

Baustein	Bedeutung
{project} {emoji} {unit}	Projektname, Emoji, Einheit (Sandhände, Tropfen …)
{progress} {progress_label} {progress_points}	Fortschritt in % und Einheiten
{goal} {remaining}	Zielpunkte, fehlende Einheiten bis 100 %
{contributors} {points} {author}	Anzahl Mitwirkender, letzter Beitrag, Name
{start_trigger} {contrib_trigger} {status_trigger}	Trigger ohne ! aus den Panel-Einstellungen
{status_label}	aktiv, pausiert, fertig oder inaktiv

Anhang B – Standard-Rechte-Matrix

Voreinstellung – unter Team → Rechte & Rollen anpassbar. ✓ = Bearbeiten, 👁 = Ansehen, – = kein Zugriff.

Bereich	Streamer	Leit. Mod	Mod	VIP
Dashboard, FAQ	✓	✓	✓	–
Glücksrad / Rad / Preise	✓	–	–	–
Chat-Befehle, Bausteine	✓	✓	✓	–
Module, Live jetzt & Steuerung (inkl. Begrüßungen & Lurk), Gewinnspiel, Watchtime, Datenexport, OBS-Timer	✓	✓	–	–
Chat als Bot (Schnell senden)	✓	–	–	–
Chat-Duell	✓	✓	–	–
Galgenmännchen	✓	✓	–	–
Community-Build	✓	✓	–	–
Streamplan	✓	✓	–	–
Protokoll	✓	✓	✓	–
Setup, Multistream, Discord	✓	✓	–	–
Benutzer, Rechte	✓	–	–	–
Mein Konto	✓	✓	✓	✓
System / Plattform	–	–	–	–

Inhaber hat überall Zugriff inkl. Plattform – außer im Mandanten-Kontext ohne explizite Rechte-Matrix-Zeile.

© Streamheim · Stand Juli 2026 · Vertraulich für Stream-Teams.
Maßgeblich bei Abweichungen: Panel-Oberfläche und Datenschutzerklärung auf panel.streamheim.de.