Czat Minecraft na Discordzie - DiscordSRV krok po kroku

DiscordSRV łączy czat serwera Minecraft z kanałem na Discordzie. Wiadomości z gry pojawiają się na Discordzie i odwrotnie, a do tego informacje o wejściach, wyjściach, śmierciach i osiągnięciach. Dobry sposób, żeby społeczność żyła także wtedy, gdy nikt nie gra.

1. Zainstaluj plugin

W panelu gier: zakładka Pluginy, wyszukaj DiscordSRV, zainstaluj i zrestartuj serwer. Plugin utworzy folder plugins/DiscordSRV.

2. Utwórz bota na Discordzie

1. Wejdź na discord.com/developers/applications i kliknij New Application.
2. W zakładce Bot kliknij Reset Token i skopiuj token. Nikomu go nie pokazuj - kto ma token, ten steruje botem.
3. Na tej samej stronie, w sekcji Privileged Gateway Intents, włącz Server Members Intent i Message Content Intent. Bez tego bot nie odczyta wiadomości z Discorda.
4. W zakładce OAuth2 → URL Generator zaznacz zakres bot, a w uprawnieniach: View Channels, Send Messages, Read Message History, Embed Links, Attach Files, Manage Webhooks.
5. Otwórz wygenerowany link i dodaj bota na swój serwer Discord.

3. ID kanału

W Discordzie włącz Ustawienia → Zaawansowane → Tryb dewelopera. Kliknij prawym przyciskiem na kanał czatu i wybierz Kopiuj ID kanału.

4. Konfiguracja

W panelu gier otwórz plugins/DiscordSRV/config.yml i ustaw:

BotToken: "tu-wklej-token-bota"
Channels: {"global": "123456789012345678"}
DiscordConsoleChannelId: ""

• Channels - kanał, na który trafia czat z gry (global to główny czat serwera).
• DiscordConsoleChannelId - opcjonalny kanał z konsolą serwera. Ustaw go tylko na kanale prywatnym dla administracji: każdy, kto może tam pisać, wysyła komendy do serwera.

Zrestartuj serwer. W konsoli zobaczysz komunikat o połączeniu z Discordem.

5. Łączenie kont

Gracze mogą połączyć konto Minecraft z Discordem: wpisują w grze /discord link, a otrzymany kod wysyłają botowi w prywatnej wiadomości. Połączone konta pozwalają np. automatycznie nadawać rangi na Discordzie graczom z określoną rangą w grze (sekcja GroupRoleSynchronization w pliku synchronization.yml).

Wygląd wiadomości

Formaty wiadomości zmienisz w pliku messages.yml. Popularna zmiana to wiadomości przez webhook, dzięki którym na Discordzie widać nick i skórkę gracza jako awatar:

Experiment_WebhookChatMessageDelivery: true

(w config.yml). Bot potrzebuje do tego uprawnienia Manage Webhooks.

Najczęstsze problemy

• Bot jest online, ale nie widzi wiadomości z Discorda - nie włączyłeś Message Content Intent.
• „Invalid token” - token skopiowany z błędem albo zresetowany. Wygeneruj nowy i wklej ponownie.
• Brak wiadomości na kanale - bot nie ma uprawnień do tego kanału. Sprawdź uprawnienia kanału w Discordzie.

Bezpieczeństwo

Token bota trzymaj tylko w pliku konfiguracyjnym. Jeśli wkleiłeś go gdzieś publicznie (czat, zrzut ekranu), od razu zrób Reset Token w panelu dewelopera Discorda.

Aktualizacja: 2026-09-21