DiscordSRV

Propojí chat serveru s Discordem — hráči a Discord vidí jednu konverzaci.

← Pluginy Vzhled a chat licence GPL-3.0-or-later návod pro DiscordSRV 1.28.x (Paper/Spigot)

Stáhnout u autora Zdrojový kód 521 887 stažení u autora autor Scarsz

Co to dělá

DiscordSRV propojí Minecraft server s Discordem: co se napíše ve hře, objeví se v kanálu na Discordu, a co se napíše tam, uvidí hráči ve hře. Discord tak přestane být vedlejším místem a stane se druhým oknem serveru.

Kromě chatu umí přeposílat i události: připojení a odpojení hráčů, úspěchy, smrti, start a stop serveru, výpis hráčů online do názvu kanálu. Všechny ty texty jsou v souboru messages.yml, kde si každou hlášku přepíšeš česky.

Druhou velkou částí je propojení účtů: hráč napíše ve hře /discord link, dostane kód a pošle ho botovi do soukromé zprávy. Server pak ví, který Discord patří kterému hráči — a podle toho může dávat role (třeba VIP na Discordu podle hodnosti ve hře).

DiscordSRV potřebuje vlastního bota. Založíš ho na Discord Developer Portalu, vložíš jeho token do konfigurace a pozveš ho na svůj server s právy na čtení a psaní zpráv. Token je tajemství — nikdy ho nedávej do veřejného repozitáře ani do chatu.

Nejužitečnější je nastavení propojení účtů, přeposílání událostí a role podle hodnosti. Naopak nikdy nezapínej přeposílání soukromých zpráv — hráči by si přestali psát, kdyby věděli, že to vidí veřejný kanál.

Známá zkušenost z českých serverů: po instalaci jsou hlášky anglicky (úspěchy, připojení, smrti). Všechny jsou v messages.yml a dají se přeložit za chvilku — hráči si toho všimnou a server tím působí domácky.

Instalace

  1. Založ bota: na discord.com/developers/applications vytvoř aplikaci, v ní sekci Bot, a zkopíruj token. Ulož si ho bezpečně.
  2. V nastavení bota zapni oba přepínače záměrů (Privileged Gateway Intents) — bez nich bot neuvidí obsah zpráv.
  3. Pozvi bota na svůj Discord: v OAuth2 vytvoř odkaz s právy na čtení a psaní zpráv a botem ho přidej na server.
  4. Ve svém Discordu zapni vývojářský režim (Nastavení → Rozšířené) a zkopíruj ID serveru (pravým kliknutím na jeho název) a ID kanálu pro chat.
  5. Stáhni DiscordSRV z modrinth.com/plugin/discordsrv nebo z dev.bukkit.org a nahraj .jar do složky plugins.
  6. Restartuj server a otevři plugins/DiscordSRV/config.yml — vlož token, ID serveru a ID kanálu pro chat.
  7. Nastav, co se má přeposílat: chat ze hry, zprávy z Discordu, události (připojení, úspěchy, smrti) a výpis hráčů do názvu kanálu.
  8. Znovu načti konfiguraci (/discordsrv reload) a napiš něco ve hře — zpráva se musí objevit na Discordu, a naopak.
  9. Otevři plugins/DiscordSRV/messages.yml a přelož hlášky do češtiny. Po úpravě dej /discordsrv reload.
  10. Nastav propojování účtů: ve hře /discord link, kód pošli botovi do soukromé zprávy a ověř, že odpověděl.
  11. Když chceš role podle hodnosti ve hře, nastav v konfiguraci, která skupina z LuckPerms odpovídá které roli na Discordu.
  12. Zkontroluj pojistky: soukromé zprávy (/msg) se na Discord přeposílat nesmí. Rozhodni to vědomě, ne omylem.

Oprávnění

Oprávnění se udělují hráčům nebo skupinám — nejčastěji příkazem /lp user <hráč> permission set <uzel> true (LuckPerms). Uzel, který v seznamu není, plugin nezná.

Oprávnění Co umožňuje
discordsrv.player základní příkazy (/discord)
discordsrv.chat psát z Discordu do hry
discordsrv.link propojit si účet (/discord link)
discordsrv.admin správa pluginu (/discordsrv reload a další)
discordsrv.* úplně vše (jen správce)

Příkazy

Napiš do chatu i s lomítky. Kde je <hráč> nebo <uzel>, doplň vlastní hodnotu bez závorek.

Příkaz Co dělá
/discord nápověda a stav propojení
/discord link vygeneruje kód pro propojení účtu (kód pošleš botovi do soukromé zprávy)
/discord unlink zruší propojení účtu
/discord linked vypíše propojené účty
/discordsrv reload znovu načte konfiguraci a texty (po úpravě messages.yml)
/discordsrv broadcast pošle zprávu do propojených kanálů
/discordsrv status stav připojení bota
Na Discordu se propojení dělá příkazem nebo soukromou zprávou botovi, podle nastavení serveru

Nastavení a časté chyby

Token bota je tajemství. Když ho omylem zveřejníš, jdi na Developer Portal a nech token vygenerovat znovu (Regenerate) — jinak může kdokoli ovládat tvého bota.
Zapni botovi oba záměry (Privileged Gateway Intents). Bez nich se zprávy z Discordu nepřeposílají a vypadá to jako chyba pluginu.
Hlášky jsou po instalaci anglicky. Najdeš je v messages.yml a přeložíš je — je to nejrychlejší cesta, jak server působí domácky.
Nikdy nezapínej přeposílání soukromých zpráv (/msg) na veřejný kanál. Hráči musí mít jistotu, že si můžou psát bez publika.
Výpis hráčů online v názvu kanálu je hezký, ale kanál se přejmenovává opakovaně a Discord to omezuje. Jednou za několik minut stačí.
Propojení účtů je základ pro role podle hodnosti: bez něj Discord neví, kdo je kdo, a role se nedají dávat automaticky.
Když bot neodpovídá, projdi pořadí: token, pozvánka na server, ID kanálu, práva bota v tom kanálu. Většina problémů je v jednom z těch čtyř kroků.

Kdo to používá

Zatím nevíme, které servery z našeho seznamu ho používají. Moderní servery svůj seznam pluginů v dotazu na stav neposílají, takže se to dozvídáme od majitelů.

Používáš ho na svém serveru? Napiš nám a doplníme ho sem — na tuhle stránku chodí lidé, kteří plugin hledají.

Podobné pluginy

SkinsRestorer
Vrátí hráčům jejich skin — i na offline serveru, kde by jinak běhali bez hlavy.
TAB
Tabulka hráčů, jméno nad hlavou a pruh s textem — kdo je kdo a co se děje.

Odkud návod vychází

Návod je náš vlastní a vychází z dokumentace autora (verze DiscordSRV 1.28.x (Paper/Spigot)) . Oprávnění a příkazy opisujeme jako fakta, nic nedomýšlíme — když se plugin po aktualizaci změní, může být návod pozadu. Našel jsi chybu? Napiš nám a opravíme to.

Licence: GPL-3.0-or-later. Soubor se u nás nehostuje, stahuje se u autora (Scarsz) — tak je vždy dostupná aktuální verze.

Zkopírováno