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
13. B15 – Shoutout, Sound, Begrüßungen, Lurk
14. B16 – Live jetzt · B16b – Live-Steuerung · B17 – OBS-Timer & Overlays
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)

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 Bot → 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ü Bot → 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 Bot → 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ü Bot → 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 Bot → Datenexport (Abschnitt 13c)

B13bb. Belohnungen

Menü Bot → 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ü Bot → 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 → Import)
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)
• Re-Import nach Streamheim: Watchtime unter Bot → Watchtime → Import
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ü Bot → 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: Bot → 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ü Bot → 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 Bot → 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.

B14c. Galgenmännchen

Menü Bot → 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.

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ü Bot → 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 Bot → 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.

Automatische Nachrichten

• Intervall (z. B. alle 15 Min.), Text-Vorlage, ein/aus
• Scheduler starten/stoppen im Panel
• Option nur während Stream – wartet auf !streamstart
• Countdown „nächste in …“ 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)

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

B18. Stream-Statistik (Recap)

Menü Bot → 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ü Bot → Streamplan (/admin/bot/streamplan). Hier trägst du ein, wann du streamst — als Einzeltermin oder wöchentliche Serie. Modul Streamplan zuvor unter Bot → 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 Bot → 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.