Zum Hauptinhalt springen

Befehle — Überblick

Ein Chat-Befehl ist eine Nachricht, die mit einem Trigger beginnt (etwa !ping), den der Bot erkennt und auf den er antwortet. AveloBot unterstützt zwei Arten:

  • Built-in-Befehle — werden mit dem Bot ausgeliefert und sind in Code implementiert. Du kannst Trigger umbenennen, Cooldowns ändern, die nötige Berechtigung anpassen, Aliase ergänzen oder den Befehl ganz deaktivieren. Siehe Built-in-Befehlsreferenz.
  • Eigene Befehle — Befehle, die du selbst mit einer festen Antwort definierst. Siehe Eigene Befehle.

Beide werden auf der Befehle-Seite (/commands) verwaltet.

Anatomie eines Befehls

EigenschaftWirkung
TriggerDer exakte Text, der den Befehl auslöst, z. B. !uptime. Muss in deinem Workspace eindeutig sein.
AliaseAlternative Trigger, die denselben Befehl ausführen, z. B. !fa für !followage. Müssen ebenfalls eindeutig sein.
BerechtigungWer den Befehl nutzen darf. Siehe Berechtigungen unten.
Globaler CooldownMindestabstand zwischen zwei beliebigen Aufrufen im Kanal, in Sekunden.
Pro-Nutzer-CooldownMindestabstand zwischen zwei Aufrufen desselben Chatters, in Sekunden.
AktivWenn aus, wird der Befehl stillschweigend ignoriert.

Berechtigungen

Jeder Befehl hat eine erforderliche Berechtigungsstufe. Der Bot reagiert nur, wenn der Chatter sie erfüllt:

StufeWer den Befehl nutzen darf
Everyone (Alle)Jeder Chatter
Subscriber (Abonnent)Subscriber, VIPs, Moderatoren, Broadcaster
VIPVIPs, Moderatoren, Broadcaster
ModeratorModeratoren und Broadcaster
BroadcasterNur der Streamer

Höhere Stufen schließen niedrigere ein — ein Moderator kann also stets einen „Subscriber"-geschützten Befehl ausführen.

Cooldowns

Cooldowns unterdrücken die Antwort des Bots, wenn der Befehl zu kurz davor schon einmal genutzt wurde. Es gibt zwei:

  • Globaler Cooldown — gilt kanalweit. Damit drosselst du laute Befehle.
  • Pro-Nutzer-Cooldown — gilt pro Chatter. Damit verhinderst du Spam durch eine einzelne Person.

Setze einen der Werte auf 0, um den jeweiligen Cooldown zu deaktivieren. Broadcaster und Moderatoren unterliegen den Cooldowns in der Regel ebenfalls; prüfe das auf der Befehle-Seite, falls du Ausnahmen brauchst.

Befehl deaktivieren

Schalte den Aktiv-Schalter auf der Befehle-Seite um. Der Trigger bleibt reserviert (du kannst den Befehl ohne Verlust der Einstellungen wieder aktivieren), der Bot antwortet aber nicht.