M MIROXDEVPRODUCT DOCUMENTATION
MiroxBot
MiroxDev/Products/MiroxBot
Modular Bot System

MiroxBot

Das Bot-System hinter den automatisierten Twitch-Workflows. MiroxBot verarbeitet Chat-Commands, EventSub-Ereignisse, Alerts, Auto-Messages und Moderationssignale und stellt sie dem Control Center bereit.

Bot Core

Der Core verbindet Twitch-Events und Chat mit modularen Services. Dadurch bleiben Commands, Alerts und Moderation voneinander getrennt und können unabhängig erweitert werden.

Command Engine

Commands mit Cooldowns, Rollen und individuellen Antworten.

Event Router

Verteilt Follow, Sub, Raid, Cheer und weitere Events an Module.

Realtime Bridge

Leitet relevante Ereignisse an Dashboard und Overlay weiter.

Persistent Config

Konfiguration und Inhalte werden zentral in MariaDB gehalten.

Commands

Commands können im Control Center verwaltet werden und werden vom Bot zur Laufzeit verarbeitet.

!socialsLinks zu Social-Media-KanälenPUBLIC
!discordCommunity-Link oder individuelle InfoPUBLIC
!uptimeAktuelle Stream-LaufzeitPUBLIC
!soOptionaler Command-basierter ShoutoutMOD
!counterVerknüpfung mit einem Stream-CounterMOD
Hinweis

Die gezeigten Commands sind Beispiele. Im System können Namen, Antwort, Cooldown und Rechte individuell gesetzt werden.

Event System

MiroxBot reagiert auf Twitch-Ereignisse und kann daraus mehrere Aktionen auslösen.

EventBeispielaktionControl Center
FollowAlert + Activity FeedRealtime
SubscriptionAlert + LogRealtime
RaidActivity + Shoutout WorkflowRealtime
CheerAlert + Event FeedRealtime
Channel PointsTrigger für individuelle AktionenRealtime
Stream OnlineStatuswechsel und AutomationenRealtime

Alert Engine

Alerts werden als eigene Konfiguration verwaltet. Bild, Text und Verhalten können je Event angepasst werden.

IMGUpload

Alert-Grafiken können lokal hochgeladen und verwaltet werden.

TXTTemplate

Texte können Platzhalter für Event-Daten enthalten.

QQueue

Mehrere Alerts werden geordnet nacheinander abgespielt.

APIEvent Binding

Alerts sind direkt an den Event Router gekoppelt.

Automation

Automatische Nachrichten und wiederkehrende Aktionen reduzieren manuelle Arbeit im Streambetrieb.

  • Auto-Messages nach Zeit- oder Aktivitätsintervallen
  • Eventbasierte Aktionen
  • Counter und Community-Trigger
  • Verknüpfung mit Dashboard-Quick-Actions

Moderation

MiroxBot ist nicht nur ein Chat-Bot. Er stellt auch die technische Verbindung bereit, über die Moderationsinformationen und Twitch-Events im Control Center ankommen.

Account-Kontext

Moderationsaktionen im ModView werden über den jeweils eingeloggten Twitch-Moderator ausgeführt, nicht pauschal über den Bot-Account.

Architektur

Twitch
  │
  ├── EventSub ───────────────┐
  ├── Helix API               │
  └── Chat                    │
                              ▼
                       MiroxBot Core
                       ├─ Event Router
                       ├─ Command Engine
                       ├─ Alert Engine
                       ├─ Automation
                       └─ Moderation Bridge
                              │
                  ┌───────────┴───────────┐
                  ▼                       ▼
              MariaDB             Control Center
                                  Socket.IO / REST

Konfiguration

Typische Runtime-Konfiguration wird serverseitig über Environment-Variablen und Datenbankwerte bereitgestellt.

.env.examplekeine echten Secrets
PORT=3700
PUBLIC_BASE_URL=https://bot.example.tld
TWITCH_CHANNEL_LOGIN=channelname

DB_HOST=127.0.0.1
DB_NAME=app_database
DB_USER=app_user
DB_PASSWORD=CHANGE_ME

SESSION_SECRET=CHANGE_ME