Chatbot

Einführung

Twasi ist ein Dienst zum erstellen eines Chatbots für Twitch Channel.

Zu Twasi

Changelog

Hinzugefügt - !love Befehl, mit welchem getestet werden kann, wie gut Person A mit Person B zusammen passt.

Gefixt - !topwords Befehl und !topchatters Befehl.
Hinzugefügt - !translate Befehl, mit welchem Nachrichten ins Deutsche übersetzt werden können.
Hinzugefügt - Die Einstellungen für die Standardbefehle findet man nun beim Reiter Befehle / Variablen.
Hinzugefügt - Standard Befehle des Bots können nun per Dashboard manuell aktiviert und deaktiviert werden.

Hinzugefügt - Es ist möglich für Standard Befehle einen Cooldown anzugeben.
Hinzugefügt - Die Funktion, requestete Songs zu löschen, wurde ins Panel integriert.
Hinzugefügt - Bei geschenkten Subscriptions können nun der Schenkende und Beschenkte belohnt werden.

Einstellungen

Der Chatbot (und die damit verbundenen Funktionen) können über das Benutzerpanel aktiviert bzw. deaktiviert werden.
Sollte der Bot deaktiviert werden verlässt der Bot automatisch den jeweiligen Twitch Channel des Benutzers.
Alle folgenden Funktionen werden ebenfalls deaktiviert, sollte der Bot deaktiviert werden.

Folgende Funktionen sind verfügbar
Funktion Beschreibung Standardwert
Bot Mit dieser Einstellung wird der Chatbot aktiviert oder deaktiviert.
Alle folgenden Einstellungen funktionieren nur, wenn diese Einstellung aktiviert ist.
Ein
Support Mithilfe des Befehls !support [Supportgrund] kann jeder Streamer, Moderator und Nutzer von Twasi unseren Livesupport anfragen.
Die Globalen Twasi Moderatoren werden dann darüber verständigt, dass Hilfe benötigt wird und werden schnellstmöglich in den Chat kommen.
Dort können dann jegliche Fragen und Probleme genauer geklärt werden.
Ein
Titel und Spiel ändern Mit dieser Einstellung wird die Funktion für das setzen des Streamtitels mithilfe von !title und das setzen des aktuellen Spiels mithilfe von !game aktiviert oder deaktiviert.
Channel Moderatoren können diese Funktion ebenfalls nutzen.
Aus
Songrequests Mit dieser Einstellung wird die Funktion für das hinzufügen und abspielen von Songs der Streamplaylist aktiviert oder deaktiviert.
Wenn diese Funktion aktiviert ist können alle Chatter Songs zur Streamplaylist hinzufügen.
Channel Moderatoren können zusätzlich mit !volume die Lautstärke setzen und mit !skip oder !revoke ein Lied überspringen bzw. eines wiederrufen.
Aus
Tokens Mit dieser Einstellung wird das Tokensystem aktiviert oder deaktiviert, dabei sammeln alle Chatter virtuelle Punkte für das Ansehen deines Streams.
Es werden lediglich die entsprechenden Befehle und Funktionen deaktiviert. Eigens erstellte Befehle, die zum Beispiel mit einer $(tokens) Variable versehen sind bleiben weiter bestehen.
Aus
Zitate Mit dieser Einstellung wird das Zitatsystem aktiviert oder deaktiviert, dabei können Zitate des Streams mithilfe von !zitat add hinzufügen oder zufällige Zitate mithilfe von !zitat im Chat ausgeben lassen.
Channel Moderatoren können ebenfalls auf diese Funktionen zugreifen.
Aus
Wikipedia Befehl Mit dieser Einstellung wird der !wiki Befehl aktiviert oder deaktiviert, mit diesem Befehl ist es möglich kurze Ausschnitte des auf den Suchbegriff passenden Artikels im Chat anzeigen zu lassen.
Der Befehl gibt eine sehr lange Ausgabe zurück.
Aus

Befehle

Befehle lassen sich im Chat ausführen, sie liefern ein entsprechendes Ergebnis zurück. Twasi beinhaltet zwei Arten von Befehlen, zum einen Standart Befehle. Diese Befehle lassen sich standartmäßig in jedem Stream verwenden, in dem der Bot aktiviert ist. Die zweite Art von Befehlen sind die eigenen Befehle, die vom Nutzer des Bots selbst erstellt, gelöscht und verwaltet werden können.

Standart Befehle

Standard Befehle sind vordefinierte Befehle, die der Bot Standardmäßig ausführen kann.


Folgende Standard Befehle sind verfügbar
Befehl Alternative Befehle Parameter Ausgabe
!support - param 1: Frage, Problem Fordert Live Support für den aktuellen Nutzer/Kanal an.
!title !titel param 1: Titel Zeigt bzw. setzt neuen Streamtitel.
!game !spiel param 1: Spiel Zeigt bzw. setzt neues Spiel.
!addvar !addv, !addvariable param 1: Variable
param 2: Ausgabe
Hinzufügen einer neuen Befehlsvariable.
!editvar !editv, !editvariable param 1: Variable
param 2: Ausgabe
Bearbeiten einer Befehlsvariable.
!delvar !delv, !delvariable param 1: Variable Löschen einer Befehlsvariable.
!addcommand !add, !addcmd param 1: Befehl
param 2: Ausgabe
Hinzufügen eines neuen Befehls.
!editcommand !edit, !editcmd param 1: Befehl
param 2: Ausgabe
Bearbeiten eines Befehls.
!delcommand !del, !delcmd param 1: Befehl Löschen eines Befehls.
!cmdlevel !cmdaccess, !access param 1: Befehl
param 2: Level (1|2|69)
Setzt das Zugriffslevel eines Befehls.
!help - - Listet alle vorhandenen Befehle über eine Whisper Nachricht auf.
!sr !request, !songrequest param 1: Video (Link|Name|ID) Requesten eines beliebigen Songs von Youtube.
!delsong - param 1: Datenbank ID Löscht einen bestimmten Song aus der Requestliste.
!skip !skipsong - Überspringt den letzten Song.
!revoke !revokesong - Stellt den letzten Song wieder her.
!skipvote !voteskip - Überspringt den letzten Song bei genügend Zuschauer Votes. Die Anzahl der benötigten Votes kann im Panel unter dem Reiter Bot - Einstellungen vorgenommen werden.
!song !currentsong - Zeigt den aktuell gespielten Song.
!volume !vol param 1: Lautstärke (0-100) Setzt die Lautstärke der Request Liste.
!fav !favorite, !favsong, !favoritesong param 1: Datenbank ID Setzt den aktuell gespielten Song auf die Favoritenliste des Streamers.
!songlist - - Zeigt eine Liste der aktuell gewünschten Songs.
!quote !zitat param 1: add / Datenbank ID
param 2: Zitat
Zeigt bzw. erstellt ein Zitat aus dem Stream.
!messages - param 1: Chatter Name Zeigt, wie viele Nachrichten ein bestimmter Chatter geschrieben hat.
!voting - Startet ein Chatvoting.
!endvoting - - Beendet ein Chatvoting.
!topwords - - Zeigt die Top 10 genutzten Wörter/Zeichenketten des Streams.
!topchatter - - Zeigt die Top 10 Chatter des Streams gemessen an der Anzahl der geschriebenen Wörter.
!topviewer - - Zeigt die Top 10 Chatter des Streams gemessen an der Anzahl der gesammelten Tokens.
!stats - - Zeigt allgemeine Stream statistiken des Streamers.
!wiki !whatis, !whats param 1: Suchbegriff Zeigt einen entsprechenden Wikipedia Artikel.
!blacklist - param 1: add / remove
param 2: Chatter Name
Setzt bzw. entfernt einen Chatter von der Blacklist des Stream.
!cache - - Aktualisiert den Benutzercache mit einem entsprechenden Eintrag des Chatters.
!lang !language param 1: Sprachcode (1|2|3) Setzt die Sprache des Bots.
!uptime - - Zeigt die Uptime des Streams an.
!check !following param 1: Chatter Name Zeigt, wie lange der Sender oder der definierte Chatter dem Streamer folgt.
!wetter !weather param 1: Ort Zeigt aktuelle Wetterdaten für den angegebenen Ort.
!joke !witz - Zeigt einen zufälligen Witz.
!leaderboard - - Zeigt die Liste der Top 100 Zuschauer.
!giveaway - param 1: Eintritt
param 2: Modus(all/subs)
param 3: Keyword
Startet ein Giveaway im Chat.
!endgiveaway - param 1: reroll / cancel Beendet/Wiederholt ein Giveaway.
!translate - param 1: zu übersetzender Text Übersetzt einen beliebigen Text ins Deutsche.
!love !liebe param 1: Person 1
param 2: Person 2
Zeigt, wie gut Person 1 mit Person 2 zusammenpasst.
Eigene Befehle

Eigene Befehle können über den jeweiligen Twitch Chat, oder über das Benutzerpanel erstellt, bearbeitet oder gelöscht werden.
Jeder eigene Befehl muss mit einem Ausrufezeichen (!) beginnen.


Befehl hinzufügen
!add [Befehl] [Ausgabe]
Beispiel
!add !bot Mein Bot läuft über Twasi.net!
Befehl bearbeiten
!edit [Befehl] [Neue Ausgabe]
Beispiel
!edit !bot Mein Bot ist der coolste Bot!
Befehl löschen
!del [Befehl]
Beispiel
!del !bot

Broadcast Nachrichten

Timed Messages (auch Broadcast genannt) sind Nachrichten, welche in einem regelmäßigen Abstand vom Bot in den Channel geschrieben werden. Ein Verwendungszweck könnte zum Beispiel das Schreiben anderer Social Media Kanäle sein.

Eine Nachricht kann auch deaktiviert werden. Dabei wird sie nicht mehr in den Chat geschrieben, die Nachricht bleibt aber bestehen. Um eine Nachricht zu deaktivieren benötigst du nur den Namen der bereits existierenden Nachricht.

Timed Messages können zurzeit nur über den Chat hinzugefügt werden.

Benutzung
[Name]: Name der Nachricht. Wird verwendet, um die Nachricht anzusprechen. Darf nur ein Wort sein. Maximallänge: 50 Zeichen.
[Interval in Minuten]: Zeit in Minuten, die zwischen den Ausgaben liegen soll. Dies muss eine ganze Zahl sein, Gleitkommazahlen sind nicht zulässig. Kleinster möglicher Wert: 1.
[Nachricht]: Die eigentliche Nachricht, die ausgegeben werden soll. Maximallänge: 512 Zeichen.

Timed Message hinzufügen
!timedmessage add [Name] [Interval in Minuten] [Nachricht]
Beispiel
!timedmessage add test 5 Dies ist eine Testnachricht.
Timed Message löschen
!timedmessage remove [Name]
Timed Messages auflisten
!timedmessage
Timed Message Deaktivieren
!timedmessage disable [Name]
Timed Message Aktivieren
!timedmessage enable [Name]

Variablen

Variablen sind Abschnitte von Befehlen, welche das verändern von Commands erleichtert.
Sie sind nützlich für Befehle, die häufiger verändert werden müssen, da dort anstatt des ganzen Befehls nur die Variablen angepasst werden muss.

Chatvariablen können zurzeit nur über den Chat hinzugefügt werden.

Standart Variablen

Standard Variablen sind vordefinierte Variablen, die der Bot Standardmäßig ausführen kann.


Folgende Standard Variablen sind verfügbar
Variable Ausgabe
$(sender) liefert den ausführenden Benutzer zurück.
$(channel) liefert den Namen des Streamers zurück.
$(tokens) liefert die Anzahl der gesammelten Tokens zurück.
$(tokenrank) liefert den Rang sortiert nach Tokens zurück.
$(tokenrankmax) liefert die Anzahl der Ränge zurück. Beispiel: Platz 1 von 100
$(urlfetch URL) liefert den Inhalt der angegebenen URL zurück.
$(uses) liefert zurück, wie oft der Befehl bereits ausgeführt wurde.
$(subcount) liefert die Anzahl der Abonenten des Kanals zurück.
Eigene Variablen

Eigene Variablen werden mithilfe von "{}" in eine Befehlsausgabe eingebunden.

[Variable]: Name der Variable, welcher zum bearbeiten benötigt wird. Darf nur ein Wort sein. Maximallänge: 16 Zeichen.
[Ausgabe]: Nachricht, welche die Variable ausgeben soll.

Variable hinzufügen
!addvar [Variable] [Ausgabe]
Beispiel
!addvar bot Twasibot
Variable bearbeiten
!editvar [Variable] [Neue Ausgabe]
Beispiel
!editvar bot Twasi
Variable löschen
!delvar [Variable]
Beispiel
!delvar bot

Giveaway Funktion

Bei unserer Giveaway Funktion handelt es sich um die Möglichkeit, aus einem Pool von Zuschauern die teilnehmen, einen Gewinner zu bestimmen.
Für die Teilnahme an einem Giveaway können Tokens verlangt werden. Weitere Möglichkeiten, um die gesammelten Tokens auszugeben, werden folgen.

Giveaways können zurzeit nur über den Chat gestartet werden. Es wird allerdings in Zukunft ein Panel folgen.

Giveaways veranstalten
[Eintritt]: Anzahl der Tokens, die die User für die Teilnahme bezahlen müssen.
[Modus(all/subs)]: Hiermit kannst du bestimmen, wer an deinem Giveaway teilnehmen darf.
[Keyword]: Beim Keyword handelt es sich um ein Wort, welches in den Chat geschrieben werden muss, um teilnzunehmen..

Giveaway starten
!giveaway [Eintritt] [Modus(all/subs)] [Keyword]
Beispiel
!giveaway 10 subs Twasi
Giveaway erneut auslosen
!endgiveaway reroll
Giveaway abbrechen
!endgiveaway cancel
Giveaway auslosen
!endgiveaway