🤖 Jak funguje náš Discord Bot?

✨ Rychlý start: Jak přidat bota na server a zpřístupnit všechny příkazy

Abyste mohli našeho bota plně využívat, stačí dva kroky:

Pozvěte bota na server

1. K pozvání bota použijte tento odkaz.
2. Vyberte server a potvrďte oprávnění. Vždy požadujeme jen ta, která jsou nezbytná pro plné fungování. Při nezvolení všech doporučených oprávnění se může stát, že některé moduly nemusí správně fungovat.

Pozvat bota na server

Zpřístupněte si všechny /slash příkazy pro svůj profil

Pro plné zobrazení všech /slash příkazů přímo v Discordu doporučujeme provést ověření pro váš profil:

1. V seznamu členů na Discordu klikněte na našeho bota.
2. V okně bota klikněte na tlačítko „Přidat aplikaci".
3. Následně vyberte možnost „Přidat do mých aplikací".

✅ Poté se vám budou automaticky zobrazovat všechny dostupné příkazy, když začnete psát / do chatu.

0️⃣ Základní nastavení: Oznámení o aktualizacích, provedených zásazích bota apod.

1. Doporučujeme nastavit kanál pro oznámení o aktualizacích a zprávách od bota. Bot vám do vybraného kanálu bude posílat aktualizace, provedené akce a důležité informace (Zachycení scamu, RAID útok a další důležité informace).

• Příkaz: /modchannel (vyžaduje oprávnění „Spravovat zprávy")
• Jak: Napište do chatu /modchannel a vyberte kanál. Příklad: /modchannel #oznameni-bota

2. Doporučujeme nastavit jazyk serveru ve kterém bude bot na serveru komunikovat.

• Příkaz: /language server

1️⃣ Start Bota: Co dělá hned po spuštění?

Když se náš bot zapne a připojí k Discord serveru, provede sérii kritických kontrol a akcí:

• 🌐 Vnímání událostí: Bot si všímá téměř všeho, co se na serveru děje — připojení, odchody, zprávy, hlasové kanály.
• ✅ Registrace příkazů: Všechny /slash příkazy se „nahlásí" Discordu, aby je viděl každý uživatel.
• ⚙️ Zapnutí modulů (Cogů): Všechny jeho funkce, které nazýváme moduly, se aktivují a jsou připraveny k použití (např. moderování, RSS novinky, uvítání).
• ⌚ Nastavení času: Pro správnou funkci připomenutí, narozenin a plánovaných zpráv používá čas pro Českou republiku.
• 🐛 Sledování chyb: Bot aktivně monitoruje a zaznamenává potenciální chyby, které automaticky odesílá vývojářům k rychlé nápravě.
• ...a mnoho dalšího

2️⃣ Paměť: Bot si vše pamatuje

Náš bot ukládá veškerá důležitá data, aby mohl fungovat i po restartu. Vše se zapisuje do databáze, čímž se žádná data neztratí a jsou vždy k dispozici.

3️⃣ Akce a Reakce: Jak bot funguje v provozu?

CZbot pracuje na dvou hlavních principech: reaguje na události a spouští automatické úkoly.

⚡ Reakce na události (V reálném čase)

• Příchozí zprávy: Kontrola zakázaných slov, udělování XP bodů, zpracování /slash příkazů a automatické překlady.
• Vstup/Výstup členů: Odesílání uvítacích/odchodových zpráv a automatické přidělování rolí.
• Hlasové kanály: Hlídání a vytváření dočasných hlasových kanálů.
• Tresty: Posílání soukromých zpráv o varování, zabanování nebo umlčení.
• ...a mnoho dalšího

⏲️ Automatické úkoly (Běží samy)

• RSS Čtečka: Pravidelně kontroluje sledované weby a posílá nové články.
• Připomenutí a Schedules: Odesílá naplánované zprávy a připomenutí v přesně určený čas.
• Narozeniny: Odesílá přání uživatelům k narozeninám v přesně určený čas.
• ...a mnoho dalšího

4️⃣ Administrace: Webové záznamy a oprávnění

Oprávnění pro příkazy bota

Různé příkazy bota vyžadují různé úrovně oprávnění na serveru. Bot vždy zkontroluje, zda má uživatel potřebné oprávnění, a pokud ne, příkaz odmítne s chybovou hláškou.

Přístup k webovému dashboardu

Webový dashboard ověřuje oprávnění přímo přes Discord OAuth2. Přístup je povolen na základě těchto Discord permission bitů:

Webová stránka s moderátorskými záznamy

• Pro přehled všech varování, ztlumení a banů slouží speciální webová stránka: Moderátorské záznamy. Přístup k datům je veřejný a moderátoři do databáze vkládají data zcela dobrovolně.