Doku & Hilfe
Alles zum Einrichten und Nutzen von SubWaveBot – Schritt für Schritt.
🚀 Erste Schritte
Melde dich mit deiner Admin-E-Mail im Dashboard an. Verbinde unter Plattformen Twitch, Kick und/oder YouTube. Danach findest du überall im Dashboard fertige Overlay-Links mit deinem persönlichen Token – diese kopierst du in OBS.
🖥️ Overlays in OBS
Jedes Overlay ist eine Browser-Quelle. Kopiere den Link aus dem Dashboard und füge ihn in OBS als neue Browser-Quelle ein (Breite/Höhe wie angegeben, Hintergrund bleibt transparent).
Mit dem Overlay-Manager packst du mehrere Widgets frei angeordnet in EINE einzige Quelle (Ansicht „layout") – das spart Platz und hält OBS aufgeräumt.
⏱️ Subathon-Timer
Lege die Zeitwerte fest (wie viel Zeit ein Sub, Gift, Bits, Kicks, Follow oder eine Spende bringt). Starte/pausiere den Timer im Dashboard oder vom Handy.
Ergänze Meilensteine, eine Happy Hour (Zeit-Multiplikator) und den Endspurt für die letzten Minuten. Zum Finale gibt es einen Recap-Abspann mit den Top-Unterstützern.
🏆 Punkte, Ränge & Shop
Zuschauer sammeln automatisch Punkte fürs Zuschauen und Mitmachen. Mit !punkte sehen sie ihren Stand, mit !rang ihren Fortnite-artigen Rang.
Im Shop kaufen sie mit Punkten Sound-Alerts oder Aktionen. Ein Anti-Fake-Aktivitätsscore sorgt dafür, dass Spam & reiner Emote-Spam nicht belohnt werden – ideal, um am Subathon-Ende die aktivsten Zuschauer fair zu belohnen.
🎮 Minigames
Im Chat spielbar: Quiz (!quiz), Glücksrad, Münzwurf, Battle Royale, Heist und die Geisterjagd. Alle sind einzeln aktivierbar, mit eigenen Kosten, Cooldowns und Texten.
🤖 Chatbot & Befehle
Eigene Befehle, zeitgesteuerte Ansagen, Zähler, Zitate und Social-Aktionen (!hug, !slap …) legst du im Dashboard an. Die Moderation filtert Bannwörter, Links, Caps & Spam und kann per 3-Strikes eskalieren.
Eine öffentliche Befehls-Übersicht gibt es unter befehle.php – ideal zum Verlinken im Panel.
💬 Multichat & Alerts
Das Chat-Overlay bündelt Twitch- und Kick-Chat in einem Fenster – mit den echten Plattform-Abzeichen und nativen sowie 7TV/BTTV/FFZ-Emotes. Fertige Design-Vorlagen gibt es zum Anklicken.
Für Alerts stehen viele fertige Vorlagen bereit (Standard, Fortnite, Synthwave, Gold, Neon …). Du kannst dein aktuelles Alert-Design auch als eigenes Layout speichern und jederzeit wieder anwenden.
Zum Mitlesen auf einem zweiten Bildschirm/Prompter gibt es einen abgespeckten Multichat-Viewer und eine Event-Übersicht als eigene Links.
📅 Streamplan
Plane deine Streams als Wochen-Kalender mit echten Terminen, Serien (wöchentlich/2-wöchentlich) und Absagen. Game-Cover kommen automatisch von Twitch.
Exportiere den Plan als fertige Grafik – Story 9:16, Post, Landscape oder Twitch-Panel – mit Vorlagen (Neon, Ocean, Retro, Fortnite …), Hintergrundbild, Avatar & Kopf-Texten. Über den iCal-Link abonnierst du den Plan in Google/Apple Calendar.
📱 Handy-Steuerung & IRL Control
Die Handy-Steuerung (control.php) lässt sich wie eine App installieren (PWA): Timer, Pause, Song überspringen, Rad, Münzwurf und Panik-Modus.
Mit IRL Control wechselst du unterwegs zwischen 3 frei editierbaren OBS-Szenen. Dazu gibt es schlanke Prompter-Ansichten für Events und Chat – perfekt für einen Elgato Prompter oder zweiten Monitor.
✨ KI-Assistent
Verbinde einen KI-Anbieter (z. B. Google Gemini – kostenloses Kontingent). Dann beantwortet der Bot !aski-Fragen im Chat, und im Adminbereich hilft dir ein Assistent beim Einrichten und Erklären der Funktionen.
🔑 API-Keys
Die meisten Anbindungen (ElevenLabs-Stimmen, TikTok, Tiltify, Discord) stellt die Plattform bereit – die nötigen Schlüssel pflegt der Betreiber, du musst nichts beschaffen.
Selbst eintragen musst du nur deinen KI-Key: Google Gemini (gratis) unter aistudio.google.com/apikey → „API-Schlüssel erstellen" → Key kopieren und im KI-Bereich (Chatbot → KI) eintragen. Alternative: Groq unter console.groq.com/keys. Der Key wird verschlüsselt gespeichert und nie wieder im Klartext angezeigt. Keys niemals im Chat/Discord teilen!
Twitch-Berechtigungen (kein Key): Für Auto-VIP & native Umfragen musst du Twitch im Plattformen-Tab einmal neu verbinden – es gibt nichts zu kopieren.
🔌 API & Webhooks
Unter 🔌 API & Webhooks im Dashboard verbindest du eigene Tools mit deinem Kanal. Ausgehende Webhooks melden verbuchte Events (Subs, Gifts, Bits, Spenden, Follows, Raids, Hype-Train) per HTTP-POST an bis zu 5 eigene Ziele.
In derselben Karte erzeugst du für neue Integrationen mehrere REST-API-v2-Keys mit genau den benötigten Scopes. Jeder Key wird nur einmal im Klartext angezeigt und kann einzeln widerrufen werden.
Zustellung prüfen: Jede Zustellung trägt den Header X-SubWave-Signature: sha256=…. Rechne HMAC-SHA256 über den rohen Anfragekörper mit dem Geheimnis des Ziels und vergleiche timing-sicher – bei Abweichung verwerfen.
REST API v2 liest Timer, Stats, Events, Ziele, Queue, Clip-Marker und den letzten Stream-Bericht. Sichere POSTs sind bewusst nur für Timer, Queue und neue Marker offen und verlangen immer Idempotency-Key. Den maschinenlesbaren Vertrag findest du über den OpenAPI-Link in der Karte. Die alte v1-API bleibt nur lesend kompatibel.
Discord-Tipp: Discord-Webhook-URL einfügen, Format „Discord" wählen – fertig. SubWaveBot postet dann fertige Embed-Nachrichten direkt in deinen Channel.
🛠️ Fehlerbehebung
Overlay zeigt nichts / „nicht verfügbar": Link im Dashboard neu kopieren (Token kann sich geändert haben).
Befehle reagieren nicht auf einer Plattform: prüfen, ob die Plattform verbunden und der Bot dort als Chat-Absender berechtigt ist. Den Verbindungsstatus siehst du im Plattformen-Tab; im Events-Tab siehst du live, was ankommt.