Wichtige Konzepte

Diese Begriffe tauchen immer wieder auf. Wenn du sie einmal verstanden hast, liest sich der Rest der Doku deutlich leichter.

Dashboard

Die SvelteKit-SPA unter /dashboard/. Hier verwaltest du Overlays, Automations, den Bot, Integrationen und alles andere. Die Sidebar ist in sieben grosse Bereiche gegliedert (Uebersicht, Stream vorbereiten, Live steuern, Momente auswerten, Content produzieren, Community aktivieren, System & Konto). Komponenten/Seiten sind nach Domaene benannt, z. B. Wizard, Onboarding, OverlayList.

Overlay

Ein Overlay ist eine in Chatlix gebaute Szene, die du als Browser-Source in OBS einbindest. Die Render-URL hat die Form https://chatlix.app/overlay/view.php?id=...&token=.... Ein Token ist an genau ein Overlay gebunden — teile ihn nie oeffentlich.

Automation

Eine Automation reagiert auf ein Ereignis und fuehrt Aktionen aus. Klassisch: „Wenn neuer Follower, dann Alert im Overlay und Soundeffekt". Du legst Automations im Dashboard unter „Automationen" an, mit Vorlagen unter „Automation-Vorlagen" und wiederverwendbaren Werten unter „Automation-Variablen".

Event

Ausloeser fuer Automations. Quellen sind in der Regel Twitch (Follower, Sub, Bits, Raid, Hype Train, Redemption, Poll), aber auch interne Ereignisse wie StoryQuest-Schritte oder Game-Watcher-Meldungen. Twitch-Events kommen ueber einen HMAC-verifizierten EventSub-Webhook rein und werden intern normalisiert und weiterverteilt (auch an Discord, falls verbunden).

Invite-Code

Seit der „Auth V2 Phase 5"-Umstellung ist die Registrierung nicht mehr offen. Neue Accounts brauchen einen Invite-Code, egal ob per Email/Passwort (/auth/invite/register) oder beim ersten Google-/Twitch-Login. Bestehende Nutzer erzeugen Invite-Links ueber ihre Referral-Seite. Details in „Account anlegen".

Plan / Feature-Gate

Chatlix hat mehrere Plan-Stufen, die per Feature-Gate steuern, was du im Dashboard siehst und nutzen kannst. Das kanonische, billing-getriebene Modell ist:

Plan-Key	Anzeigename	Status
free	Free	Kostenlos, Standard fuer neue Accounts
starter	Starter	Oeffentlich, bezahlt
creator	Creator	Oeffentlich, bezahlt
pro_max	Pro	Oeffentlich, bezahlt, hoechste oeffentliche Stufe
team	Team	Oeffentlich, fuer Mehrpersonen-Setups

Daneben existieren Legacy-Keys aus frueheren Preismodellen, die bestehende Kunden behalten (Grandfathering), aber nicht mehr neu verkauft werden: pro (zeigt sich als „Creator"), studio (zeigt sich als „Pro"), elite, agency, enterprise. Wenn du in der Doku oder im Code auf „Pro" stoesst, lohnt sich ein zweiter Blick, ob pro (Legacy/Creator-Niveau) oder pro_max (aktuelles Pro) gemeint ist — beide heissen im UI unterschiedlich. Im Dashboard erkennst du plan-gated Features an Badges wie „PRO" oder an upsell-Elementen, die trotz fehlendem Plan sichtbar bleiben, aber zum Upgrade fuehren.

AI-Credits

Fuer KI-Funktionen (TTS-Stimmen, AI-Bilder, Sprite Studio, Podcast-Extract) verbraucht dein Account Credits. Du kannst Credits per Top-up nachkaufen, unabhaengig vom Plan. Reine Feature-Freischaltung (z. B. ob dir „AI-Builder" ueberhaupt angezeigt wird) laeuft dagegen ueber den Plan, nicht ueber Credits.

Chatlix Connect

Optionaler Desktop-Client (Windows, Linux), seit 0.5.0 als Desktop-App mit gebuendeltem Game Watcher (ChatlixConnect-Desktop.zip). Verbindet dein lokales OBS-WebSocket mit dem Chatlix-Backend, sodass das Dashboard Szenen, Quellen und Audio steuern kann. Ohne Connect funktioniert das Anzeigen von Overlays trotzdem, aber das Umschalten von OBS-Szenen aus dem Browser sowie Smart-Lights/Stream-Deck-Funktionen gehen nicht.

Game Watcher

Tool fuer Minecraft-Stats, seit 0.5.0 Teil der Connect-Desktop-App statt eigenstaendiger Download. Liest Statistik-Dateien von Vanilla, Prism, MultiMC und CurseForge und schickt sie an Chatlix. Beta-Status.

Bot / Mod-Rechte

Der Chatlix-Chatbot muss in deinem Twitch-Kanal als Moderator eingesetzt sein, sonst funktionieren Timeouts, Nachrichten-Loeschung und einige Redemption-Reaktionen nicht zuverlaessig. Das ist im Setup-Wizard ein eigener Pflichtschritt, wird aber leicht uebersehen — siehe „Erstes Setup in 5 Minuten".

Twitch-Scopes

Beim Twitch-OAuth fordert Chatlix standardmaessig einen ganzen Satz Scopes an, nicht nur Lesezugriff: chat:read, chat:edit, channel:moderate, channel:read:subscriptions, moderator:read:followers, bits:read, user:read:email, channel:read:polls, channel:read:redemptions, channel:manage:redemptions, channel:read:hype_train, user:read:chat, moderator:manage:banned_users, moderator:manage:chat_messages, moderator:manage:chat_settings, channel:manage:vips, channel:manage:moderators, clips:edit, channel:read:ads. Manche Zusatzfunktionen (z. B. Ad-Break-Automation) pruefen gezielt, ob die noetigen Scopes vorhanden sind, und fordern sonst einen Reconnect mit erweiterten Scopes an.

StoryQuest

Interaktive Quest-Engine. Zuschauerinnen und Zuschauer entscheiden ueber Chat-Eingaben oder Channel-Points, wie eine Geschichte weitergeht. StoryQuest ist ein eigener Bereich im Dashboard.

Marketplace / Presets

Geteilte Vorlagen fuer Overlays, Automations und StoryQuests, plus die neuere Preset-Bibliothek unter „Stream vorbereiten" → „Automation" fuer Vibe-Komplettpakete. Du kannst eigene veroeffentlichen oder fremde uebernehmen.

API

Das Backend laeuft als PHP-Monolith auf dem App-Node dem Anwendungsknoten. Alle Endpunkte beginnen mit https://api.chatlix.app, Versionspfad meist /v1/.... Beispiele:

• /v1/obs/* fuer OBS-Steuerung
• /v1/onboarding/* fuer Onboarding-Schritte, Diagnose und Starter-Pack-Installation
• /auth/invite/register fuer Invite-basierte Account-Erstellung
• /api/waitlist und /api/waitlist/confirm fuer die Warteliste

Realtime

Fuer Realtime laeuft ein WebSocket-Dienst. Du musst dich darum nicht selber kuemmern, das Dashboard verbindet sich automatisch.

Sessions

Logins laufen ueber Server-Sessions. Wenn du das Passwort aenderst oder MFA neu einrichtest, kann es passieren, dass alle Sessions invalidiert werden und du dich neu anmelden musst. Unter „Konto & Plan" → Sicherheit kannst du gezielt alle Sessions ausser der aktuellen beenden.

Auth-Routen (Uebersicht)

Aktion	Route
Registrieren ohne Invite	/auth/register — liefert bewusst 403 invite_only
Registrieren mit Invite	/auth/invite/register
Login	/auth/login
Magic-Link anfordern / einloesen	/auth/magic-request (POST) / /auth/magic (GET)
MFA Setup / Bestaetigen / Deaktivieren	/auth/mfa/totp/setup, /auth/mfa/totp/confirm, /auth/mfa/totp/disable
MFA Recovery-Codes	/auth/mfa/recovery-codes/regenerate
MFA-Login-Verifikation	/auth/mfa/verify
OAuth Google	/oauth/google/login, /oauth/google/callback
OAuth Twitch	/oauth/twitch/login, /oauth/twitch/callback
Warteliste	/api/waitlist, /api/waitlist/confirm

URL-Shortener

Kurz-URLs landen auf go.chatlix.app mit Format /r/{code}. Du kannst sie aus dem Dashboard erstellen, z. B. fuer Stream-Marketing oder Referral-Links.