Databáze řešení

K čemu slouží discord bot?

• Discord bot slouží k propojení ingame(herního) chatu s nějakou místností na Vašem discordu a naopak
• Možnost propojení ingame chatu více serverů. Pokud tedy máte například server s mapou Island a druhý s mapou Scorched, tak hráči mohou komunikovat mezi sebou i když nejsou na stejném serveru 
• Zobrazovat počet online hráčů včetně jejich jmen a stav serverů, zdali je online nebo offline
• Status bot v pravém seznamu discordu

Jak si mohu bota přidat k již existujícímu serveru ARK Ascended serveru?

1. Přihlašte do platebního portálu
2. V horní částní klikněte na služby a poté na "Zobrazit dostupné doplňky"
3. Nyní uvidíte možnost objednat si zdarma zmiňovaného bota, klikěnte tedy na "Objednat" a objednávku dokončete
4. Po dokončení Vám dorazí potvrzení emailem

Kde bota po dokončení mohu najít?

Bota najdete ve správě serverů, podobně jako Váš herní server

1. Přihlašte se do správy serverů https://czechchillout.cz:478 
2. V levém sloupci klikněte na "Voice & Bot Services / Hlasové služby & Boti" 
3. V seznamu uvidíte Vaše Discord boty, ke každému ARK ASA serveru potřebujete a můžete mít jen jednoho bota

Jak bota nastavím, uvedu do provozu?

1. Ze seznamu si rozklikněte bota, kterého chcete nastavovat 
2. V menu klikněte na "Configuration Files / Konfigurační souboroy"
3. U souboru chilloutbot.cfg klikněte na "Text editor / Textový editor"
4. Nyní uvidíte kompletní kofngiruační soubor a ten je potřeba kompletně vyplnit

[Server]
#Nastavíme jméno serveru, například Island
Name=Island

[Message Method]
#Tohle nastavení slouží k určení metody, kterou má Discord bot použít k posílání zpráv do ARKu. Připravené jsou dvě metody, 1. "rcon" klasická metoda ke které nepotřebujete ARK API (nádstavba pro pluginy) a druhou možností je 2. "arkapi" tuto metodu můžete použít pokud používáte ARKAPI a máte nainstalován náš plugin ChilloutChat (najdete v menu Mod Manager), díky tomu můžete mít zprávy v chatu vzhledově hezčí, barevně rozlišené viz obrázek. 
MessageMethod=rcon

1.rcon metoda

2.arkapi metoda

[INFO]
#Zde nastavíme "Connection info port" ARK serveru, ke kterému se má discord bot napojovat
Port=7784

[SFTP]
#Zde nastavíme SFTP a RCON Info, které vidíme opět v administraci serveru, který chceme párovat s botem. Username a Password zadáte Váš login na SFTP, tedy stejný jako do správy serveru
IP=93.99.7.63
Port=8802
Username=*********
Password=***

[RCON]
IP=93.99.7.63
Port=27027
#Do kolonky Password vložíme Admin heslo, pokud ho neznáte, najdete ho v konfiguračních soouborech Vašeho ARK ASA serveru "gameusersettings.ini"
Password=test

Další a finální částí je propojení bota s Vaším discord serverem, vyplníte token bota a ID kanálu, kde má bot komunikovat a OnlinePlayersChannelID slouží k zadání místnoti kam má bot posílat seznam online hráčů
[Discord]
Token=
PreferredChannelID=1223407763389156568
OnlinePlayersChannelID=1226633436080385588

Jak získám Token?

1. Navštivte Discord Developer Portal:
URL: https://discord.com/developers/applications

2. Vytvoření aplikace:
- Klikněte na 'New Application' v pravém horním rohu.
- Zadejte název aplikace a klikněte na 'Create'.

3. Nastavení bota a povolení intentů:
- V aplikaci přejděte do sekce 'Bot' a klikněte na 'Add Bot'.
- Zde nastavte jméno bota, profilový obrázek a další.
- Aktivujte 'Presence Intent', 'Server Members Intent' a 'Message Content Intent'.

4. Získání tokenu bota:
- V sekci 'Bot' klikněte na 'Copy' u 'Token' pro získání bot tokenu.

5. Přidání bota na server s oprávněními:
- Přejděte do sekce 'OAuth2' > 'URL Generator'.
- V 'Scopes' zaškrtněte 'bot' a 'application.commands'.
- V 'Bot Permissions' vyberte následující oprávnění:
- 'Read Messages/View Channels'
- 'Send Messages'
- 'Send Messages in Threads'
- 'Manage Messages'
- 'Manage Threads'
- 'Embed Links'
- 'Read Message History'
- Kopírujte vygenerované URL a otevřete ho ve svém prohlížeči pro přidání bota na server.

Poznámka:
Nezapomeňte překontrolovat, zdali má bot oprávnění do místnosti, ve které chcete aby operoval

Pro všechny boty stačí jeden Token(bot)

Jak získám PreferredChannelID a OnlinePlayersChannelID?

1. Otevřete Discord.
2. Klikněte na ikonu nastavení (ozubené kolo) vedle vašeho uživatelského jména v dolní části aplikace.
3. V menu nastavení vyberte 'Pokročilé' nebo 'Advanced'.
4. Přepněte 'Režim vývojáře' nebo 'Developer Mode' na zapnuto.
5. Klikněte pravým tlačítkem myši na název kanálu, ze kterého chcete získat ID.
6. V kontextovém menu vyberte 'Kopírovat ID' nebo 'Copy ID'.