ตัวแปรคำสั่งของ KickBot (followage, สุ่ม, API)

เปิดในแดชบอร์ด

ตัวแปรคือตัวยึดตำแหน่งในข้อความตอบของคำสั่ง ทุกครั้งที่คำสั่งทำงาน KickBot จะใส่ค่าจริงในขณะนั้นแทน เช่น ข้อความตอบของ !followage ที่มี {{sender.followage}} จะโพสต์ว่าผู้ชมติดตามช่อง Kick ของคุณมานานแค่ไหน ตัวแปรใช้ได้ในคำสั่งที่กำหนดเองและในข้อความตอบของคำสั่งในตัว

เขียนตัวแปรแต่ละตัวด้วยวงเล็บปีกกาสองชั้นทั้งสองข้าง ตามที่แสดงในหน้านี้ทุกตัวอักษร ตัวพิมพ์ใหญ่และเล็กมีผล: {{sender.username}} ใช้ได้ แต่ {{Sender.Username}} ใช้ไม่ได้

เพิ่มตัวแปรลงในข้อความตอบ

เปิดคำสั่งในหน้าคำสั่งที่กำหนดเอง หรือคลิก เพิ่มคำสั่ง
ใต้กล่อง คำตอบ ใช้ แทรกตัวแปร เลือกกลุ่ม (ผู้ส่ง สตรีมเมอร์ ผู้ใช้ที่แท็ก / พารามิเตอร์ สตรีม สุ่ม หรือ คำขอ API)
คลิกตัวแปร KickBot จะใส่ตัวแปรตรงตำแหน่งเคอร์เซอร์

ตัวอย่าง ในแชท Kick จะแสดงค่าตัวอย่าง คุณจึงเช็กข้อความตอบได้ก่อนบันทึก

เมนูแทรกตัวแปรที่เปิดกลุ่มสตรีมอยู่ และตัวอย่างที่มีค่าตัวอย่างของ followage หมวดหมู่ และจำนวนผู้ชม — ตัวอย่างจะใส่ค่าตัวอย่างให้ ส่วนในแชท KickBot จะใช้ค่าจริง

ตัวอย่างด้านล่างใช้ผู้ชมชื่อ KickBotDev ในช่องชื่อ yourchannel

ผู้ส่ง

ผู้ชมที่พิมพ์คำสั่ง

ตัวแปร	โพสต์อะไร	ตัวอย่างผลลัพธ์
`{{sender.username}}`	ชื่อผู้ชมตามลิงก์ช่อง (ตัวพิมพ์เล็ก)	`kickbotdev`
`{{sender.followers}}`	จำนวนผู้ติดตามของช่องผู้ชมเอง	`128`
`{{sender.followage}}`	ผู้ชมติดตามช่องของคุณมานานแค่ไหน	`4 months 12 days`
`{{sender.url}}`	ลิงก์ไปที่ช่อง Kick ของผู้ชม	`https://kick.com/kickbotdev`
`{{sender.bio}}`	ไบโอในโปรไฟล์ Kick ของผู้ชม	`Variety streamer from Texas`
`{{sender.instagram}}`	ชื่อ Instagram ในโปรไฟล์ Kick ของผู้ชม	`yourhandle`
`{{sender.twitter}}`	ชื่อ X (Twitter) ในโปรไฟล์ Kick ของผู้ชม	`yourhandle`
`{{sender.youtube}}`	YouTube ในโปรไฟล์ Kick ของผู้ชม	`yourhandle`
`{{sender.discord}}`	Discord ในโปรไฟล์ Kick ของผู้ชม	`discord.gg/your-server-code`
`{{sender.tiktok}}`	ชื่อ TikTok ในโปรไฟล์ Kick ของผู้ชม	`yourhandle`
`{{sender.facebook}}`	ชื่อ Facebook ในโปรไฟล์ Kick ของผู้ชม	`yourhandle`

Followage บน Kick

ถ้าผู้ชมไม่ได้ติดตามช่องของคุณ KickBot จะโพสต์ข้อความนี้แทนข้อความตอบของคุณ: @kickbotdev is not following @yourchannel

คำสั่งในตัว !followage ใช้ตัวแปรนี้ ข้อความตอบคือ @{{sender.username}} has been following for {{sender.followage}} ในแชทจึงออกมาเป็น @kickbotdev has been following for 4 months 12 days

สตรีมเมอร์

ตัวคุณ เจ้าของช่อง

ตัวแปร	โพสต์อะไร	ตัวอย่างผลลัพธ์
`{{streamer.username}}`	ชื่อช่องของคุณตามลิงก์ช่อง	`yourchannel`
`{{streamer.followers}}`	จำนวนผู้ติดตามของคุณ	`2450`
`{{streamer.url}}`	ลิงก์ไปที่ช่อง Kick ของคุณ	`https://kick.com/yourchannel`
`{{streamer.bio}}`	ไบโอ Kick ของคุณ	`Chill streams every night`
`{{streamer.instagram}}`	ชื่อ Instagram ในโปรไฟล์ Kick ของคุณ	`yourhandle`
`{{streamer.twitter}}`	ชื่อ X (Twitter) ในโปรไฟล์ Kick ของคุณ	`yourhandle`
`{{streamer.youtube}}`	YouTube ในโปรไฟล์ Kick ของคุณ	`yourhandle`
`{{streamer.discord}}`	Discord ในโปรไฟล์ Kick ของคุณ	`discord.gg/your-server-code`
`{{streamer.tiktok}}`	ชื่อ TikTok ในโปรไฟล์ Kick ของคุณ	`yourhandle`
`{{streamer.facebook}}`	ชื่อ Facebook ในโปรไฟล์ Kick ของคุณ	`yourhandle`

ผู้ใช้ที่แท็กและพารามิเตอร์

ข้อความหรือชื่อที่ผู้ชมพิมพ์ต่อท้ายคำสั่ง เช่น ผู้ชมพิมพ์ !so @SomeChannel หรือ !hug @friend

ตัวแปร	โพสต์อะไร	ตัวอย่างสำหรับ `!so @SomeChannel great stream`
`{{param}}`	ข้อความทั้งหมดหลังคำสั่ง	`@SomeChannel great stream`
`{{taggedUser.username}}`	ชื่อหลัง `@` ตัวแรก	`SomeChannel`
`{{taggedUser.url}}`	ลิงก์ไปที่ช่องที่ถูกแท็ก	`https://kick.com/SomeChannel`
`{{taggedUser.followers}}`	จำนวนผู้ติดตามของช่องที่ถูกแท็ก	`57`
`{{taggedUser.followage}}`	ผู้ชมที่ถูกแท็กติดตามช่องของคุณมานานแค่ไหน	`2 months 3 days`

ผู้ใช้ที่ถูกแท็กก็มีตัวแปรโปรไฟล์เช่นกัน: {{taggedUser.bio}}, {{taggedUser.instagram}}, {{taggedUser.twitter}}, {{taggedUser.youtube}}, {{taggedUser.discord}}, {{taggedUser.tiktok}} และ {{taggedUser.facebook}}

ถ้าผู้ชมไม่ได้แท็กใคร {{taggedUser.username}} จะว่าง ถ้าชื่อที่แท็กไม่ใช่ช่อง Kick ตัวแปรที่ต้องดึงข้อมูล (ผู้ติดตาม ไบโอ และช่องโปรไฟล์อื่น ๆ) จะใช้ไม่ได้ และ KickBot จะโพสต์ 404 tagged user not found แทนข้อความตอบ

ตัวอย่าง: คำสั่งในตัว !so (ชาวต์เอาต์) มีข้อความตอบ Go check @{{taggedUser.username}}'s channel! {{taggedUser.url}}

สตรีม

สตรีมปัจจุบันของคุณ ตัวแปรเหล่านี้ใช้ได้ระหว่างที่คุณกำลังไลฟ์

ตัวแปร	โพสต์อะไร	ตัวอย่างผลลัพธ์
`{{stream.title}}`	ชื่อสตรีมของคุณ	`Chill stream, come hang out`
`{{stream.category}}`	หมวดหมู่สตรีมของคุณ	`Just Chatting`
`{{stream.viewers}}`	จำนวนผู้ชมตอนนี้	`342`

ระหว่างที่คุณออฟไลน์ KickBot อ่านข้อมูลสตรีมไม่ได้ คำสั่งที่มีตัวแปรเหล่านี้จึงจะไม่โพสต์ข้อความตอบตามปกติ แต่อาจโพสต์ 404 stream not found แทน

สุ่ม

ใช้กับเกมและคำสั่งสนุก ๆ ทุกครั้งที่ใช้คำสั่งจะได้ค่าใหม่

ตัวแปร	โพสต์อะไร	ตัวอย่างผลลัพธ์
`{{randomRange(1,100)}}`	จำนวนเต็มตั้งแต่ตัวเลขแรกถึงตัวเลขที่สอง รวมทั้งสองตัว	`42`
`{{randomItem("rock","paper","scissors")}}`	1 รายการจากลิสต์ ทุกรายการมีโอกาสเท่ากัน	`paper`
`{{randomItemPercentage("common":70,"rare":25,"legendary":5)}}`	1 รายการจากลิสต์ ตามโอกาสที่คุณกำหนดให้แต่ละรายการ	`common`

กฎ:

randomRange รับจำนวนเต็ม 2 ตัวที่มีค่า 0 ขึ้นไป ตัวแรกต้องไม่มากกว่าตัวที่สอง
ใส่แต่ละรายการในเครื่องหมายคำพูดแบบตรง (") คั่นด้วยจุลภาค รายการมีเว้นวรรคได้ เช่น "Ask again later"
ใน randomItemPercentage ให้ใส่ตัวเลขต่อจากโคลอนทันที ไม่ต้องเว้นวรรค ตัวเลขคือน้ำหนัก ถ้าใช้ 70, 25 และ 5 รายการแรกจะออกประมาณ 70 ครั้งใน 100 ครั้ง randomItemPercentage ไม่มีในเมนู แทรกตัวแปร ต้องพิมพ์เอง

คำขอ API

{{request("https://...")}} ดึงข้อมูลจากที่อยู่เว็บ (API) มาใส่ในข้อความตอบ ใช้แสดงมุก แรงก์เกม หรืออะไรก็ได้ที่ API สาธารณะส่งกลับมา

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

KickBot จะเปิดที่อยู่นั้น อ่านคำตอบ JSON แล้วโพสต์ฟิลด์ text เช่น The praying mantis is the only insect that can turn its head

วิธีการทำงาน:

เลือกฟิลด์ ใส่ path ต่อท้ายวงเล็บปิด ใช้จุดสำหรับชื่อ และ [0] สำหรับรายการในลิสต์ เช่น .data[0].name ถ้าไม่ใส่ path หรือ path นั้นไม่มีในคำตอบ KickBot จะโพสต์คำตอบทั้งหมด
ใช้ตัวแปรในที่อยู่ได้ เช่น {{request("https://example.com/rank?user={{sender.username}}").rank}} KickBot จะใส่ค่าให้และแปลงให้ปลอดภัยสำหรับที่อยู่เว็บ (เว้นวรรคจะกลายเป็น %20) ใส่คำขอซ้อนในคำขอไม่ได้
ใช้ได้แค่คำขอแบบ GET KickBot ส่ง body หรือ header ไม่ได้ ถ้า API ต้องใช้คีย์ ให้ใส่คีย์ในที่อยู่เป็น query parameter
ขีดจำกัด ใช้ได้เฉพาะที่อยู่ http และ https บนอินเทอร์เน็ตสาธารณะ KickBot รอคำตอบได้สูงสุด 3 วินาที จึงควรใช้ API ที่ตอบเร็วและคำตอบสั้น

ตัวแปรอื่น ๆ

ตัวแปรเหล่านี้ใช้ได้ แต่ไม่มีในเมนู แทรกตัวแปร

ตัวแปร	โพสต์อะไร	ตัวอย่างผลลัพธ์
`{{user}}`	ชื่อผู้ชมตามตัวพิมพ์ใหญ่เล็กจริง	`KickBotDev`
`{{sender.fullUsername}}`	ชื่อผู้ชมที่มี `@` นำหน้า	`@KickBotDev`
`{{commands}}`	คำสั่งทั้งหมดที่เปิดอยู่ คั่นด้วยจุลภาค	`commands, followage, lurk, me, so, welcome, discord`

คำสั่งในตัว !commands ใช้ {{commands}} ข้อความตอบคือ Enabled commands: {{commands}}

ข้อผิดพลาดที่พบบ่อย

ใช้วงเล็บชั้นเดียวแทนสองชั้น {sender.username} จะค้างเป็นข้อความ ให้ใช้ {{sender.username}}
สะกดชื่อผิด ตัวแปรที่ไม่รู้จัก เช่น {{sender.name}} จะทำให้คำสั่งไม่โพสต์ข้อความตอบ เช็กการสะกดกับหน้านี้
เครื่องหมายคำพูดแบบโค้ง randomItem และ request ต้องใช้เครื่องหมายคำพูดแบบตรง (") มือถือและโปรแกรมแก้ข้อความบางตัวเปลี่ยนเป็นแบบโค้ง (“ ”) ให้อัตโนมัติ พิมพ์ในแดชบอร์ดโดยตรงจะปลอดภัยกว่า

คำถามที่พบบ่อย

ทำคำสั่ง followage บน Kick ยังไง?

KickBot มีคำสั่งในตัว !followage ที่เปิดให้ทุกช่องอยู่แล้ว ถ้าจะทำเอง ให้เพิ่มคำสั่งที่มีข้อความตอบแบบ @{{sender.username}} has followed for {{sender.followage}}

แสดงชื่อผู้ชมในคำสั่งยังไง?

ใช้ {{sender.username}} สำหรับชื่อตามลิงก์ช่อง หรือ {{user}} สำหรับชื่อตามตัวพิมพ์ใหญ่เล็กจริง ใส่ @ ข้างหน้าถ้าอยากให้ Kick แสดงเป็นการแท็ก เช่น @{{sender.username}}

คำสั่งแสดงจำนวนผู้ชมหรือชื่อสตรีมได้ไหม?

ได้ ใช้ {{stream.viewers}} และ {{stream.title}} ใช้ได้ระหว่างที่คุณกำลังไลฟ์