Vytvoření aplikace na Discordu zabere zhruba pět minut a nevyžaduje programování: přihlaste se do Vývojářského portálu, stiskněte New Application, přidejte k ní bota, zapněte intenty, které potřebuje, vygenerujte token a sestavte pozvánkový odkaz. Všechno až do tohoto posledního kroku je jen vyplňování formulářů. Co s aplikací uděláte potom, zda napíšete vlastní kód, nebo token předáte hostingu, který za vás spouští sadu funkcí, je samostatné rozhodnutí.

Co je vlastně „aplikace na Discordu“

Aplikace je kontejner, který Discord vytváří pro cokoli, co na jeho platformě postavíte: název, ikona, client ID a volitelně k ní připojený uživatel bota. Samotná aplikace nic nedělá. Přihlašuje se, zprávy posílá a na příkazy odpovídá až uživatel bota, který je k ní připojen. Většina lidí používá slova „aplikace“ a „bot“ zaměnitelně, protože v praxi jedno vytvoříte kvůli druhému. Rozdíl je ale důležitý u OAuth2 scopes a oprávnění, protože ta se žádají jménem aplikace, nezadávají se ručně.

Krok za krokem

  1. Otevřete Vývojářský portál. Přejděte na discord.com/developers/applications a přihlaste se účtem, který má být vlastníkem bota.
  2. Stiskněte New Application. Dejte jí název. Ten se stane interním názvem aplikace; můžete ho později změnit, aniž to ovlivní cokoli, co už běží.
  3. Otevřete záložku Bot. Uživatel bota se přidá automaticky. Nastavte mu tady uživatelské jméno a nahrajte avatar; to se zobrazí na každém serveru, kam se připojí.
  4. Zapněte privilegované intenty, které potřebuje. V sekci Privileged Gateway Intents jsou Server Members Intent a Message Content Intent ve výchozím nastavení vypnuté. Bot, který čte text zpráv nebo reaguje na připojení a odchod členů, potřebuje zapnuté obojí, jinak se vůbec nepřihlásí.
  5. Stiskněte Reset Token. Discord token vygeneruje a zobrazí ho přesně jednou. Zkopírujte ho hned, neexistuje stránka, která by už existující token znovu ukázala, a druhé stisknutí Reset Token zneplatní to, co jste právě zkopírovali.
  6. Sestavte pozvánkový odkaz. Použijte URL Generator na záložce OAuth2, zaškrtněte scopes bot a applications.commands, zaškrtněte oprávnění, která bot opravdu potřebuje, a zkopírujte vygenerovaný odkaz.
  7. Pozvěte ho na server. Otevřete odkaz, vyberte server, který spravujete, a schvalte oprávnění, která vám Discord ukáže.

Chyby, na kterých se lidé zaseknou

  • Záměna názvu aplikace s uživatelským jménem bota. Mohou být různé. Přejmenování aplikace později nepřejmenuje bota; to se dělá na záložce Bot.
  • Ztráta tokenu dřív, než ho někam vložíte. Pokud zavřete kartu, než ho zkopírujete, nepanikařte, stačí znovu stisknout Reset Token a dostanete nový. Starý je prostě pryč.
  • Přeskočení intentů a pak divení, proč bot nejde online. Bot, jehož kód žádá privilegovaný intent, který není v portálu zapnutý, se nepřipojí v omezeném režimu. Discord přihlášení rovnou odmítne s chybou „disallowed intents“.
  • Žádání Administrátora v pozvánkovém odkazu ze zvyku. Funguje to, ale je to nejstrašnější obrazovka s oprávněními, kterou Discord může majiteli serveru ukázat, a častý důvod, proč je pozvánka odmítnuta. Zaškrtněte jen to, co bot používá.
A user's bot token runs on a Noxyr node and comes online as their own branded bot. Your token Noxyr node MyBot Online

Co s aplikací dělat dál

Jakmile máte aplikaci, uživatele bota a token, existují odtud dvě cesty. Můžete napsat nebo stáhnout kód bota a spouštět ho sami na vlastním počítači nebo hostingu. Tomu se věnuje náš průvodce bezplatným hostingem botů. Nebo můžete psaní kódu úplně přeskočit: vložíte token do služby, která pod identitou vašeho bota provozuje hotovou sadu funkcí. Přesně to dělá Vlastní bot v Noxyru: tickety, obchod, zabezpečení, soutěže, ověřování a další, vše odpovídá pod jménem a avatarem, které jste právě nastavili, a je hostované zdarma za hlas na Top.gg. Kompletní postup nastavení, včetně dvou zmíněných intentů, najdete v dokumentaci k Vlastnímu botovi.

Ať zvolíte kteroukoli cestu, aplikace, kterou jste právě vytvořili, je jediná věc, kterou kterákoli z nich potřebuje. Samotné vytvoření vás k žádnému směru nezavazuje.

Časté otázky

Potřebuji umět programovat, abych vytvořil aplikaci na Discordu? Ne. Vytvoření aplikace, uživatele bota a tokenu jsou kroky ovládané klikáním ve Vývojářském portálu. Programování přichází na řadu, jen pokud se rozhodnete chování bota napsat sami.

Jaký je rozdíl mezi client ID a tokenem bota? Client ID je veřejné, je v každém pozvánkovém odkazu a můžete ho bezpečně sdílet. Token je přihlašovací údaj: kdo ho má, může bota přihlásit. Zacházejte s ním jako s heslem.

Můžu aplikaci nebo bota později přejmenovat? Ano, název aplikace i uživatelské jméno bota lze kdykoli změnit ve portálu, aniž byste přišli o token, servery, na kterých je, nebo cokoli dalšího navázaného na jeho Discord ID uživatele.

Potřebuje každý bot privilegované intenty? Ne. Zapnout je musí jen boti, kteří čtou text zpráv (Message Content Intent) nebo potřebují data o připojení a odchodu členů a rolích (Server Members Intent). Jednoduchý bot jen s slash příkazy nepotřebuje ani jeden.

Je vytvoření aplikace na Discordu zdarma? Ano, vytvoření aplikace, vygenerování tokenu i pozvání kamkoli nic nestojí. Peníze může stát provoz kódu za tím, pokud nepoužijete bezplatný hosting nebo službu jako Vlastní bot od Noxyru.

Co když ztratím token nebo si myslím, že unikl? Vraťte se na záložku Bot a stiskněte Reset Token. Starý token okamžitě přestane fungovat všude, kde byl použit, a dostanete nový, který vložíte tam, kde je potřeba.

Jakmile vaše aplikace existuje, podívejte se na náš návod pozvánkové odkazy a OAuth2 scopes, jak takový odkaz správně sestavit, nebo si přidejte Noxyr zdarma a z nové aplikace udělejte plně fungujícího bota bez jediného řádku kódu.