📺 Twitch Bot

EventSub + Chat Integration. V3 hatte 21 Tabellen + 7 Router — V4 wird clean.

🔴 V3 Probleme

14 dokumentierte Issues aus der Code-Analyse

Dual Publishing System

Jedes Event wird an 2 Channels gepublisht (Workflow Engine + Real-Time) mit unterschiedlichen Payload-Formaten. Doppelte Serialisierung, doppelte Logik.

OAuth Token Chaos

Tokens in 3 verschiedenen Stellen: TwitchMonitoredChannel, TwitchCredentials, Web Service Cache. Refresh-Handling inkonsistent — kann 10+ Minuten offline sein.

Config in 3 Orten

Database → In-Memory Cache → Redis Events. Wenn Cache-Reload fehlschlägt, nutzt Bot stale Config ohne Warnung. Kein DB-Fallback wenn Cache leer.

BUGFIX-Pattern überall

17× der selbe try-catch BUGFIX in Event-Handlern. Nachträglich eingefügt, kein Error-Handling-Strategie. Fehler werden nur geloggt.

Kein Rate Limiting

Bot sendet unbegrenzt Messages. Twitch rate-limitet still — gedropte Messages sind unsichtbar. Kein Backpressure.

21 Tabellen

Viel zu viele separate Tables. TwitchBotSetting Key-Value Anti-Pattern. TwitchCommandStats sollte in Command eingebaut sein.

Kein Circuit Breaker

Token-Refresh Failure → alle API Calls feilen still. Kein Alerting, keine Recovery-Strategie. Bot kann 10+ Minuten tot sein.

Command Handler: DB-Query pro Message

Jede Chat-Nachricht triggert einen frischen DB-Lookup. Bei 100+ Messages/Minute = 100+ Queries. Kein Cache, kein Batching.

🔗 Shared Patterns mit Discord Bot

Gleiche Lösungen für gleiche Probleme

BullMQ Job Queue

Einheitliche Queue für Commands an beide Bots. Retry, ACK, Dead Letter. Selbes System wie Discord.

Unified Activity Log

Ein activityLog für Discord + Twitch + System. Type-Enum unterscheidet die Source. Ein Ort für alles.

WebSocket Real-Time

Bot Events → Redis → WS Events → Panel. Live-Updates für Stream Status, Chat Activity, Follows.

🟢 V4 Architektur

Event Flow

Twitch EventSub
WebSocket
→
Twitch Bot
Twurple v8
→
Redis
Single Event Format
→
BullMQ
Workflow Engine
→
WS Events
→ Panel + Overlays

Recording Integration

Stream Online
EventSub
→
Bot publishes
stream.online event
→
Media API
Creates Recording
→
MediaMTX
SRT already ingesting
→
Stream Offline
→ Finalize Recording
📦 Features

🔴 Stream Monitoring

  • Online/Offline Detection (EventSub)
  • Auto-Recording Trigger
  • Category/Title Change Tracking
  • Viewer Count Polling
Must Have

💬 Chat Bot

  • Feste Commands (!rank, !clip, !shop)
  • Custom Commands (DB-driven)
  • Permission Levels (Mod/VIP/Sub/All)
  • Cooldowns (Global + Per-User)
  • Command Stats
Must Have

🎉 EventSub Events

  • Follow / Subscribe / Gift Sub
  • Raid
  • Cheer (Bits)
  • Channel Points Redemption
  • → Alle als Workflow Trigger
Must Have

⏱ Timer Messages

  • Intervall-basiert (Minuten)
  • Min. Chat Activity Filter
  • Game-spezifisch
  • Enable/Disable per Timer
Should Have

🎁 Giveaways

  • Keyword Entry (!enter)
  • Requirements (Follower, Sub, etc)
  • Auto-Draw + Reroll
  • Chat Announcement
Should Have

📊 Polls & Predictions

  • Twitch Native Polls (API)
  • Twitch Predictions (API)
  • Panel-gesteuert
  • Ergebnisse im Log
Should Have

🏆 Channel Points

  • Custom Reward Actions
  • Reward → Workflow Trigger
  • Sync Rewards von Twitch
Should Have

📈 Chat Stats

  • Messages pro Channel/Tag
  • Top Chatter Leaderboard
  • Emote Usage Stats
  • Engagement Metrics
Could Have

👁 Viewer Tracking

  • Viewer Count Graph (historisch)
  • Viewer-Liste: Wer war wann im Stream
  • Twitch API Polling (alle 60s)
  • Session-basiert (pro Stream)
Must Have

😂 Emote Stats

  • BTTV / FFZ / 7TV Cache
  • Usage Tracking pro Emote
  • Top Emotes Leaderboard
  • Emote Trends über Zeit
Should Have

📈 Chat Stats

  • Messages pro Channel/Tag
  • Top Chatter Leaderboard
  • Engagement Metrics
Should Have
📡 Alle EventSub Subscriptions

~40 Event Types — alle als Workflow Trigger verfügbar

🔴 Stream

  • stream.online
  • stream.offline
  • channel.update (Title, Game, Tags)

👥 Viewer

  • channel.follow
  • channel.subscribe
  • channel.subscription.gift
  • channel.subscription.message
  • channel.cheer
  • channel.raid

🎯 Interaction

  • channel.channel_points_custom_reward_redemption.add
  • channel.poll.begin / progress / end
  • channel.prediction.begin / progress / lock / end
  • channel.hype_train.begin / progress / end

🛡 Moderation

  • channel.ban / unban
  • channel.moderator.add / remove
  • channel.vip.add / remove
  • automod.message.hold / update

📢 Creator

  • channel.ad_break.begin
  • channel.shoutout.create / receive
  • channel.charity_campaign.donate / start / progress / stop
  • channel.goal.begin / progress / end

💬 Chat (New API)

  • channel.chat.message
  • channel.chat.notification
  • channel.chat.clear
  • channel.chat.clear_user_messages
  • channel.chat.message_delete

🔔 Whispers & Alerts

  • user.whisper.message
  • channel.warning.acknowledge
  • channel.warning.send
  • channel.suspicious_user.message / update

🔧 System

  • user.authorization.grant / revoke
  • extension.bits_transaction.create
  • drop.entitlement.grant
  • conduit.shard.disabled

→ Alle Events = Workflow Trigger

Jedes dieser Events wird automatisch als Trigger in der Workflow Engine registriert. Der User entscheidet im Drag'n'Drop Editor was bei welchem Event passiert: Overlay zeigen, Chat-Nachricht senden, OBS Scene wechseln, Sound abspielen, etc.

🖥 Admin Panel — Mockup

Twitch-Bereich im Admin Panel

codenull.de/admin/twitch
Twitch
📊 Dashboard
⚙️ Settings
🔑 OAuth
Stream
🔴 Live Status
📝 Event Log
Chat Bot
⚡ Commands
⏱ Timers
Engagement
🎁 Giveaways
📊 Polls
🏆 Rewards
Analytics
👁 Viewers
😂 Emotes
💬 Chat Stats

Twitch Dashboard

Live Status und aktuelle Statistiken

● LIVE Playing: Elden Ring · 234 Viewers · Uptime: 02:34:12
12.4K
Followers
892
Subscribers
1,247
Chat Today
23
New Follows

Recent Events

TimeTypeUserDetails
19:23SubxXGamer42XxTier 1 · 6 months
19:21BitsDankDonator500 Bits · "GG!"
19:18FollowNewViewer123New follower
19:15RaidFriendlyStreamer87 viewers
🗄 Datenmodell — V3 → V4

Von 21 Tabellen auf 11. Shared Patterns mit Discord.

V3 (21 Tabellen)V4 (11 Tabellen)Änderung
TwitchMonitoredChannel (38 fields!)twitchChannel (cleaned, settings as JSON)Vereinfacht
TwitchBotSetting (key-value)→ twitchChannel.settingsEliminiert
TwitchChannelBotSettings→ twitchChannel.botConfigZusammengeführt
TwitchCredentials→ twitchChannel.tokens (encrypted JSON)Vereinfacht
TwitchCommand + TwitchCommandStats + TwitchBotCommandUsage→ twitchCommand (stats inline)3→1
TwitchTimerMessagetwitchTimerRenamed
TwitchGiveawaytwitchGiveawayBehalten
TwitchPoll + TwitchPredictionBehalten (Twitch API driven)Behalten
TwitchRewardActiontwitchRewardRenamed
TwitchFollower + TwitchSubscribertwitchFollower + twitchSubscriberBehalten
TwitchUser + TwitchEmoteCache—Entfernt (Twitch API)
TwitchChatStats→ Aggregation QueryDenormalisiert
TwitchLog (27 fields)→ activityLog (shared)Unified
TwitchBannedWord + TwitchLinkFilter→ twitchChannel.filters (JSON)Vereinfacht
✅ Entscheidungen

Geklärt am 2026-03-18

1. Multi-Channel: Ja, alle gleich

Jeder Channel bekommt alle Features (Commands, Timers, Giveaways etc). Kein abgestuftes System — voller Funktionsumfang für jeden verbundenen Channel.

2. Bot Account: butler_jamie

Separater Bot Account bleibt. Chat-Nachrichten kommen von butler_jamie, nicht vom Streamer-Account. EventSub läuft über den Broadcaster Token.

3. Kein Custom Chat Filter

Twitch AutoMod reicht aus. Kein eigener Spam/Link/Caps Filter. Spart Entwicklungszeit — Twitch's natives System ist gut genug.

4. Emote Stats: Ja

BTTV, FFZ, 7TV Emotes cachen und Usage tracken. Top Emotes Leaderboard, Trends über Zeit. Cached über API, Refresh periodisch.

5. MediaMTX startet Recording

Twitch Bot tracked nur Stream Status (online/offline/title/game). Recording wird von MediaMTX on-publish Hook gestartet — komplett unabhängig vom Twitch Bot.

6. Viewer Tracking + Userliste

Historischer Viewer Count Graph (Polling alle 60s). Plus: welche User waren wann im Stream (Chatters API). Session-basiert pro Stream für Retention-Analyse.

7. Alle EventSub Events abonnieren

~40 Event Types. Alle werden als Workflow Trigger registriert. Title + Game Changes als eigene Events geloggt. Maximale Flexibilität für Automations.

Codenull Platform · Twitch Bot Module Planning · 2026-03-18