Plugin Minecraft DiscordSRV

🔌 Despre DiscordSRV

DiscordSRV este un plugin Minecraft care conectează un server Minecraft și un server Discord. El redirecționează chatul din joc către Discord (și mesajele Discord în joc), suportă conectarea conturilor între conturile Minecraft și Discord și oferă hook-uri de sincronizare pentru roluri/grupuri și mai multe evenimente ale serverului.

🎯 Scop

Scopul principal al DiscordSRV este să ofere o punte fiabilă și configurabilă între un server Minecraft și Discord, astfel încât comunitățile să poată comunica pe ambele platforme, staff-ul să fie informat, iar informațiile despre apartenență/roluri să fie sincronizate atunci când este configurat.

⚙️ Funcții

• Sincronizare bidirecțională a chatului între canalele Minecraft și Discord (configurabilă per canal).
• Conectarea conturilor Minecraft <-> Discord pentru jucători.
• Hook-uri de sincronizare pentru roluri/grupuri (puncte de integrare pentru pluginuri de permisiuni precum LuckPerms).
• Mesaje broadcast și mesaje pentru staff din Minecraft către Discord.
• Comenzi pentru conectare, verificarea stării conexiunii și acțiuni administrative (reload, resync, debug).
• Mai multe fișiere de configurare pentru maparea canalelor, limbă/mesaje, sincronizare și funcții voice.
• Cod open-source cu tracker public de probleme și lansări.

🧩 Pentru cine este

• Proprietari de servere și administratori care vor să unifice chatul comunității între Minecraft și Discord.
• Echipe de moderare care au nevoie de vizibilitatea evenimentelor serverului în Discord.
• Rețele care folosesc pluginuri de permisiuni și doresc sincronizarea rolurilor sau grupurilor cu Discord.

🏗️ Exemple de utilizare

• Redirecționarea chatului Minecraft global sau per canal către canale Discord specifice, astfel încât utilizatorii din afara serverului să poată urmări conversațiile.
• Conectarea conturilor jucătorilor la ID-uri Discord pentru a acorda roluri Discord sau pentru a verifica utilizatorii pe platforme diferite.
• Trimiterea logurilor de join/leave/console ale serverului către un canal de moderare Discord.

⌨️ Comenzi

Subcomenzi pentru jucător:

Comenzi pentru staff:

(Comenzile depreciate legate de vechiul sistem de abonamente sunt documentate în istoric, dar au fost eliminate din funcționarea curentă.)

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Descărcați .jar oficial DiscordSRV dintr-o distribuție oficială (pagina proiectului / catalog / lansări).
• Plasați fișierul jar în folderul plugins/ al serverului dvs. pentru un server compatibil Bukkit/Spigot.
• Reporniți serverul și verificați logurile din consolă pentru a confirma că DiscordSRV s-a încărcat.
• Finalizați configurarea inițială (token bot, mapări de canale, opțiuni de conectare) folosind fișierele de configurare generate.

📦 Fișiere de configurare

DiscordSRV folosește mai multe fișiere de configurare; numele confirmate includ:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Editați fișierele potrivite pentru a seta tokenul botului Discord, mapările canalelor și setările de sincronizare. Unele funcții (sincronizarea rolurilor/grupurilor, integrarea voice) necesită configurare suplimentară.

🧠 Note tehnice

• Codul sursă și lansările sunt întreținute într-un repository public.
• Proiectul este publicat sub GPL-3.0.
• Integrările opționale confirmate includ LuckPerms (contexts/sincronizare grupuri) și PlaceholderAPI (placeholders).
• Comenzile și permisiunile sunt documentate în documentația oficială; operațiuni administrative precum resync și reload există și pot necesita privilegii de operator.

🤝 Când este util acest plugin

Dacă aveți nevoie de chat bidirecțional consistent, configurabil și de conectarea conturilor între un server Minecraft și o comunitate Discord, DiscordSRV oferă puntea, hook-urile de integrare și fișierele de configurare necesare pentru a folosi aceste funcții împreună cu pluginuri comune de server.