Plugin Minecraft EssentialsDiscordLink

🔌 O EssentialsX Discord Link

EssentialsX Discord Link to moduł dodatkowy do EssentialsX Discord, który უზრუნველყოფia łączenie kont i synchronizację między kontami Minecraft a rolami Discord. Został zaprojektowany tak, aby rozszerzyć integrację Discorda w EssentialsX o funkcje skupione na łączeniu tożsamości użytkowników i mapowaniu grup Vault na role Discord (i odwrotnie).

🎯 Cel

Zapewnienie prostego i łatwego w utrzymaniu sposobu, aby gracze mogli połączyć swoje konta Minecraft i Discord oraz aby członkostwo w grupach serwera i role Discord były zsynchronizowane. Obsługuje także ograniczanie niezłączonych graczy, aby nie mogli dołączyć ani wchodzić w interakcję, dopóki nie zakończą łączenia.

⚙️ Funkcje

• Synchronizacja grupa Vault -> rola Discord (mapowanie nazw grup Vault na ID ról Discord).
• Synchronizacja rola Discord -> grupa Vault (przypisywanie grup Vault na podstawie ID ról Discord).
• Blokowanie dołączania do serwera przez niezłączonych graczy.
• Blokowanie ruchu lub wysyłania wiadomości na czacie przez niezłączonych graczy do momentu połączenia.
• Wbudowany proces łączenia kont z krótkim kodem do użycia w Discordzie.
• Niewielkie API dla deweloperów do sprawdzania statusu połączenia, łączenia/rozłączania graczy oraz pobierania danych połączenia.

🧩 Dla kogo jest ten plugin

• Serwery używające EssentialsX i modułu EssentialsX Discord, które potrzebują łączenia kont Discord.
• Serwery używające grup Vault i chcące, aby te grupy były odzwierciedlane jako role Discord (lub odwrotnie).
• Serwery Survival, SMP i społecznościowe, które wymagają zweryfikowanej obecności na Discordzie lub synchronizacji ról.

🏗️ Przykładowe zastosowania

• Automatyczne przyznanie grupy darczyńców opartej na Vault, gdy gracz ma pasującą rolę Discord.
• Blokowanie niezłączonych graczy przed czatem lub ruchem, dopóki nie potwierdzą swojego konta Discord za pomocą kodu łączenia w grze.
• Użycie wtyczki backendowej lub skryptu do sprawdzania przez udostępnione API, czy gracz jest połączony.

⌨️ Komendy

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar EssentialsX Discord Link i umieść go w katalogu plugins/ na serwerze.
• Uruchom serwer, aby wygenerować folder wtyczki i domyślną konfigurację.
• Edytuj konfigurację wtyczki w plugins/EssentialsDiscordLink/config.yml, aby zdefiniować groups (grupa Vault -> ID roli Discord) oraz roles (ID roli Discord -> grupa Vault).
• Po zapisaniu konfiguracji uruchom polecenie przeładowania konsoli EssentialsX (na przykład ess reload) lub zrestartuj serwer, aby zastosować ustawienia synchronizacji ról.

📦 Zależności

• EssentialsX (core) — wymagane (moduł jest dodatkiem do EssentialsX Discord).
• EssentialsX Discord — wymagane (ten dodatek rozszerza ten moduł).
• Vault — używany do mapowań grupa Vault ↔ rola Discord (wspomniane w funkcjach synchronizacji ról).

🧠 Uwagi techniczne

• Wtyczka udostępnia niewielkie API dla deweloperów (service), które pozwala innym wtyczkom sprawdzać, czy gracz jest połączony, łączyć/rozłączać graczy programowo oraz pobierać dane połączenia.
• Konfiguracja używa plugins/EssentialsDiscordLink/config.yml do mapowań między grupami Vault a ID ról Discord.

🤝 Kiedy ten plugin jest przydatny

Jeśli twój serwer już używa EssentialsX i potrzebujesz, aby gracze weryfikowali lub łączyli swoje konta Discord (i/lub utrzymywali synchronizację grup Vault i ról Discord), EssentialsX Discord Link zapewnia bezpośrednią, opisaną integrację działającą w ekosystemie modułów EssentialsX.