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
- Založ bota: na discord.com/developers/applications vytvoř aplikaci, v ní sekci Bot, a zkopíruj token. Ulož si ho bezpečně.
- V nastavení bota zapni oba přepínače záměrů (Privileged Gateway Intents) — bez nich bot neuvidí obsah zpráv.
- 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.
- 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.
- Stáhni DiscordSRV z modrinth.com/plugin/discordsrv nebo z dev.bukkit.org a nahraj .jar do složky plugins.
- Restartuj server a otevři plugins/DiscordSRV/config.yml — vlož token, ID serveru a ID kanálu pro chat.
- 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.
- Znovu načti konfiguraci (/discordsrv reload) a napiš něco ve hře — zpráva se musí objevit na Discordu, a naopak.
- Otevři plugins/DiscordSRV/messages.yml a přelož hlášky do češtiny. Po úpravě dej /discordsrv reload.
- Nastav propojování účtů: ve hře /discord link, kód pošli botovi do soukromé zprávy a ověř, že odpověděl.
- Když chceš role podle hodnosti ve hře, nastav v konfiguraci, která skupina z LuckPerms odpovídá které roli na Discordu.
- 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
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.