Skip to content

External

Streamers in the Kacky streamer program can link their Twitch chat bot to kacky.gg. Then their mods save Twitch clips of the streamer's finishes from chat, and viewers ask for them in chat. The clips show on kacky.gg: on each map page, on the maps page, and on the streamer's own clips page.

You must be in the streamer program. See Streamers and VIP.

Finish clips from Twitch chat

1. Make your chat key

  1. Log in to kacky.gg and open your profile.
  2. Find the Chat commands card.
  3. Click Make a chat key.
  4. Copy the key now. The site shows it only once.

Keep your key out of chat

Anyone with your key can change your clips. Never post the key or the commands in Twitch chat. Each command holds the key.

2. Add the commands to your chat bot

  1. On the Chat commands card, pick your bot: Nightbot, StreamElements or Fossabot.
  2. Copy each command. Right after you make a key, the commands will show it. Later the commands show a placeholder instead. Paste your key in the Your chat key box to fill it in, or replace the placeholder with your key by hand. The key stays in your browser.
  3. Add each command as a custom command on the bot's website:
    • Nightbot: Commands > Custom > New Command > Response
    • StreamElements: Chatbot > Chat commands > Custom commands > Add new command > Start from scratch > Reply
    • Fossabot: Commands > Create > Response
  4. Make the !add_fin and !del_fin commands mod-only:
    • Nightbot: set Required User-Level to Moderator.
    • StreamElements: set User level to Moderator.
    • Fossabot: open the command's Conditions tab, then pick Moderator under Roles.

You can give the commands other names in your bot. They work the same.

The commands for each bot

A mod can add the commands too, if the streamer gives them the key. Paste the key in the Chat key box to fill it into every command, or replace YOUR_CHAT_KEY by hand. Then pick the bot and copy each command.

The key stays in this browser. It is never sent anywhere.

!fin

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/fin?q=$(querystring))

!clip

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clip?q=$(querystring))

!clips

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clips)

!last_fin

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/last_fin)

!nextmaps

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/nextmaps?q=all%203)

!when

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/when?q=$(querystring))

!add_fin Required User-Level: Moderator

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/add_fin?q=$(querystring)&by=$(user))

!del_fin Required User-Level: Moderator

$(urlfetch https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/del_fin?q=$(querystring))

!fin

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/fin?q=${queryescape ${1:}}}

!clip

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clip?q=${queryescape ${1:}}}

!clips

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clips}

!last_fin

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/last_fin}

!nextmaps

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/nextmaps?q=all%203}

!when

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/when?q=${queryescape ${1:}}}

!add_fin User level: Moderator

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/add_fin?q=${queryescape ${1:}}&by=${sender}}

!del_fin User level: Moderator

${customapi.https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/del_fin?q=${queryescape ${1:}}}

!fin

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/fin?q=$(querystring))

!clip

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clip?q=$(querystring))

!clips

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/clips)

!last_fin

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/last_fin)

!nextmaps

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/nextmaps?q=all%203)

!when

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/when?q=$(querystring))

!add_fin Roles: Moderator

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/add_fin?q=$(querystring)&by=$(user))

!del_fin Roles: Moderator

$(customapi https://api.kacky.gg/v1/chat/YOUR_CHAT_KEY/del_fin?q=$(querystring))

3. Use the commands

Type in chat Who What it does
!add_fin 157 and the clip or highlight link Mods Saves your clip of map 157. Run it again to replace the clip.
!del_fin 157 Mods Removes your clip of map 157.
!fin 157 Anyone Posts your clip of map 157.
!clip 157 Anyone Posts the GPS video of map 157 with its tags. A map without GPS gets a random streamer's clip.
!clips Anyone Posts a link to your clips page on kacky.gg.
!last_fin Anyone Posts the clip your mods saved last, of any map. It works between events too.
!nextmaps Anyone Posts when your next 3 favorite maps play, of all types.
!when 157 Anyone Posts when map 157 plays next, and on which server.

A map number with a # in front of it works too.

When maps play next

!nextmaps reads the maps you marked as favorites in game. The command you copy always shows all types and 3 maps, so chat types only !nextmaps. The all%203 at the end of its URL sets this. Change it to pick other favorite types (generic, easy, medium, hard, impossible, or all) and a count from 1 to 5. The colors the favorites have in game work too: white is generic, green easy, yellow medium, red hard and blue impossible. Put %20 or a comma between the words: hard,impossible,5 or red,blue,5.

To let chat pick each time, replace all%203 with your bot's text variable, the one !fin uses: $(querystring) on Nightbot and Fossabot, ${queryescape ${1:}} on StreamElements. Then !nextmaps hard,impossible 5 works in chat. With nothing after it, the command shows all types and 5 maps.

!when takes one map number, with kr or kx in front of it if you want one family.

The answer is one line:

🟢 #112 S3 live, 4:12 left · 🟡 #87 S1 in 1:05 · 🔴 #131 S3 in 14:52

  • 🟢 live: the map is on that server now. The time is what is left of it.
  • 🟡 next: the map is next on that server.
  • 🔴 later: the map is further down that server's playlist.

A map on more than one server shows only once, on the server where it comes first. Only public edition servers count. Hunting servers play maps in the order players queue them, so the commands leave them out, and between editions they answer that no edition is running. The times are estimates. The next map counts 20 seconds after the current map ends. The real switch is usually a little later, so you arrive early rather than late. Each map after that adds its time limit plus 60 seconds for the podium and loading. An admin skip or timer change moves the times.

Rules for saving a clip

  • A Kacky event must be running: a live edition or a hunting server.
  • You need an online finish on that map. Offline finishes do not count. See Records vs Finishes.
  • The link must be a Twitch clip or a Twitch highlight from your own channel. Links to other sites and clips from other channels are refused.
  • A past broadcast is refused, even though its link looks like a highlight link. Twitch deletes past broadcasts after a few weeks. Make a highlight of the finish and save that.
  • You get one clip per map in each event. A new save replaces the old clip.
  • A new clip can take a minute to show up on Twitch. If chat says that Twitch has no clip at that link, wait a minute and try again.

When two events have the same map number

Kacky Reloaded and Kacky Remixed both use map numbers from 1 upwards. If you have finishes on both maps, chat asks you to pick one. Put kr (Kacky Reloaded) or kx (Kacky Remixed) in front of the number, for example !add_fin kx 157 and the clip link, or !fin kr 157.

What the bot can answer

Bot says What to do
No online finish on #157. Finish the map online first.
No Kacky event is running right now. Save clips during an edition or while hunting runs.
No running Kacky event has a map #157. Check the map number.
Map #157 is in KR and KX. Name one first, like: kr 157 Put kr or kx in front of the number.
No Kacky edition is running right now. The commands work while an edition runs.
#157 is not on any server. The map is not in the playlist of any public server right now.
No hard favorites on a server right now. Mark more favorites in game, or pick other types.
Name favorite types (...) and a count from 1 to 5 Check the words after !nextmaps.
That clip is from another channel. Clip your own stream.
Only Twitch clip and highlight links are accepted. Use a Twitch clip or highlight link.
That video is not a highlight. Make a highlight of the finish, or clip it.
This kacky.gg key is not valid. Make a new key and update the commands in your bot.
This key's streamer is not in the Kacky streamer program. Your streamer grant ended. Contact the Kacky team.
This is not a kacky.gg command. Copy the command again from your profile.
Too many kacky.gg commands. Try again in a minute. Wait a minute.

Your clips on kacky.gg

  • Each map page has a Streamer clips tab with every streamer's clip of that map.
  • On the maps page, a map with clips shows a chip. The chip opens the map's GPS videos and clips.
  • Your clips page is on your player page. The !clips command posts its link.
  • To remove a clip there, log in and open the clip's ⋯ menu.

If your key leaks

Open the Chat commands card on your profile and click Replace key. The old key stops working at once. Then update every command in your bot with the new key.