İçeriğe geç

Komut değişkenleri

Değişkenler, bir komut yanıtındaki yer tutuculardır. KickBot komut her çalıştığında yerlerine canlı değeri koyar. Örneğin {{sender.followage}} içeren bir !followage yanıtı, izleyicinin Kick kanalını ne zamandır takip ettiğini yazar. Değişkenler özel komutlarda ve hazır komutların yanıtlarında çalışır.

Her değişkeni her iki yanda iki süslü parantezle, tam bu sayfada gösterildiği gibi yaz. Büyük harfler önemlidir: {{sender.username}} çalışır, {{Sender.Username}} çalışmaz.

  1. Özel komutlar sayfasında bir komutu aç veya Komut Ekle’ye tıkla.
  2. Cevap kutusunun altında Değişken ekle’yi kullan. Bir grup seç (Gönderen, Yayıncı, Etiketlenen Kullanıcı / Parametre, Yayın, Rastgele veya API İsteği).
  3. Bir değişkene tıkla. KickBot onu imlecin olduğu yere ekler.

Kick sohbetinde önizlemesi örnek değerler gösterir, böylece kaydetmeden önce yanıtı kontrol edebilirsin.

Yayın grubu açık Değişken ekle menüsü ve followage, kategori ve izleyici sayısı için örnek değerli önizleme
Önizleme örnek değerleri doldurur. Chat'te KickBot gerçek değerleri kullanır.

Aşağıdaki örneklerde yourchannel adlı bir kanalda KickBotDev adlı bir izleyici kullanılıyor.

Komutu yazan izleyici.

DeğişkenNe yazarÖrnek çıktı
{{sender.username}}İzleyicinin kanal bağlantısındaki adı (küçük harflerle)kickbotdev
{{sender.followers}}İzleyicinin kendi kanalının takipçi sayısı128
{{sender.followage}}İzleyicinin kanalını ne zamandır takip ettiği4 months 12 days
{{sender.url}}İzleyicinin Kick kanalının bağlantısıhttps://kick.com/kickbotdev
{{sender.bio}}İzleyicinin Kick profilindeki biyografiİstanbul'dan variety yayıncısı
{{sender.instagram}}İzleyicinin Kick profilindeki Instagram adıyourhandle
{{sender.twitter}}İzleyicinin Kick profilindeki X (Twitter) adıyourhandle
{{sender.youtube}}İzleyicinin Kick profilindeki YouTubeyourhandle
{{sender.discord}}İzleyicinin Kick profilindeki Discorddiscord.gg/your-server-code
{{sender.tiktok}}İzleyicinin Kick profilindeki TikTok adıyourhandle
{{sender.facebook}}İzleyicinin Kick profilindeki Facebook adıyourhandle

İzleyici kanalını takip etmiyorsa KickBot senin yanıtın yerine şunu yazar: @kickbotdev is not following @yourchannel.

Hazır !followage komutu bu değişkeni kullanır. Yanıtı @{{sender.username}} has been following for {{sender.followage}} olduğu için chat’te @kickbotdev has been following for 4 months 12 days gibi görünür.

Sen, yani kanal sahibi.

DeğişkenNe yazarÖrnek çıktı
{{streamer.username}}Kanal bağlantındaki kanal adınyourchannel
{{streamer.followers}}Takipçi sayın2450
{{streamer.url}}Kick kanalının bağlantısıhttps://kick.com/yourchannel
{{streamer.bio}}Kick biyografinHer akşam sakin yayınlar
{{streamer.instagram}}Kick profilindeki Instagram adıyourhandle
{{streamer.twitter}}Kick profilindeki X (Twitter) adıyourhandle
{{streamer.youtube}}Kick profilindeki YouTubeyourhandle
{{streamer.discord}}Kick profilindeki Discorddiscord.gg/your-server-code
{{streamer.tiktok}}Kick profilindeki TikTok adıyourhandle
{{streamer.facebook}}Kick profilindeki Facebook adıyourhandle

İzleyicinin komuttan sonra yazdığı metin veya ad. Örneğin bir izleyici !so @SomeChannel veya !hug @friend yazar.

DeğişkenNe yazar!so @SomeChannel harika yayın için örnek
{{param}}Komuttan sonraki tüm metin@SomeChannel harika yayın
{{taggedUser.username}}İlk @ işaretinden sonraki adSomeChannel
{{taggedUser.url}}Etiketlenen kanalın bağlantısıhttps://kick.com/SomeChannel
{{taggedUser.followers}}Etiketlenen kanalın takipçi sayısı57
{{taggedUser.followage}}Etiketlenen izleyicinin kanalını ne zamandır takip ettiği2 months 3 days

Etiketlenen kullanıcının profil değişkenleri de var: {{taggedUser.bio}}, {{taggedUser.instagram}}, {{taggedUser.twitter}}, {{taggedUser.youtube}}, {{taggedUser.discord}}, {{taggedUser.tiktok}} ve {{taggedUser.facebook}}.

İzleyici kimseyi etiketlemezse {{taggedUser.username}} boş kalır. Etiketlenen ad bir Kick kanalı değilse sorgu değişkenleri (takipçiler, biyografi ve diğer profil alanları) çalışamaz ve KickBot yanıt yerine 404 tagged user not found yazar.

Örnek: hazır !so (shout-out) komutunun yanıtı Go check @{{taggedUser.username}}'s channel! {{taggedUser.url}} şeklindedir.

Şu anki yayının. Bu değişkenler sen yayındayken çalışır.

DeğişkenNe yazarÖrnek çıktı
{{stream.title}}Yayın başlığınSakin yayın, gel takıl
{{stream.category}}Yayın kategorinJust Chatting
{{stream.viewers}}Şu anki izleyici sayın342

Çevrimdışıyken KickBot yayınını okuyamaz, bu yüzden bu değişkenleri içeren bir komut normal yanıtını yazmaz. Bunun yerine 404 stream not found yazabilir.

Bunları oyunlar ve eğlenceli komutlar için kullan. Her çalıştırmada yeni bir değer seçilir.

DeğişkenNe yazarÖrnek çıktı
{{randomRange(1,100)}}İlk sayıdan ikinci sayıya kadar bir tam sayı, ikisi de dahil42
{{randomItem("taş","kağıt","makas")}}Listeden bir öğe, her birinin şansı eşitkağıt
{{randomItemPercentage("sıradan":70,"nadir":25,"efsanevi":5)}}Listeden bir öğe, her öğeye verdiğin şanslasıradan

Kurallar:

  • randomRange, 0 veya daha büyük iki tam sayı alır. İlk sayı ikinciden büyük olmamalı.
  • Her öğeyi düz çift tırnak (") içine al ve virgülle ayır. Öğelerde boşluk olabilir, örneğin "Sonra tekrar sor".
  • randomItemPercentage içinde sayıyı iki noktadan hemen sonra, boşluk bırakmadan yaz. Sayılar ağırlıktır. 70, 25 ve 5 ile ilk öğe 100’de yaklaşık 70 kez gelir. randomItemPercentage, Değişken ekle menüsünde yok. Kendin yaz.

{{request("https://...")}} bir web adresinden (API) veri alır ve yanıta koyar. Bir şaka, bir oyun rütbesi veya herkese açık bir API’nin döndürdüğü başka herhangi bir şeyi göstermek için kullan.

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

KickBot adresi açar, JSON yanıtını okur ve text alanını yazar. Örneğin: The praying mantis is the only insect that can turn its head.

Nasıl çalışır:

  • Bir alan seç. Yolu kapanış parantezinden sonra ekle. Adlar için nokta, liste öğeleri için [0] kullan, örneğin .data[0].name. Yol yoksa veya yol yanıtta bulunmuyorsa KickBot yanıtın tamamını yazar.
  • Adreste değişken kullan. Örneğin {{request("https://example.com/rank?user={{sender.username}}").rank}}. KickBot değeri yerine koyar ve web adresi için güvenli hâle getirir (boşluk %20 olur). İstek içinde istek kullanılamaz.
  • Sadece GET istekleri. KickBot gövde (body) veya başlık (header) gönderemez. API bir anahtar istiyorsa anahtarı adrese sorgu parametresi olarak koy.
  • Sınırlar. Sadece herkese açık internetteki http ve https adresleri. KickBot yanıt için en fazla 3 saniye bekler, bu yüzden kısa bir yanıtla hızlı yanıt veren bir API kullan.

Bu değişkenler çalışır ama Değişken ekle menüsünde yoktur.

DeğişkenNe yazarÖrnek çıktı
{{user}}İzleyicinin adı, büyük harfleriyleKickBotDev
{{sender.fullUsername}}Başında @ olan izleyici adı@KickBotDev
{{commands}}Açık olan tüm komutlar, virgülle ayrılmışcommands, followage, lurk, me, so, welcome, discord

Hazır !commands komutu {{commands}} kullanır. Yanıtı Enabled commands: {{commands}} şeklindedir.

  • İki yerine tek parantez. {sender.username} metin olarak kalır. {{sender.username}} kullan.
  • Yanlış yazılmış bir ad. {{sender.name}} gibi bilinmeyen bir değişken, komutun yanıt yazmasını engeller. Yazımı bu sayfayla karşılaştır.
  • Kıvrık tırnaklar. randomItem ve request düz tırnak (") ister. Bazı telefonlar ve metin editörleri bunları kıvrık tırnağa (“ ”) çevirir. Emin olmak için tırnakları panelde yaz.
Kick'te followage komutu nasıl yapılır?

KickBot’ta her kanalda açık olan hazır bir !followage komutu var. Kendi komutunu yapmak için @{{sender.username}} has followed for {{sender.followage}} gibi bir yanıtla bir komut ekle.

Bir komutta izleyicinin adını nasıl gösteririm?

Kanal bağlantısındaki ad için {{sender.username}}, büyük harfleriyle ad için {{user}} kullan. Kick’in bunu etiket olarak göstermesini istiyorsan başına @ ekle, örneğin @{{sender.username}}.

Bir komut izleyici sayımı veya yayın başlığımı gösterebilir mi?

Evet. {{stream.viewers}} ve {{stream.title}} kullan. Sen yayındayken çalışırlar.