Dokumentation.

Schnellstart, alle Commands (inkl. Valorant-Pack), OBS-Widgets & Sicherheit – alles auf einer Seite.

Auf dieser Seite

Schnellstart
Allgemeine Commands
Valorant-Pack — !rank, !lastmatch, !daystats, !mates, !season, !link, !riot
Riot-IDs verknüpfen
Rechte & Cooldowns
OBS-Widgets
Sicherheit & Datenschutz

Schnellstart

Mit Twitch einloggen unter /bot/login.
Bot in deinem Channel aktivieren (im Dashboard → „Bot aktivieren").
!ping in deinen eigenen Chat senden — Bot sollte antworten.
Im Dashboard → Valorant deine Riot-ID auf Slot #1 verknüpfen.
!rank testen — du siehst deinen Live-Rang.
Viewer können sich selbst über !link Name#Tag oder auf /bot/link verknüpfen.

Allgemeine Commands

Command	Antwort	Rechte
`!ping`	cagliBot meldet sich kurz.	viewer
`!shoutout {user}` · `!so {user}`	AI-Shoutout im gewählten Ton	mod
`!record`	Aktueller Stream-W/L	viewer
`!points`	Eigene CagliCoins	viewer
`!top`	Top 3 nach Punkten	viewer
`!socials`	Social-Links Strip	viewer
`!bot`	Über cagliBot	viewer

Valorant-Pack

Vollwertiger Valorant-Companion im Chat

Daten kommen live von der Henrik-API (5–10 Min Cache, fair zur API). Funktioniert für Streamer-eigenen Account, für jeden verknüpften Viewer und ad-hoc per Riot-ID.

!rank Streamer-Rang (Slot 1)

!rank me Viewer-Slot 1

!rank me 2 Viewer-Slot 2 (bis 5)

!rank @user Anderen Viewer abrufen

!rank Name#Tag Ad-hoc Riot-ID-Lookup

!lastmatch Letztes Comp-Match: Map, Agent, KDA, Score, RR

!daystats W/L & RR-Diff seit Mitternacht

!mates Mitspieler aus dem letzten Match

!season Aktuelle Season-Stats + Peak

!link Name#Tag Verknüpft direkt im Chat

!link list Eigene Slots auflisten

!link remove 2 Slot #2 entfernen

!riot Verknüpfte Riot-IDs anzeigen

!peak Nur Peak-Rang

Riot-ID jetzt verknüpfen Aliases: !elo !rang !rr für !rank · !lm !lastgame !lg für !lastmatch · !duo !trio !team !call für !mates · !dailystats für !daystats

Beispiel-Antworten

> !rank
caglaax3 ist aktuell Diamond 2 mit 67 RR · Peak: Immortal 2.

> !rank me
@Habuubx3 ist aktuell Platinum 3 mit 42 RR · Peak: Diamond 1.

> !lastmatch me
@Habuubx3 · Jett auf Ascent · 18/12/4 · 13-9 · W +21 RR

> !daystats
@Habuubx3 heute: 3W / 1L (+47 RR)

> !mates
Letztes Match mit: PinkSyrup#EUW1 (Sage) · doitfaster#1337 (Omen)

> !link Sage#NA1
@Habuubx3 ✓ Sage#NA1 auf Slot #1 verknüpft · aktuell Gold 3 mit 18 RR. Probier !rank me.

Riot-IDs verknüpfen

Jeder Twitch-User kann bis zu 5 Riot-Accounts in nummerierten Slots verknüpfen. Slot #1 ist der Standard, der bei !rank me antwortet.

Variante A: Direkt im Chat

!link Name#Tag → verknüpft auf Slot #1 (überschreibt ggf.)
!link Name#Tag 2 → Slot #2
!link Name#Tag eu 3 → Region + Slot, Reihenfolge egal
!link list → eigene Slots ansehen
!link remove 2 → Slot #2 entfernen

Variante B: Über die Web-Seite

Falls du keine Lust hast in jeden Chat zu schreiben: /bot/link — Twitch-Login, dann alle Slots als Tabelle bearbeiten.

Wer kann verknüpfen?

Jeder Viewer in jedem Channel, in dem cagliBot mitchattet. Die Verknüpfung gilt global — wer in Channel A verknüpft, dessen !rank me funktioniert auch in Channel B.

Rechte & Cooldowns

Im Commands-Dashboard kannst du pro Command einstellen:

Permission: viewer, sub, vip, mod, broadcaster
Channel-Cooldown: wie oft der Command überhaupt gefeuert werden darf (Spam-Schutz)
User-Cooldown: wie oft der gleiche User ihn nutzen darf
Aliases: beliebig viele Aliase pro Command
Aktiv/Inaktiv: Command an/aus, ohne ihn zu löschen

Builtin-Commands wie !rank kannst du in Cooldowns/Permissions anpassen, aber nicht löschen — du kannst sie aber deaktivieren.

OBS-Widgets

Im Dashboard unter /bot/dashboard/widgets findest du signierte Widget-URLs:

Shoutout-Overlay – Fade-In wenn Bot einen Shoutout postet
Valorant-Rank-Widget – aktueller Rang + RR-Bar
Recent-Shoutouts – letzte 5 Shoutouts als Strip
Chat-Goal – Community-Ziel mit Fortschritt

Token-Rotation jederzeit möglich (alter Token wird sofort ungültig).

Sicherheit & Datenschutz

OAuth-Tokens werden via libsodium verschlüsselt at-rest gespeichert.
EventSub-Webhooks werden via HMAC-Signatur verifiziert.
Stripe-Webhooks werden via Signatur geprüft.
Valorant-Daten kommen von Henrik-API, mit 5-Min-Cache zum Schonen der API.
Wir speichern beim Viewer-Link nur: Twitch-User-ID, Twitch-Login, Riot-ID, aktueller Rank. Keine Tokens, keine E-Mail.
Datenschutz: EU-Hosting, DSGVO-konform, „Daten löschen" jederzeit im Dashboard oder im Chat via !link remove N.
cagliBot ist nicht mit Twitch Interactive oder Riot Games verbunden.