Plugin Minecraft EssentialsDiscord

🔌 O EssentialsX Discord

EssentialsX Discord (dystrybuowany jako moduł EssentialsDiscord) to oficjalny moduł EssentialsX, który integruje serwer Minecraft z serwerem Discord. Działa jako plik JAR wtyczki obok głównego modułu EssentialsX i łączy się z Discordem za pomocą skonfigurowanego tokena bota, aby przekazywać czat, zdarzenia oraz zapewniać interakcje po stronie Discorda oparte na niewielkim API.

🎯 Cel

Główny cel modułu jest dwojaki: przekazywać wybrane wiadomości/czaty i zdarzenia z Minecrafta do kanałów Discorda oraz przekazywać wybrane wiadomości/komendy z Discorda do serwera Minecraft. Jest przeznaczony dla administratorów serwerów, którzy chcą bezpośredniej, konfigurowalnej komunikacji i ograniczonej zdalnej kontroli między Discordem a serwerem Minecraft opartym na EssentialsX.

⚙️ Funkcje

• Konfigurowalne mapowanie kanałów dla różnych typów wiadomości (czat, dołączanie/wyjście, staff itd.).
• Przekazywanie czatu z Minecrafta do Discorda i opcjonalne przekazywanie wiadomości z Discorda do czatu Minecrafta.
• Komendy slash po stronie Discorda, które mogą wykonywać komendy konsoli, wysyłać wiadomości do graczy i wyświetlać listy graczy (konfigurowalne i ograniczane przez role).
• Szczegółowy system typów wiadomości i formatowania dla poszczególnych typów zdefiniowany w konfiguracji wtyczki.
• API dla deweloperów do rejestrowania niestandardowych typów wiadomości i komend interakcji Discorda za pomocą dostarczonego API DiscordService.

🧩 Dla kogo jest ten moduł

• Dla właścicieli serwerów używających EssentialsX, którzy chcą synchronizacji czatu Discord ↔ Minecraft.
• Dla ekip staffu, które chcą połączyć prywatne kanały staffu z członkami staffu w grze.
• Dla twórców wtyczek, którzy chcą udostępniać proste interakcje z Discordem lub własne hooki wiadomości do Discorda.

🏗️ Przykładowe zastosowania

• Przekazywanie globalnego czatu do dedykowanego kanału Discorda, jednocześnie wysyłając wiadomości tylko dla staffu do członków staffu w grze.
• Pozwolenie zweryfikowanym rolom Discorda na wykonywanie skonfigurowanych zapytań lub komend serwera za pomocą komend slash bez ujawniania ich publicznie.
• Umożliwienie innej wtyczce wysyłania uporządkowanych powiadomień do Discorda przez zarejestrowanie niestandardowego typu wiadomości w API EssentialsX Discord.

⌨️ Komendy

EssentialsX Discord udostępnia konfigurowalne komendy slash po stronie Discorda (rejestrowane w Discordzie), zamiast typowych komend czatu Minecrafta. Te komendy (przykłady pokazano w oficjalnej dokumentacji) są uruchamiane z Discorda i mogą wykonywać komendy konsoli, wysyłać wiadomości do graczy lub pokazywać listy graczy. Dostępność komend i funkcje uprzywilejowane są kontrolowane przez konfigurację ról/ID w pliku konfiguracyjnym wtyczki.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR modułu EssentialsX Discord i umieść go w katalogu plugins/ na serwerze obok głównego pliku JAR EssentialsX.
• Uruchom serwer, aby wygenerować konfigurację modułu, a następnie zatrzymaj serwer.
• Skonfiguruj token bota, identyfikatory kanałów, typy wiadomości i ustawienia ról komend w plugins/EssentialsDiscord/config.yml zgodnie z dokumentacją, a potem uruchom ponownie.

📦 Zależności

• EssentialsX (core) — moduł działa jako dodatek do pakietu wtyczek EssentialsX.

🧠 Uwagi techniczne

• Moduł udostępnia API usług (DiscordService), aby inne wtyczki mogły rejestrować niestandardowe typy wiadomości i wysyłać wiadomości do skonfigurowanych kanałów Discorda.
• Komendy po stronie Discorda są kontrolowane przez role/ID skonfigurowane w pliku wtyczki, a nie przez standardowe node’y uprawnień Minecrafta.
• Konfiguracja administracyjna (token bota, identyfikatory kanałów, formatowanie wiadomości, identyfikatory ról komend) odbywa się w pliku konfiguracyjnym modułu tworzonym przy pierwszym uruchomieniu.

🤝 Kiedy ta wtyczka jest przydatna

Gdy potrzebujesz zarządzanej, konfigurowalnej komunikacji dwukierunkowej między społecznością Discorda a serwerem Minecraft opartym na EssentialsX — w tym komend Discorda ograniczonych rolami i hooków dla deweloperów — EssentialsX Discord oferuje wyspecjalizowany moduł, który obsługuje mapowanie wiadomości i niewielkie API do integracji.