Befehl-Variablen

Variablen sind Platzhalter in der Antwort eines Befehls. KickBot setzt bei jedem Aufruf den aktuellen Wert ein. Eine !followage-Antwort mit {{sender.followage}} postet zum Beispiel, wie lange der Zuschauer deinem Kick-Kanal schon folgt. Variablen funktionieren in eigenen Befehlen und in den Antworten der integrierten Befehle.

Schreib jede Variable mit zwei geschweiften Klammern davor und dahinter, genau so wie auf dieser Seite. Groß- und Kleinschreibung zählt: {{sender.username}} funktioniert, {{Sender.Username}} nicht.

Variable zu einer Antwort hinzufügen

1. Öffne einen Befehl auf der Seite Eigene Befehle oder klick auf Befehl hinzufügen.
2. Nutze unter dem Feld Antwort die Option Variable einfügen. Wähle eine Gruppe (Sender, Streamer, Markierter User / Parameter, Stream, Zufall oder API-Anfrage).
3. Klick auf eine Variable. KickBot fügt sie dort ein, wo dein Cursor steht.

Die Vorschau Im Kick-Chat zeigt Beispielwerte, damit du die Antwort vor dem Speichern prüfen kannst.

Die Vorschau setzt Beispielwerte ein. Im Chat nutzt KickBot die echten Werte.

Die Beispiele unten nutzen einen Zuschauer namens KickBotDev auf einem Kanal namens yourchannel.

Sender

Der Zuschauer, der den Befehl getippt hat.

Variable	Was sie postet	Beispielausgabe
{{sender.username}}	Der Name des Zuschauers wie in seinem Kanal-Link (kleingeschrieben)	kickbotdev
{{sender.followers}}	Wie viele Follower der eigene Kanal des Zuschauers hat	128
{{sender.followage}}	Wie lange der Zuschauer deinem Kanal schon folgt	4 months 12 days
{{sender.url}}	Link zum Kick-Kanal des Zuschauers	https://kick.com/kickbotdev
{{sender.bio}}	Die Bio im Kick-Profil des Zuschauers	Variety streamer from Texas
{{sender.instagram}}	Instagram-Name im Kick-Profil des Zuschauers	yourhandle
{{sender.twitter}}	X-Name (Twitter) im Kick-Profil des Zuschauers	yourhandle
{{sender.youtube}}	YouTube im Kick-Profil des Zuschauers	yourhandle
{{sender.discord}}	Discord im Kick-Profil des Zuschauers	discord.gg/your-server-code
{{sender.tiktok}}	TikTok-Name im Kick-Profil des Zuschauers	yourhandle
{{sender.facebook}}	Facebook-Name im Kick-Profil des Zuschauers	yourhandle

Kick-Followage

Wenn der Zuschauer deinem Kanal nicht folgt, postet KickBot statt deiner Antwort: @kickbotdev is not following @yourchannel.

Der integrierte Befehl !followage nutzt diese Variable. Seine Antwort ist @{{sender.username}} has been following for {{sender.followage}}, im Chat sieht das also so aus: @kickbotdev has been following for 4 months 12 days.

Streamer

Du, der Inhaber des Kanals.

Variable	Was sie postet	Beispielausgabe
{{streamer.username}}	Dein Kanalname wie in deinem Kanal-Link	yourchannel
{{streamer.followers}}	Deine Follower-Zahl	2450
{{streamer.url}}	Link zu deinem Kick-Kanal	https://kick.com/yourchannel
{{streamer.bio}}	Deine Kick-Bio	Chill streams every night
{{streamer.instagram}}	Instagram-Name in deinem Kick-Profil	yourhandle
{{streamer.twitter}}	X-Name (Twitter) in deinem Kick-Profil	yourhandle
{{streamer.youtube}}	YouTube in deinem Kick-Profil	yourhandle
{{streamer.discord}}	Discord in deinem Kick-Profil	discord.gg/your-server-code
{{streamer.tiktok}}	TikTok-Name in deinem Kick-Profil	yourhandle
{{streamer.facebook}}	Facebook-Name in deinem Kick-Profil	yourhandle

Achtung

Die Profil-Variablen (Bio, Instagram, X, YouTube, Discord, TikTok, Facebook) lesen das Kick-Profil. Wenn das Feld im Profil leer ist, bleibt die Variable als normaler Text in der Antwort stehen, zum Beispiel {{streamer.tiktok}}. Nutze sie nur für Profile, in denen das Feld ausgefüllt ist.

Markierter User und Parameter

Text oder ein Name, den der Zuschauer nach dem Befehl tippt. Ein Zuschauer tippt zum Beispiel !so @SomeChannel oder !hug @friend.

Variable	Was sie postet	Beispiel für !so @SomeChannel great stream
{{param}}	Den ganzen Text nach dem Befehl	@SomeChannel great stream
{{taggedUser.username}}	Den Namen nach dem ersten @	SomeChannel
{{taggedUser.url}}	Link zum markierten Kanal	https://kick.com/SomeChannel
{{taggedUser.followers}}	Follower-Zahl des markierten Kanals	57
{{taggedUser.followage}}	Wie lange der markierte Zuschauer deinem Kanal schon folgt	2 months 3 days

Für den markierten User gibt es auch die Profil-Variablen: {{taggedUser.bio}}, {{taggedUser.instagram}}, {{taggedUser.twitter}}, {{taggedUser.youtube}}, {{taggedUser.discord}}, {{taggedUser.tiktok}} und {{taggedUser.facebook}}.

Wenn der Zuschauer niemanden markiert, ist {{taggedUser.username}} leer. Wenn der markierte Name kein Kick-Kanal ist, können die Variablen zum Nachschlagen (Follower, Bio und die anderen Profilfelder) nicht funktionieren, und KickBot postet statt der Antwort 404 tagged user not found.

Beispiel: Der integrierte Befehl !so (Shoutout) hat die Antwort Go check @{{taggedUser.username}}'s channel! {{taggedUser.url}}.

Stream

Dein aktueller Stream. Diese Variablen funktionieren, während du live bist.

Variable	Was sie postet	Beispielausgabe
{{stream.title}}	Dein Streamtitel	Chill stream, come hang out
{{stream.category}}	Die Kategorie deines Streams	Just Chatting
{{stream.viewers}}	Deine aktuelle Zuschauerzahl	342

Wenn du offline bist, kann KickBot deinen Stream nicht lesen. Ein Befehl mit diesen Variablen postet dann nicht seine normale Antwort. Stattdessen kann er 404 stream not found posten.

Zufall

Nutze diese Variablen für Spiele und Spaß-Befehle. Bei jedem Aufruf wird ein neuer Wert gewählt.

Variable	Was sie postet	Beispielausgabe
{{randomRange(1,100)}}	Eine ganze Zahl von der ersten bis zur zweiten Zahl, beide eingeschlossen	42
{{randomItem("rock","paper","scissors")}}	Einen Eintrag aus der Liste, jeder mit derselben Chance	paper
{{randomItemPercentage("common":70,"rare":25,"legendary":5)}}	Einen Eintrag aus der Liste, mit der Chance, die du jedem Eintrag gibst	common

Regeln:

• randomRange nimmt zwei ganze Zahlen ab 0. Die erste darf nicht größer als die zweite sein.
• Setz jeden Eintrag in gerade doppelte Anführungszeichen ("), getrennt durch Kommas. Einträge dürfen Leerzeichen enthalten, zum Beispiel "Ask again later".
• Bei randomItemPercentage steht die Zahl direkt nach dem Doppelpunkt, ohne Leerzeichen. Die Zahlen sind Gewichte. Mit 70, 25 und 5 kommt der erste Eintrag etwa 70 von 100 Mal. randomItemPercentage ist nicht im Menü Variable einfügen. Tippe es selbst ein.

API-Anfrage

{{request("https://...")}} holt Daten von einer Webadresse (API) und setzt sie in die Antwort ein. Damit zeigst du einen Witz, einen Rang in einem Spiel oder alles andere, was eine öffentliche API zurückgibt.

{{request("https://uselessfacts.jsph.pl/api/v2/facts/random").text}}

KickBot öffnet die Adresse, liest die JSON-Antwort und postet das Feld text. Zum Beispiel: The praying mantis is the only insect that can turn its head.

So funktioniert es:

• Ein Feld wählen. Häng den Pfad hinter die schließende Klammer an. Nutze Punkte für Namen und [0] für Listeneinträge, zum Beispiel .data[0].name. Ohne Pfad, oder wenn der Pfad nicht in der Antwort vorkommt, postet KickBot die ganze Antwort.
• Variablen in der Adresse nutzen. Zum Beispiel {{request("https://example.com/rank?user={{sender.username}}").rank}}. KickBot setzt den Wert ein und macht ihn sicher für eine Webadresse (ein Leerzeichen wird zu %20). Eine Anfrage innerhalb einer Anfrage ist nicht erlaubt.
• Nur GET-Anfragen. KickBot kann keinen Body und keine Header senden. Wenn die API einen Key braucht, setz ihn als Query-Parameter in die Adresse.
• Limits. Nur http- und https-Adressen im öffentlichen Internet. KickBot wartet bis zu 3 Sekunden auf eine Antwort, also nutze eine API, die schnell und kurz antwortet.

Achtung

Jeder, der deine Befehlseinstellungen sehen kann, sieht auch einen API-Key in der Adresse. Nutze nur Keys, die öffentliche Daten lesen.

Weitere Variablen

Diese Variablen funktionieren, stehen aber nicht im Menü Variable einfügen.

Variable	Was sie postet	Beispielausgabe
{{user}}	Den Namen des Zuschauers mit seinen Großbuchstaben	KickBotDev
{{sender.fullUsername}}	Den Namen des Zuschauers mit @ davor	@KickBotDev
{{commands}}	Alle eingeschalteten Befehle, getrennt durch Kommas	commands, followage, lurk, me, so, welcome, discord

Der integrierte Befehl !commands nutzt {{commands}}. Seine Antwort ist Enabled commands: {{commands}}.

Häufige Fehler

• Eine Klammer statt zwei. {sender.username} bleibt als Text stehen. Nutze {{sender.username}}.
• Ein falsch geschriebener Name. Eine unbekannte Variable wie {{sender.name}} sorgt dafür, dass der Befehl keine Antwort postet. Vergleich die Schreibweise mit dieser Seite.
• Typografische Anführungszeichen. randomItem und request brauchen gerade Anführungszeichen ("). Manche Handys und Texteditoren machen daraus geschwungene Anführungszeichen (“ ”). Tippe sie sicherheitshalber direkt im Dashboard.

Häufige Fragen

Wie erstelle ich einen Followage-Befehl auf Kick?

KickBot hat einen integrierten Befehl !followage, der auf jedem Kanal eingeschaltet ist. Für einen eigenen fügst du einen Befehl mit einer Antwort wie @{{sender.username}} has followed for {{sender.followage}} hinzu.

Wie zeige ich den Namen des Zuschauers in einem Befehl?

Nutze {{sender.username}} für den Namen wie im Kanal-Link oder {{user}} für den Namen mit seinen Großbuchstaben. Setz ein @ davor, wenn Kick ihn als Erwähnung zeigen soll, zum Beispiel @{{sender.username}}.

Kann ein Befehl meine Zuschauerzahl oder meinen Streamtitel zeigen?

Ja. Nutze {{stream.viewers}} und {{stream.title}}. Sie funktionieren, während du live bist.