Boty Discorda mają różne kształty i rozmiary i mogą być używane do wielu różnych celów, od moderowania zachowań użytkowników na serwerze, przez automatyczne wymierzanie kar, takich jak wyciszanie lub blokowanie graczy, którzy wychodzą poza linię, po granie muzyka dla wszystkich.
Poniższe instrukcje zakładają, że masz już konto i serwer Discord. Jeśli nie, skonfiguruj to na discordapp.com przed kontynuowaniem.
Chociaż boty Discord są napisane w języku JavaScript, nie musisz być doświadczonym programistą, aby je stworzyć. W rzeczywistości proces ten jest o wiele mniej onieśmielający, niż możesz sobie wyobrazić. Czytaj dalej, aby dowiedzieć się, jak stworzyć Discord Bota, który spełnia Twoje oczekiwania.
Ten samouczek jest przeznaczony dla użytkowników korzystających z systemów operacyjnych macOS lub Windows.
Pobierz i zainstaluj Node.js
Zanim zaczniesz tworzyć boty Discord, najpierw musisz zainstalować Node.js, środowisko uruchomieniowe JavaScript zbudowane na silniku Google Chrome V8.
-
Otwórz przeglądarkę internetową i przejdź do oficjalnej strony pobierania Node.js.
Image -
Wybierz odpowiedni pakiet instalacyjny dla konkretnej platformy (macOS lub Windows) i kliknij jego łącze pobierania.
- Otwórz pobrany plik i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować Node.js.
- Po zakończeniu uruchom aplikację Wiersz polecenia (Windows) lub Terminal (macOS).
-
Wpisz następujący tekst w wierszu polecenia i naciśnij Enter na klawiaturze: node -v
Image - Jeśli zostanie zwrócony numer wersji, oznacza to, że Node.js jest zainstalowany poprawnie. Jeśli nie, wróć do powyższych kroków i upewnij się, że instalacja została zakończona.
Utwórz aplikację Discord
Teraz, gdy masz już wszystkie wymagania wstępne, nadszedł czas, aby utworzyć nową aplikację, do której Twój bot może być później dodany.
- Otwórz przeglądarkę i przejdź do portalu dla programistów Discord dla swojego serwera, logując się w razie potrzeby.
-
Kliknij Nowa aplikacja.
Image -
Wprowadź nazwę nowej aplikacji w odpowiednim polu edycji i kliknij Utwórz, gdy będziesz gotowy.
Image -
Powinien zostać wyświetlony ekran Informacje ogólne nowej aplikacji, jak pokazano na załączonym zrzucie ekranu. Wybierz Bot, znajdujący się w lewym panelu menu.
Image -
Kliknij Dodaj bota.
Image -
Pojawi się teraz wiadomość z pytaniem, czy na pewno chcesz dodać bota do swojej aplikacji. Kliknij Tak, zrób to!
Image -
Twój nowy bot powinien zostać teraz utworzony, a jego informacje i opcje zostaną wyświetlone w sekcji BUILD-A-BOT. Wybierz Kliknij, aby odsłonić token.
Image -
Długi ciąg znaków powinien być teraz wyświetlany w miejscu wspomnianego linku. Kliknij Copy, aby wysłać ten token do schowka.
Image -
Wklej ten token do pliku tekstowego za pomocą Notatnika, TextEdit lub podobnej aplikacji.
Powinieneś usunąć ten plik i usunąć go z Kosza lub Kosza po ukończeniu tego samouczka.
Kodowanie bota
Utworzyłeś bota i dodałeś go do swojego serwera. Następnie nadchodzi zabawna część, czyli kodowanie bota, aby robił to, co chcesz.
- Uruchom Wiersz polecenia (Windows) lub Terminal (macOS).
-
Wpisz następujący tekst w wierszu polecenia i naciśnij Enter lub Return na klawiaturze: mkdir discord-test -bot
Image Możesz zastąpić discord-test-bot wybraną przez siebie nazwą.
-
Następnie wpisz następujące polecenie, aby przejść do nowo utworzonego katalogu: cd discord-test-bot
Image -
Wiersz poleceń powinien zostać zaktualizowany, wyświetlając nazwę folderu projektu folderu twojego bota. Wpisz następujące polecenie i naciśnij Enter lub Return: npm init -y
Image -
Plik o nazwie package.json powinien teraz zostać utworzony w folderze projektu, jak pokazano na powyższym zrzucie ekranu. Wpisz następujące polecenie w wierszu polecenia i naciśnij Enter lub Return: npm install --save discord.js
Image -
Może być teraz wyświetlana lista komunikatów WARN, które można zignorować, o ile nie ma błędów (ERR), a komunikat na dole okna wiersza polecenia lub terminala brzmi „dodano 7 pakietów” lub „dodano 8 opakowań”. Wpisz następujące polecenie i naciśnij Enter lub Return, aby utworzyć plik auth.json: touch auth.json
Image Jeżeli podczas próby użycia polecenia touch pojawi się komunikat o błędzie, konieczne może być jego zainstalowanie, wprowadzając następującą składnię w wierszu polecenia: npm zainstaluj touch-cli -g
-
Pojawi się komunikat potwierdzający, że ten plik został utworzony, ale możesz wpisać ls -al (macOS) lub dir (Windows), aby zobaczyć zawartość katalogu projektu i samodzielnie potwierdzić, że auth.json jest rzeczywiście na liście.
Image - Uruchom preferowany edytor kodu lub tekstu, taki jak Atom, Notatnik lub TextEdit, i przejdź do nowego folderu projektu.
-
Otwórz plik auth.json i wprowadź tekst pokazany na załączonym zrzucie ekranu, zastępując AUTH-TOKEN ciągiem tokena uwierzytelniającego, który zapisałeś wcześniej w samouczku. Zapisz plik po zakończeniu.
Image You musi skopiować i wkleić cały ciąg uwierzytelniający w pokazanych cudzysłowach. Jeśli brakuje Ci chociaż jednej postaci, Twój bot nie będzie działał zgodnie z oczekiwaniami.
- Wróć do edytora i utwórz nowy plik w folderze projektu o nazwie bot.js.
-
Plik bot.js będzie zawierał kod, który dyktuje zachowanie Twojego bota, co zależy wyłącznie od Ciebie. Jednak na potrzeby tego samouczka zalecamy użycie poniższego kodu i przetestowanie bota end-to-end, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami. Następnie możesz wrócić i edytować zawartość bot.js według własnego uznania.
const Discord=require('discord.js');
const klient=nowy Discord. Client();
const auth=require('./auth.json');
klient.on('gotowy', ()=> {
console.log(`Zalogowany jako ${client.user.tag}!`);
});
client.on('wiadomość', msg=> {
if (msg.content===‘cześć’) {
msg.reply(„Cześć!”);
}
});
client.login(auth.token);
Ten przykładowy kod napisze wiadomość do konsoli wiersza poleceń, gdy bot zostanie wywołany, potwierdzając pomyślne logowanie i zawierającą Twój tag użytkownika.
- Zapisz zaktualizowany plik bot.js.
- Wróć do wiersza poleceń lub terminala i wpisz następujące polecenie, aby uruchomić skrypt bota: node bot.js
- Jeśli do tej pory wszystko wykonałeś poprawnie, następujący tekst powinien pojawić się w oknie wiersza poleceń lub terminala: Zalogowano jako discord-test-bot
Zintegruj kod bota ze swoim serwerem
Jesteś prawie na miejscu…
- Otwórz przeglądarkę i przejdź do portalu dla programistów Discord dla swojego serwera, logując się w razie potrzeby.
-
Wybierz aplikację, którą utworzyliśmy wcześniej z ekranu MOJE APLIKACJE, jeśli zostaniesz o to poproszony.
Image -
Kliknij OAuth2 w lewym panelu menu.
Image -
Przewiń w dół ekranu, aż znajdziesz sekcję SCOPES. Umieść znacznik wyboru obok opcji bot, klikając ją raz.
Image -
Przewiń ponownie w dół do sekcji BOT PERMISSIONS, umieszczając znaczniki wyboru obok każdego typu uprawnień, których Twój indywidualny bot może potrzebować do działania zgodnie z oczekiwaniami. Na potrzeby tego przykładowego bota potrzebujemy następujących uprawnień: Wysyłanie wiadomości, Odczyt historii wiadomości
Image Twój konkretny bot prawdopodobnie będzie potrzebował znacznie innego zestawu uprawnień. Ważne jest, aby zrozumieć, co pociąga za sobą każde uprawnienie, zanim je włączysz, aby użytkownicy bota nie mogli go wykorzystać do niecnych celów.
-
Kliknij Kopiuj, umieszczony pomiędzy sekcjami ZAKRESY i UPRAWNIENIA BOTÓW, któremu towarzyszy długi adres URL.
Image - Otwórz nową kartę przeglądarki i wklej ten adres URL w pasku adresu, naciskając Enter lub Return, aby załadować stronę.
-
Powinno się teraz wyświetlić interfejs CONNECT TO DISCORD, jak pokazano na załączonym zrzucie ekranu. Kliknij Wybierz serwer i wybierz nazwę swojego serwera z wyświetlonej listy.
Image -
Kliknij Autoryzuj.
Image -
Umieść znacznik wyboru obok Nie jestem robotem, klikając jednokrotnie jego pole wyboru.
Image -
Powinna zostać wyświetlona wiadomość potwierdzająca, informująca, że Twój bot jest autoryzowany i został dodany do Twojego serwera.
Image
Jak przetestować bota na serwerze
Możesz przetestować swojego bota, uruchamiając klienta Discord i wysyłając mu polecenia lub wiadomości odpowiadające Twojemu kodowi. W tym przykładzie wyślij słowo hello do swojego bota, który powinien odpowiedzieć hi!
