Co to jest DiscordSRV

DiscordSRV to darmowy, open-source plugin, który tworzy dwukierunkowy most między chatem na serwerze Minecraft a kanałem na serwerze Discord. Wiadomości wysłane w grze pojawiają się na Discordzie, a wiadomości z Discorda pojawiają się w grze. To pozwala graczom, którzy aktualnie nie grają, nadal uczestniczyć w rozmowach na serwerze.

Plugin jest zainstalowany na dziesiątkach tysięcy serwerów i jest de facto standardem integracji Discord-Minecraft. Oprócz synchronizacji chatu oferuje powiadomienia o dołączeniu/odejściu graczy, wiadomości o śmierci, osiągnięciach i wiele więcej.

DiscordSRV pobierzesz z SpigotMC lub Modrinth. Dokumentacja na docs.discordsrv.com.

Funkcje

DiscordSRV oferuje znacznie więcej niż prosty most chatowy:

Synchronizacja chatu - wiadomości w obie strony: Minecraft do Discord i Discord do Minecraft
Powiadomienia - wiadomości o wejściu/wyjściu gracza, śmierci, osiągnięciach
Konsola przez Discord - wykonywanie komend serwera bezpośrednio z kanału Discord
Weryfikacja kont - łączenie konta Discord z kontem Minecraft (komenda /discord link)
Synchronizacja rang - rangi z Minecraft (LuckPerms) synchronizowane z rolami Discord i odwrotnie
Status bota - bot wyświetla liczbę graczy online jako swój status na Discordzie
Webhooks - wiadomości z Minecraft wyświetlają się z awatarem i nickiem gracza na Discordzie
Placeholder support - pełna integracja z PlaceholderAPI dla formatowania wiadomości

Instalacja i konfiguracja bota

DiscordSRV wymaga bota Discord. Konfiguracja w kilku krokach:

Utwórz aplikację na Discord Developer Portal
W sekcji "Bot" utwórz bota i skopiuj token
Włącz intents: "Server Members Intent" i "Message Content Intent"
Zaproś bota na swój serwer Discord (OAuth2 z uprawnieniami: Administrator)
Zainstaluj DiscordSRV na serwerze Minecraft
Wklej token bota do plugins/DiscordSRV/config.yml

# Fragment config.yml
BotToken: "TWOJ_TOKEN_BOTA_TUTAJ"

# Kanały do synchronizacji (ID kanału Discord)
Channels:
  global: "1234567890123456789"

# Konsola Discord (kanał do wykonywania komend)
DiscordConsoleChannelId: "9876543210987654321"

ID kanału Discord uzyskasz klikając prawym przyciskiem na kanał (z włączonym trybem developera w ustawieniach Discord) i wybierając "Kopiuj ID".

Konfiguracja kanałów

DiscordSRV pozwala mapować różne kanały chatu Minecraft na różne kanały Discord:

Channels:
  global: "1234567890123456789"     # chat globalny
  staff: "1111111111111111111"      # kanał staffu
  donators: "2222222222222222222"   # kanał donatorów

# Formatowanie wiadomości z MC na Discord
DiscordChatChannelMinecraftToDiscord:
  Enabled: true
  UseWebhooks: true  # wiadomości z awatarem gracza

# Formatowanie wiadomości z Discord do MC
DiscordChatChannelDiscordToMinecraft:
  Enabled: true
  Format: "&7[&5Discord&7] &f%name%: &7%message%"

Opcja UseWebhooks: true sprawia, że wiadomości z Minecraft wyglądają na Discordzie znacznie lepiej - każda ma awatar i nick gracza zamiast nazwy bota. To standard na profesjonalnych serwerach.

Weryfikacja kont

System weryfikacji łączy konto Discord gracza z jego kontem Minecraft. Po weryfikacji gracz automatycznie otrzymuje rolę na Discordzie (np. "Zweryfikowany gracz").

Proces weryfikacji z perspektywy gracza:

Gracz wpisuje /discord link w Minecraft
Otrzymuje 4-cyfrowy kod
Wysyła ten kod do bota na Discordzie w wiadomości prywatnej
Bot przyznaje rolę na Discordzie i potwierdza połączenie

Weryfikacja otwiera możliwości synchronizacji rang: gracz z rangą VIP na serwerze automatycznie dostaje rolę VIP na Discordzie. Działa to również w drugą stronę - rola na Discordzie może nadawać uprawnienia w grze przez LuckPerms.

Wskazówki

Osobny kanał konsoli - kanał konsoli powinien być dostępny tylko dla adminów (ustawienia kanału Discord). Pozwala wykonywać komendy serwera zdalnie, np. z telefonu
Filtrowanie wiadomości - skonfiguruj listę ignorowanych komend i wiadomości, żeby spam (np. powtarzające się komendy) nie zaśmiecał Discorda
Wiele serwerów - na sieci wieloserwerowej zainstaluj DiscordSRV na każdym backendzie z osobnym kanałem. Proxy nie obsługuje DiscordSRV (jest plugin Bukkit)
Sieć i proxy - dla integracji Discord na poziomie proxy rozważ alternatywy jak Discord Integration lub moduł EssentialsX Discord
Rate limits Discord - Discord API ma limity. Przy wielu graczach włącz grupowanie wiadomości (batching) w konfiguracji

Powiązane: LuckPerms (synchronizacja rang), EssentialsX Discord (alternatywa).