Games-Hub

Minigames für deinen Twitch-Stream — dein Chat spielt mit, gerendert direkt in deinem OBS-Overlay.

Als Zuschauer anmelden Als Streamer starten

Zuschauer: nur Login zur Identifikation (keine weiteren Rechte). Streamer: erlaubt dem Hub-Bot, deinen Chat zu lesen (channel:bot).

Was ist der Games-Hub?

Eine Plattform für Stream-Minigames: Du hängst ein einziges Overlay in OBS, startest Spiele per Klick — und deine Zuschauer spielen über den Chat mit. Keine Extensions, keine Downloads, kein Setup pro Spiel.

🖥️ Ein Overlay, alle Spiele Browser-Source einmal einrichten (transparent, in deiner Leinwand- größe) — jedes Spiel läuft darin, das Overlay bleibt sonst unsichtbar.

💬 Der Chat ist der Controller !angel 45 60 und die Angel fliegt. Commands kommen in Echtzeit aus deinem Twitch-Chat ins Spiel.

🔒 Schlanke Rechte Login mit Twitch, ein einziger Scope — der Hub speichert keine Tokens von deinem Account.

So funktioniert's

Mit Twitch einloggen. Dabei erlaubst du dem Hub-Bot, den Chat deines Kanals zu lesen (Scope channel:bot) — mehr braucht es nicht.
Overlay in OBS einhängen. Deine persönliche Overlay-URL als Browser-Source, transparent, in der Größe deiner Leinwand — 1920×1080, 2560×1440 oder was du sonst nutzt. Das Overlay rechnet sich selbst um.
Spiel starten. Per Button im Dashboard — oder automatisiert über die HTTP-API vom Streamdeck bzw. streamer.bot (z. B. beim Szenenwechsel in die Pause).
Chat spielt, du streamst. Stoppen lässt das Spiel graceful auslaufen: laufende Runden enden regulär, dann ist das Overlay wieder leer und das nächste Spiel kann starten.

Die Spiele 🏅 Ranglisten

Ballistic Golf !throw <winkel> <stärke> — wer landet am nächsten am Loch? Auch per Whisper an den Bot. gerade nicht live 🏅 Rangliste ansehen

Angeln !angel <winkel> <stärke> — wirf die Angel und fang den schwersten Fisch der Runde. gerade nicht live 🏅 Rangliste ansehen

Pong PVE !1 bis !5 — der Chat zieht gemeinsam das rechte Paddle auf ein Zielfeld, gegen den Computer. gerade nicht live 🏅 Rangliste ansehen

Pong PVP !join — Team wird ausgelost, dann !1 bis !5: Chat gegen Chat, jedes Team zieht sein eigenes Paddle. gerade nicht live 🏅 Rangliste ansehen

Tipp-Zombies Zombies kommen von links mit einem Wort über dem Kopf — tippt das Wort, dann feuern Schützen darauf. Gemeinsam die Basis verteidigen. gerade nicht live 🏅 Rangliste ansehen

Würfelpasch !würfel — 5 Würfel, 3 Würfe. !fertig wertet die beste Kategorie. Highscore = deine Punktesumme. gerade nicht live 🏅 Rangliste ansehen

Panzer !fire <winkel> <stärke> — alle 10 s feuern alle gleichzeitig. Der Sand fliegt, die Krater bleiben. gerade nicht live 🏅 Rangliste ansehen

Demo: Bouncing Balls Protokoll-Test — bunte Bälle springen durchs Overlay. Stop lässt sie rausfallen. gerade nicht live 🏅 Rangliste ansehen

Die Plattform ist so gebaut, dass neue Spiele dazukommen, ohne dass sich am Overlay je etwas ändert — die Liste wächst.

Unter der Haube

Server-authoritativ: Die komplette Spiellogik (Physik, Runden, Wertung) läuft auf dem Server mit 20 Ticks pro Sekunde — im Overlay wird nur gezeichnet. Kein Client kann schummeln, und OBS bleibt schlank.
Generisches Overlay: Spiele sprechen ein Entity-Protokoll über WebSocket (hello / snapshot / events / widgets / clear). Der Canvas-Renderer kennt Sprites, Formen, Text, Linien, Trails und Partikel — aber kein einziges Spiel. Interpolation zwischen den Ticks macht aus 20 Hz butterweiche Bewegung.
Chat-Anbindung: Twitch EventSub (channel.chat.message) über einen zentralen Bot-Account. Der channel:bot-Grant aus deinem Login genügt — Verbindungen existieren nur, solange bei dir ein Spiel läuft.
Integrationen: Token-API für Start/Stop (Streamdeck, streamer.bot) und eine WebSocket-Bridge, über die dein lokales streamer.bot Spiel-Events empfängt — Details in den beiden Blöcken unten.
Spiele als Module: Ein Spiel ist ein Server-Modul gegen eine generische Stage-API. Neue Spiele brauchen null Zeilen Overlay-Code — genau deshalb skaliert der Hub.

Spiele per Klick starten & stoppen (Streamdeck / streamer.bot)

Im Dashboard liefert jedes Spiel eine fertige Start-URL (dazu eine Stop-URL). Sie trägt einen geheimen Token, der deinen Kanal identifiziert — damit steuert jedes Tool, das eine URL aufrufen kann, deine Spiele, ganz ohne Browser-Login:

https://gameshub.fiftyshadesofgames.de/api/v1/games/ballgame/start?token=DEIN_TOKEN

GET und POST funktionieren beide — GET absichtlich, damit auch simple „URL öffnen"-Aktionen reichen.

Streamdeck: Eine Taste mit der Start-URL belegen — per „Website"-Aktion oder, sauberer und ohne aufpoppenden Tab, mit einem HTTP-Request-Plugin (z. B. „Web Requests"). Zweite Taste = Stop-URL. Ein Fingertipp startet bzw. beendet das Spiel.
streamer.bot: Eine Aktion mit der Sub-Aktion Core → Network → Fetch URL (Start-URL) an einen Trigger hängen — z. B. OBS Scene Changed → Pause-Szene. Beim Wechsel in die Pause startet das Spiel automatisch, beim Zurück eine zweite Aktion mit der Stop-URL. Die klassische „Pausen-Minigame"- Automatik, komplett ohne manuelles Eingreifen.

streamer.bot-Bridge: eigene Zeremonien & Alerts

Gerechnet wird in der Cloud — aber deine Show bleibt lokal. Über die Bridge verbindet sich dein streamer.bot ausgehend als WebSocket-Client zum Hub (kein Portforward nötig) und empfängt Spiel-Events in Echtzeit. Typischer Fall: Am Rundenende bekommt streamer.bot den Sieger frei Haus und zündet deine eigene Krönungs-Animation, vergibt Punkte oder schaltet ein Panel — die Spiellogik liegt im Hub, die Inszenierung auf deinem Rechner. Genauso lässt sich ein Sound-Alert an jeden dicken Fisch oder Rekord hängen.

Event	Nutzdaten	Wann
`game_start` / `game_stopped`	Spiel, Status	Spiel läuft an / endet
`round_end`	Sieger & Rangliste (`login`, `score`, Platz), Teilnehmer, Statistik	Ende einer Wertung → Krönung
`game_event`	Moment-Typ (Rekord, Fang …), Spieler, Wert	punktueller Höhepunkt → Alert
`whisper`	Ziel-Login, Text	Spiel flüstert ein Ergebnis

Nur Spieldaten: Über die Bridge gehen ausschließlich öffentliche Twitch-Logins und Punktzahlen — keine Tokens, keine Passwörter, keine privaten Daten. Das einzige Geheimnis ist der Token in der Bridge-URL selbst; er lässt sich jederzeit im Dashboard rotieren.

Als Zuschauer anmelden Als Streamer starten

Zuschauer: nur Login zur Identifikation (keine weiteren Rechte). Streamer: erlaubt dem Hub-Bot, deinen Chat zu lesen (channel:bot).