Jest to bot dla prywatnych serwerów discord wykorzystujący komendy typu "/", komendy głosowe (w języku polskim) oraz klasyczne komendy z wykorzystaniem prefixu. W obecnej wersji bot obsługuje odgrywanie muzyki (wsparcie dla linków z YouTube, SoundCloud oraz Spotify [WYMAGA KLUCZA API!]), możliwość sprawdzenia obecnej mapy w normalnych rozgrywkach w grze Apex Legends (WYMAGA KLUCZA API!), opcja rozmowy z botem przy wykorzystaniu clever-bot'a (WYMAGA USTAWIENIA KANAŁU), oraz powiadomienia o nowej aktywności na kanale głosowym (WYMAGA USTAWIENIA KANAŁU).
W tworzeniu projektu zostały wykorzystane poniższe technologie:
- Node.js 16.13.0
- discord.js 13.6.0
- distube 3.3.2
- discord-speech-recognition 2.2.0
- discord-tts 1.2.1
- cleverbot-free 1.1.9
W chwili obecnej najprostszym sposobem nie wymagającym dużego nakładu pracy, aby móc samodzielnie wypróbować bota jest wejście w poniższy link i postępowanie zgodnie z instrukcją poniżej: https://glitch.com/~discord-speech-recognition-bot UWAGA! Poniższy sposób nie jest trwały! Jeżeli nie posiadamy konta w serwisie glitch nasz projekt zostanie usunięty! Hosting ten w wersji darmowej nie może też utrzymać naszego bota 24/7, więc należy mieć to na uwadze!
- Po wejściu w link u dołu strony znajduje się guzik "Remix your own". Naciskamy go i czekamy aż glitch wygeneruje dla nas kopię projektu.
-
Po wygenerowaniu się projektu po lewej stronie na pasku bocznym znajduje sie lista plików. Odszukujemy tam pliku .env .
-
Po włączeniu wyżej wymienionego pliku pokaże nam się lista wymaganych danych, aby bot mógł działać. Pierwszą z niezbędnych rzeczy jest token, który uzyskać możemy na tej stronie: https://discord.com/developers/applications W internecie jest dużo poradników jak stworzyć bota dlatego fragment z uzyskaniem tokenu pominę. (Przykładowy film: https://www.youtube.com/watch?v=JMmUW4d3Noc) Jedyną z ważnych rzeczy na później jest skopiowanie "APPLICATION ID" z zakładki "General Information" gdyż będzie nam potrzebny później. Ponadto w zakładce Bot musimy uruchomić poniższe ustawienia jak na screenie.
Kolejnym tokenem jest ten odpowiedzialny za informacje z gry Apex Legends (Jeżeli nie interesuje Cię ta opcja możesz pominąć ten krok) i pozyskać możemy go na tej stronie: https://apexlegendsapi.com/documentation.php.
Zjeżdżamy niżej aż do momentu, który widać na poniższym screenie i zaznaczone pole wypełniamy w przykładowo taki sposób a następnie klikamy "Prześlij"
Ostatnim wymaganym kluczem jest klucz dla API Spotify a pozyskać możemy go na tej stronie (Wymaga posiadanie konta!): https://developer.spotify.com/dashboard/login Po zalogowaniu w prawym rogu widnieje guzik "Create An App" klikamy go, uzupełniamy pole nazwy oraz opisu (nie są one istotne), akceptujemy regulamin i klikamy guzik "Create". Na kolejnej stronie pojawią się niezbędne dane to jest Client ID, które kopiujemy i wklejamy w odpowiednie okno i Client Secret, który pojawi się po kliknięciu napisu "SHOW CLIENT SECRET" kopiujemy go i również wklejamy w odpowiednie pole.
- Kolejnym i już ostatnim plikiem, który wymaga naszej ingerencji jest config.json . Ten krok wymagać będzie aktywowania trybu dewelopera na discordzie dlatego zaczniemy od tego. Wchodzimy kolejno w Ustawienia użytkownika > Zaawansowane i klikamy w suwak "Tryb dewelopera", aby go aktywować. Po wykonaniu tego kroku możemy przejść do uzupełniania naszego pliku.
Pierwszą niezbędną informacją jest id naszego serwera. Klikamy prawym przyciskiem myszki na ikonę serwera a następnie guzik "Kopiuj ID" i wklejamy to między cudzysłowie przy guild_ID (Ważne jest aby uważać, usunięcie cudzysłowia może uszkodzić działanie bota!). Kolejnym krokiem jest wybranie prefixu dla naszego bota podstawowo jest to $ jednak możemy zmienić go na jakikolwiek inny poza "/" oraz należy pamiętać, aby żaden inny bot na naszym serwerze takiego nie posiadał! Następne dwie informacje odpowiadają kolejno za powiadomienia o aktywności na kanałach głosowych i kanał tekstowy, na którym można rozmawiać z botem. Nie zdefiniowanie ich nie uszkodzi działania bota jednak uniemożliwi korzystanie z tych opcji. W obu miejscach wymagane są ID kanałów tekstowych. które uzyskać można poprzez kliknięcie na kanał tekstowy prawym klawiszem, naciśnięcie opcji "Kopiuj ID". Wklejamy skopiowane ID w odpowiednie miejsce między cudzysłowami i gotowe.
- Ostatnią rzeczą jaką musimy zrobić jest zaproszenia bota na nasz serwer. Aby to zrobić należy zmodyfikować i wykorzystać ten link https://discord.com/oauth2/authorize?client_id=[klientid]&permissions=8&scope=bot%20applications.commands . Modyfikacja jakiej musimy dokonać to zmiana [klientid] na ID naszego bota, które wcześniej sobie skopiowaliśmy, będzie się ono składało wyłącznie z liczb.
Jest to podstawowa wersja bota i w przyszłości planuję dodać kolejne opcje, jednak jest on skierowany do serwerów prywatnych ze względu na komendy głosowe, które mogłyby być problematyczne na serwerach publicznych.
W razie problemów można kontaktować się ze mną poprzez discorda Hydro#7549 .