Proměnné příkazů

Otevřít v dashboardu

Proměnné jsou zástupné značky v odpovědi příkazu. KickBot do nich při každém spuštění příkazu doplní aktuální hodnotu. Třeba odpověď příkazu !followage s {{sender.followage}} napíše, jak dlouho divák sleduje tvůj Kick kanál. Proměnné fungují ve vlastních příkazech a v odpovědích vestavěných příkazů.

Každou proměnnou piš se dvěma složenými závorkami na každé straně, přesně jak je uvedená na této stránce. Na velkých písmenech záleží: {{sender.username}} funguje, {{Sender.Username}} ne.

Přidání proměnné do odpovědi

Na stránce Vlastní příkazy otevři příkaz, nebo klikni na Přidat příkaz.
Pod polem Odpověď použij Vložit proměnnou. Vyber skupinu (Odesílatel, Streamer, Označený uživatel / parametr, Stream, Náhodné nebo API požadavek).
Klikni na proměnnou. KickBot ji vloží tam, kde máš kurzor.

Náhled V chatu na Kicku ukazuje ukázkové hodnoty, takže odpověď zkontroluješ ještě před uložením.

Menu Vložit proměnnou s otevřenou skupinou Stream a náhledem s ukázkovými hodnotami pro followage, kategorii a diváky — Náhled doplní ukázkové hodnoty. V chatu KickBot použije skutečné hodnoty.

Ukázky níže počítají s divákem KickBotDev na kanálu yourchannel.

Odesílatel

Divák, který příkaz napsal.

Proměnná	Co vypíše	Ukázka výstupu
`{{sender.username}}`	Jméno diváka tak, jak je v odkazu na jeho kanál (malými písmeny)	`kickbotdev`
`{{sender.followers}}`	Kolik sledujících má vlastní kanál diváka	`128`
`{{sender.followage}}`	Jak dlouho divák sleduje tvůj kanál	`4 months 12 days`
`{{sender.url}}`	Odkaz na Kick kanál diváka	`https://kick.com/kickbotdev`
`{{sender.bio}}`	Bio z profilu diváka na Kicku	`Variety streamer from Texas`
`{{sender.instagram}}`	Jméno na Instagramu z profilu diváka na Kicku	`yourhandle`
`{{sender.twitter}}`	Jméno na X (Twitteru) z profilu diváka na Kicku	`yourhandle`
`{{sender.youtube}}`	YouTube z profilu diváka na Kicku	`yourhandle`
`{{sender.discord}}`	Discord z profilu diváka na Kicku	`discord.gg/your-server-code`
`{{sender.tiktok}}`	Jméno na TikToku z profilu diváka na Kicku	`yourhandle`
`{{sender.facebook}}`	Jméno na Facebooku z profilu diváka na Kicku	`yourhandle`

Followage na Kicku

Pokud divák tvůj kanál nesleduje, KickBot místo tvé odpovědi napíše: @kickbotdev is not following @yourchannel.

Tuto proměnnou používá vestavěný příkaz !followage. Jeho odpověď je @{{sender.username}} has been following for {{sender.followage}}, takže v chatu vypadá jako @kickbotdev has been following for 4 months 12 days.

Streamer

Ty, majitel kanálu.

Proměnná	Co vypíše	Ukázka výstupu
`{{streamer.username}}`	Název tvého kanálu tak, jak je v odkazu na kanál	`yourchannel`
`{{streamer.followers}}`	Tvůj počet sledujících	`2450`
`{{streamer.url}}`	Odkaz na tvůj Kick kanál	`https://kick.com/yourchannel`
`{{streamer.bio}}`	Tvoje bio na Kicku	`Chill streams every night`
`{{streamer.instagram}}`	Jméno na Instagramu z tvého profilu na Kicku	`yourhandle`
`{{streamer.twitter}}`	Jméno na X (Twitteru) z tvého profilu na Kicku	`yourhandle`
`{{streamer.youtube}}`	YouTube z tvého profilu na Kicku	`yourhandle`
`{{streamer.discord}}`	Discord z tvého profilu na Kicku	`discord.gg/your-server-code`
`{{streamer.tiktok}}`	Jméno na TikToku z tvého profilu na Kicku	`yourhandle`
`{{streamer.facebook}}`	Jméno na Facebooku z tvého profilu na Kicku	`yourhandle`

Označený uživatel a parametr

Text nebo jméno, které divák napíše za příkaz. Divák třeba napíše !so @SomeChannel nebo !hug @friend.

Proměnná	Co vypíše	Ukázka pro `!so @SomeChannel great stream`
`{{param}}`	Celý text za příkazem	`@SomeChannel great stream`
`{{taggedUser.username}}`	Jméno za prvním `@`	`SomeChannel`
`{{taggedUser.url}}`	Odkaz na označený kanál	`https://kick.com/SomeChannel`
`{{taggedUser.followers}}`	Počet sledujících označeného kanálu	`57`
`{{taggedUser.followage}}`	Jak dlouho označený divák sleduje tvůj kanál	`2 months 3 days`

Označený uživatel má i proměnné z profilu: {{taggedUser.bio}}, {{taggedUser.instagram}}, {{taggedUser.twitter}}, {{taggedUser.youtube}}, {{taggedUser.discord}}, {{taggedUser.tiktok}} a {{taggedUser.facebook}}.

Pokud divák nikoho neoznačí, {{taggedUser.username}} je prázdné. Pokud označené jméno není Kick kanál, proměnné, které něco dohledávají (sledující, bio a další pole z profilu), fungovat nemůžou a KickBot místo odpovědi napíše 404 tagged user not found.

Příklad: vestavěný příkaz !so (shout-out) má odpověď Go check @{{taggedUser.username}}'s channel! {{taggedUser.url}}.

Stream

Tvůj aktuální stream. Tyto proměnné fungují během streamu.

Proměnná	Co vypíše	Ukázka výstupu
`{{stream.title}}`	Název tvého streamu	`Chill stream, come hang out`
`{{stream.category}}`	Kategorie tvého streamu	`Just Chatting`
`{{stream.viewers}}`	Tvůj aktuální počet diváků	`342`

Když jsi offline, KickBot tvůj stream přečíst nemůže, takže příkaz s těmito proměnnými nepošle svoji běžnou odpověď. Místo ní může napsat 404 stream not found.

Náhodné

Hodí se pro hry a zábavné příkazy. Každé spuštění vybere novou hodnotu.

Proměnná	Co vypíše	Ukázka výstupu
`{{randomRange(1,100)}}`	Celé číslo od prvního čísla po druhé, obě včetně	`42`
`{{randomItem("rock","paper","scissors")}}`	Jednu položku ze seznamu, každou se stejnou šancí	`paper`
`{{randomItemPercentage("common":70,"rare":25,"legendary":5)}}`	Jednu položku ze seznamu, s šancí, kterou každé položce dáš	`common`

Pravidla:

randomRange bere dvě celá čísla od 0 výš. První nesmí být větší než druhé.
Každou položku dej do rovných dvojitých uvozovek (") a odděl je čárkami. Položky můžou obsahovat mezery, třeba "Ask again later".
V randomItemPercentage napiš číslo hned za dvojtečku, bez mezery. Čísla jsou váhy. S 70, 25 a 5 padne první položka zhruba 70krát ze 100. randomItemPercentage v menu Vložit proměnnou není. Napiš ho ručně.

API požadavek

{{request("https://...")}} načte data z webové adresy (API) a vloží je do odpovědi. Takhle můžeš ukázat vtip, herní rank nebo cokoli jiného, co vrací veřejné API.

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

KickBot otevře adresu, přečte odpověď v JSON a napíše pole text. Třeba: The praying mantis is the only insect that can turn its head.

Jak to funguje:

Výběr pole. Za uzavírací závorku přidej cestu. Pro názvy použij tečky a pro položky seznamu [0], třeba .data[0].name. Bez cesty, nebo když cesta v odpovědi není, KickBot napíše celou odpověď.
Proměnné v adrese. Třeba {{request("https://example.com/rank?user={{sender.username}}").rank}}. KickBot doplní hodnotu a upraví ji tak, aby byla bezpečná pro webovou adresu (z mezery se stane %20). Požadavek uvnitř požadavku není povolený.
Jen požadavky GET. KickBot nemůže poslat tělo ani hlavičky. Pokud API potřebuje klíč, dej ho do adresy jako parametr dotazu.
Limity. Jen adresy http a https na veřejném internetu. KickBot čeká na odpověď nejvýš 3 sekundy, takže použij API, které odpoví rychle a krátce.

Další proměnné

Tyto proměnné fungují, ale v menu Vložit proměnnou nejsou.

Proměnná	Co vypíše	Ukázka výstupu
`{{user}}`	Jméno diváka i s velkými písmeny	`KickBotDev`
`{{sender.fullUsername}}`	Jméno diváka se `@` na začátku	`@KickBotDev`
`{{commands}}`	Všechny zapnuté příkazy oddělené čárkami	`commands, followage, lurk, me, so, welcome, discord`

Vestavěný příkaz !commands používá {{commands}}. Jeho odpověď je Enabled commands: {{commands}}.

Časté chyby

Jedna závorka místo dvou. {sender.username} zůstane jako text. Použij {{sender.username}}.
Překlep v názvu. Neznámá proměnná, třeba {{sender.name}}, zastaví odpověď příkazu. Porovnej pravopis s touto stránkou.
Typografické uvozovky. randomItem a request potřebují rovné uvozovky ("). Některé telefony a textové editory je mění na typografické (“ ”). Pro jistotu je piš přímo v dashboardu.

Časté dotazy

Jak udělám příkaz followage na Kicku?

KickBot má vestavěný příkaz !followage, který je zapnutý na každém kanálu. Pokud chceš vlastní, přidej příkaz s odpovědí třeba @{{sender.username}} has followed for {{sender.followage}}.

Jak v příkazu ukážu jméno diváka?

Použij {{sender.username}} pro jméno tak, jak je v odkazu na kanál, nebo {{user}} pro jméno i s velkými písmeny. Pokud chceš, aby ho Kick ukázal jako zmínku, přidej před něj @, třeba @{{sender.username}}.

Může příkaz ukázat můj počet diváků nebo název streamu?

Ano. Použij {{stream.viewers}} a {{stream.title}}. Fungují během streamu.