# Vlastní příkazy

> Vytvoř si s KickBotem vlastní příkazy do chatu na Kicku, třeba !discord nebo !socials. Vyber, kdo je může používat, přidej cooldown a použij proměnné pro živá data.

Source: https://kickbot.com/cs/docs/chat-bot/custom-commands

Vlastní příkaz je příkaz do chatu, který si vytvoříš ty. Když ho divák napíše do tvého chatu na Kicku, třeba `!discord`, KickBot pošle odpověď, kterou máš uloženou. Příkazy do chatu na Kicku vytváříš a upravuješ na stránce [Vlastní příkazy](https://kickbot.com/dashboard/commands) v dashboardu KickBotu, v části **Chatbot**.

Potřebuješ účet v KickBotu s propojeným Kick kanálem a KickBot musí být [moderátor na tvém kanálu](https://kickbot.com/cs/docs/getting-started/add-kickbot-as-moderator).

![Stránka Vlastní příkazy se dvěma vlastními příkazy a šesti vestavěnými příkazy](https://kickbot.com/docs/images/chat-bot/custom-commands/01-commands-page.webp "Tvoje vlastní příkazy jsou nahoře. Vestavěné příkazy mají vlastní seznam pod nimi.")

Stránka má dva seznamy:

- **Tvoje příkazy**: příkazy, které máš vytvořené. Název, odpověď i všechna nastavení vybíráš ty.
- **Vestavěné příkazy**: šest hotových příkazů, třeba `!followage` a `!lurk`. Do limitu tarifu zdarma se nepočítají. Viz [Vestavěné příkazy](https://kickbot.com/cs/docs/chat-bot/built-in-commands).

## Přidání příkazu

1. Otevři [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands).
2. Klikni na **Přidat příkaz**. Vpravo se otevře panel.
3. Do pole **Příkaz** napiš název bez `!`. KickBot ho přidá sám. Třeba z `discord` vznikne příkaz `!discord`.
4. Do pole **Odpověď** napiš zprávu, kterou KickBot pošle. Přes **Vložit proměnnou** můžeš přidat [proměnné](https://kickbot.com/cs/docs/chat-bot/command-variables).
5. Vyber **Kdo ho může používat** a podle potřeby nastav **Cooldown**.
6. Klikni na **Uložit**.

Rámeček **V chatu na Kicku** nahoře ukazuje už při psaní, jak bude příkaz v chatu vypadat. Proměnné tam mají ukázkové hodnoty. Tento náhled vidíš jen ty.

![Panel Nový příkaz s příkazem discord, odpovědí s proměnnou a náhledem v chatu na Kicku](https://kickbot.com/docs/images/chat-bot/custom-commands/02-new-command.webp "Náhled nahoře ukazuje odpověď s ukázkovými hodnotami.")

## Nastavení

| Nastavení | Co dělá | Limity a výchozí hodnota |
| --- | --- | --- |
| **Příkaz** | Slovo, které diváci píšou za `!`. | 1 až 20 znaků, bez mezer. Na velkých písmenech nezáleží: `!Discord` i `!discord` spustí stejný příkaz. |
| **Odpověď** | Zpráva, kterou KickBot pošle. | Až 500 znaků. Může obsahovat [proměnné](https://kickbot.com/cs/docs/chat-bot/command-variables). |
| **Kdo ho může používat** | **Všichni**, **Suby**, **VIP**, **Modi**, nebo jejich kombinace. | Výchozí **Všichni**. |
| **Každý divák čeká** | Cooldown na uživatele: jak dlouho jeden divák čeká, než může příkaz použít znovu. | 0 až 300 sekund, po 5 sekundách. Výchozí 0. |
| **Všichni čekají** | Globální cooldown: jak dlouho čeká celý chat poté, co příkaz někdo použije. | 0 až 300 sekund, po 5 sekundách. Výchozí 0. |
| **Příkaz je zapnutý** | Zapne nebo vypne příkaz, aniž by ho smazal. | U nových příkazů zapnuto. |

## Kdo může příkaz používat

S volbou **Všichni** může příkaz použít každý divák. Když je zapnuté **Všichni**, na ostatních skupinách nezáleží.

Když chceš příkaz omezit, vypni **Všichni** a vyber jednu nebo víc skupin. Když třeba vybereš **Suby** a **Modi**, můžou ho používat jen předplatitelé a moderátoři. Ostatní diváci odpověď nedostanou.

Ty (streamer) můžeš vždycky použít každý příkaz. Když vypneš všechny skupiny, nemůže ho použít nikdo kromě tebe a panel ukáže upozornění.

![Tlačítka Kdo ho může používat se zapnutými Suby a Modi a dvě pole pro cooldown](https://kickbot.com/docs/images/chat-bot/custom-commands/03-who-cooldown.webp "Vybrané Suby a Modi. Cooldowny jsou pod nimi.")

> **Příkazy jen pro mody:** Příkaz jen pro skupinu **Modi** je dobrý způsob, jak nástroje jako shout-out držet mimo dosah běžných diváků. Proto je vestavěný příkaz `!so` nastavený na **Modi**. Vlastní příkazy Kicku pro moderátory, třeba `/ban` a `/timeout`, najdeš na stránce [Moderace](https://kickbot.com/cs/docs/chat-bot/moderation#kicks-own-moderator-tools).

## Cooldowny

Cooldown zastaví spam, když stejný příkaz píše hodně diváků.

- **Každý divák čeká** platí pro jednoho diváka. S 30 sekundami může divák použít `!discord` jednou za 30 sekund. Ostatní diváci ho můžou použít i tak.
- **Všichni čekají** platí pro celý chat. S 10 sekundami KickBot odpoví na `!discord` nejvýš jednou za 10 sekund, ať ho napíše kdokoli.

Tebe a tvoje moderátory cooldowny nezdržují.

## Úprava, vypnutí nebo smazání příkazu

- Přepínačem na řádku příkaz zapneš nebo vypneš. Změna se uloží hned.
- Kliknutím na řádek příkaz otevřeš. Změň libovolné pole a klikni na **Uložit**.
- Když chceš příkaz smazat, otevři ho, klikni na **Smazat** a pak na **Smazat příkaz**. Nejde to vrátit zpět.

Vestavěné příkazy smazat nejde. Můžeš je vypnout nebo jim změnit odpověď.

## Limit tarifu zdarma

> **Note:** V tarifu zdarma může být zapnuto najednou až 5 vlastních příkazů. Vytvořit jich můžeš víc, ale ty navíc zůstanou vypnuté. Vestavěné příkazy se do tohoto limitu nepočítají. Premium limit nemá.

## Ukázky užitečných příkazů

Zkopíruj si je a uprav pro svůj kanál. Text jako `discord.gg/your-server-code` je jen zástupný.

| Příkaz | Odpověď |
| --- | --- |
| `!discord` | `Přidej se na Discord: discord.gg/your-server-code` |
| `!socials` | `Sleduj @{{streamer.username}} na X: x.com/yourhandle` |
| `!schedule` | `Živě v út, čt a so v 19:00.` |
| `!tip` | `Podpoř stream: kickbot.com/tips/yourchannel` |
| `!title` | `Dnes: {{stream.title}}` |
| `!dice` | `@{{sender.username}} hází {{randomRange(1,6)}}` |
| `!8ball` | `{{randomItem("Ano","Ne","Zeptej se později")}}` |
| `!hug` | `{{sender.username}} objímá {{taggedUser.username}}` (diváci píšou `!hug @name`) |

Celý seznam proměnných a co která vypíše najdeš na stránce [Proměnné příkazů](https://kickbot.com/cs/docs/chat-bot/command-variables). Další nápady pro svůj kanál najdeš v návodu [Užitečné příkazy do chatu na Kicku](https://kickbot.com/cs/guides/grow/kick-chat-commands).

## Řešení problémů

Když příkaz do chatu nic nepošle:

- **KickBot není moderátor.** To je nejčastější příčina. Viz [Přidej KickBot jako moderátora](https://kickbot.com/cs/docs/getting-started/add-kickbot-as-moderator).
- **Příkaz je vypnutý.** Zkontroluj přepínač na jeho řádku. V tarifu zdarma je nový příkaz vypnutý, když už máš zapnutých 5 příkazů.
- **Divák není ve skupině, která ho může používat.** Třeba příkaz jen pro **Suby** běžným divákům neodpoví.
- **Ještě běží cooldown.** Počkej, až cooldown skončí, nebo testuj jako streamer.
- **Název používá jiná funkce.** Když je zapnutý [příkaz pro klipy](https://kickbot.com/cs/docs/chat-bot/clip-command), `!clip` vždycky vytvoří klip, takže vlastní příkaz `!clip` se nespustí.

## Časté dotazy

**Jak přidám příkazy na Kick?**

Použij chatbota. S KickBotem otevři [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands), klikni na **Přidat příkaz**, napiš název a odpověď a klikni na **Uložit**. Diváci pak můžou příkaz psát do tvého chatu.

**Můžou moji moderátoři vytvářet příkazy v KickBotu?**

Ano. Přidej je do svého týmu v KickBotu s oprávněním **Vlastní příkazy**. Pak se můžou přihlásit a měnit příkazy pro tvůj kanál. Viz [Správa týmu](https://kickbot.com/cs/docs/account/team).

**Kolik příkazů můžu mít?**

Vytvořit jich můžeš, kolik chceš. V tarifu zdarma může být zapnuto najednou 5 vlastních příkazů. Premium limit nemá. Vestavěné příkazy se nepočítají.

**Může příkaz ukázat jméno diváka nebo jak dlouho sleduje kanál?**

Ano. Dej do odpovědi proměnné jako `{{sender.username}}` nebo `{{sender.followage}}`. KickBot při spuštění příkazu doplní aktuální hodnotu. Viz [Proměnné příkazů](https://kickbot.com/cs/docs/chat-bot/command-variables).