Plugin Minecraft EssentialsDiscordLink

🔌 Despre EssentialsX Discord Link

EssentialsX Discord Link este un modul add-on pentru EssentialsX Discord care oferă legarea conturilor și sincronizarea între conturile Minecraft și rolurile Discord. Este conceput pentru a extinde integrarea Discord a EssentialsX cu funcții axate pe asocierea identităților utilizatorilor și maparea grupurilor Vault la roluri Discord (și invers).

🎯 Scop

Oferirea unei metode simple, ușor de întreținut, prin care jucătorii își pot lega conturile Minecraft și Discord și prin care apartenența la grupurile serverului și rolurile Discord rămân sincronizate. De asemenea, permite restricționarea jucătorilor nelegați, astfel încât să nu se poată alătura sau interacționa până nu finalizează legarea.

⚙️ Funcții

• Sincronizare grup Vault -> rol Discord (maparea numelor grupurilor Vault la ID-urile rolurilor Discord).
• Sincronizare rol Discord -> grup Vault (atribuirea grupurilor Vault pe baza ID-urilor rolurilor Discord).
• Împiedicarea jucătorilor nelegați să intre pe server.
• Împiedicarea jucătorilor nelegați să se miște sau să trimită mesaje în chat până când își leagă contul.
• Flux de legare a contului în joc, care emite un cod scurt pentru folosire în Discord.
• O mică API pentru dezvoltatori pentru a verifica starea legării, a lega/dezlega jucători și a obține datele legate.

🧩 Pentru cine este

• Servere care folosesc EssentialsX și modulul EssentialsX Discord și au nevoie de legarea conturilor Discord.
• Servere care folosesc grupuri Vault și vor ca aceste grupuri să fie reflectate ca roluri Discord (sau invers).
• Servere Survival, SMP și comunitare care necesită apartenență Discord verificată sau sincronizare de roluri.

🏗️ Exemple de utilizare

• Acordarea automată a unui grup de donator bazat pe Vault atunci când un jucător are un rol Discord potrivit.
• Blocarea jucătorilor nelegați de la chat sau mișcare până când își confirmă contul Discord prin codul de legare din joc.
• Folosirea unui plugin backend sau a unui script pentru a interoga, prin API-ul oferit, dacă un jucător este legat.

⌨️ Comenzi

⚙️ Instalare

📥 Configurare

• Descărcați jar-ul oficial EssentialsX Discord Link și puneți-l în directorul plugins/ al serverului.
• Porniți serverul pentru a genera folderul pluginului și configurația implicită.
• Editați configurația pluginului din plugins/EssentialsDiscordLink/config.yml pentru a defini groups (grup Vault -> ID rol Discord) și roles (ID rol Discord -> grup Vault).
• După salvarea configurației, rulați comanda de reload din consola EssentialsX (de exemplu ess reload) sau reporniți serverul pentru a aplica setările de sincronizare a rolurilor.

📦 Dependențe

• EssentialsX (core) — necesar (acest modul este un add-on pentru EssentialsX Discord).
• EssentialsX Discord — necesar (acest add-on extinde acel modul).
• Vault — folosit pentru mapările grup Vault ↔ rol Discord (menționate în funcțiile de sincronizare a rolurilor).

🧠 Note tehnice

• Pluginul oferă o mică API pentru dezvoltatori (service) care permite altor pluginuri să verifice dacă un jucător este legat, să lege/dezlege jucători programatic și să preia datele legate.
• Configurația folosește plugins/EssentialsDiscordLink/config.yml pentru mapările dintre grupurile Vault și ID-urile rolurilor Discord.

🤝 Când este util acest plugin

Dacă serverul tău folosește deja EssentialsX și ai nevoie ca jucătorii să își verifice sau să își lege conturile Discord (și/sau să păstreze grupurile Vault și rolurile Discord sincronizate), EssentialsX Discord Link oferă o integrare directă, documentată, care funcționează în ecosistemul de module EssentialsX.