Bot na Discordzie
Od zera — założenie aplikacji, włączenie Message Content Intent, token, zaproszenie bota i ID kanału.
Plugin potrzebuje własnego bota — nie da się użyć cudzego ani żadnego publicznego. Ta strona prowadzi przez cały proces. Jeśli nigdy nie zakładałeś bota, zajmie to około dziesięciu minut.
Token to hasło do bota
Token, który tu zdobędziesz, daje pełną kontrolę nad botem. Nie wklejaj go nikomu, nie wrzucaj na GitHuba i nie pokazuj na zrzutach ekranu. Jeśli wyciekł — wygeneruj nowy przyciskiem Reset Token, stary natychmiast przestanie działać.
1. Załóż aplikację
Wejdź na Discord Developer Portal i zaloguj się swoim kontem Discord.
Kliknij New Application w prawym górnym rogu.
Wpisz nazwę — to nazwa aplikacji, nie bota, ale i tak warto, żeby była sensowna, na
przykład Whitelist TwojSerwer. Zaakceptuj warunki i kliknij Create.
2. Utwórz bota i włącz intent
W menu po lewej wybierz zakładkę Bot.
Zjedź do sekcji Privileged Gateway Intents i włącz MESSAGE CONTENT INTENT.
Bez tego nic nie zadziała
Message Content Intent pozwala botowi czytać treść wiadomości. Bez niego bot widzi, że ktoś coś napisał, ale nie widzi, co — więc nie odczyta nicku. To najczęstszy powód, dla którego „bot jest online, ale nie reaguje".
Zjedź niżej i zapisz zmiany (Save Changes).
3. Skopiuj token
Dalej w zakładce Bot, w sekcji z nazwą bota, kliknij Reset Token.
Potwierdź. Discord pokaże token jeden raz — skopiuj go od razu.
Wklej go do config.yml pluginu:
discord-token: "TU_WKLEJ_TOKEN"Token zostaje w cudzysłowie.
4. Zaproś bota na swój serwer Discord
W menu po lewej wybierz OAuth2 → URL Generator.
W sekcji Scopes zaznacz bot.
W sekcji Bot Permissions zaznacz co najmniej:
| Uprawnienie | Po co |
|---|---|
| View Channels | Żeby bot w ogóle widział kanał |
| Send Messages | Żeby mógł odpowiadać graczom |
| Read Message History | Wymagane do odpowiadania na konkretną wiadomość |
Skopiuj wygenerowany link z dołu strony, otwórz go w przeglądarce i wybierz swój serwer Discord. Potrzebujesz na nim uprawnienia do zarządzania serwerem.
5. Zdobądź ID kanału
ID kanału to długi ciąg cyfr. Żeby go zobaczyć, trzeba najpierw włączyć tryb dewelopera w kliencie Discorda.
W Discordzie: Ustawienia użytkownika (kółko zębate przy nicku) → Zaawansowane → włącz Tryb dewelopera.
Wróć na serwer, kliknij prawym przyciskiem na kanał, na którym gracze mają wpisywać nicki, i wybierz Kopiuj ID kanału.
Wklej do konfiguracji:
channel-id: "1234567890123456789"ID zostawiamy w cudzysłowie — bez niego YAML potraktuje je jako liczbę i może stracić precyzję.
6. Przygotuj kanał
To krok, o którym łatwo zapomnieć, a ma znaczenie dla bezpieczeństwa.
Kto widzi kanał, ten dostaje się na serwer
Plugin nie sprawdza, kim jest osoba pisząca — dopisuje każdy poprawny nick. Dostęp do kanału jest twoim systemem weryfikacji. Ustaw go tak, żeby widziały go tylko role, którym ufasz.
Zalecane ustawienia kanału:
| Ustawienie | Wartość | Dlaczego |
|---|---|---|
| Widoczność | Tylko zweryfikowane role | To decyduje, kto może wejść na serwer |
| Wysyłanie wiadomości | Dla tych samych ról | — |
| Tryb powolny | 30 s lub więcej | Ogranicza spam i przypadkowe podwójne wpisy |
| Opis kanału | „Wpisz tu swój nick z Minecrafta, nic więcej" | Oszczędza połowę pytań |
Gotowe
Masz token i ID kanału. Przejdź do Instalacji, żeby wgrać plugin i połączyć go z botem.