Plugin Minecraft EssentialsDiscord

🔌 Tentang EssentialsX Discord

EssentialsX Discord (didistribusikan sebagai modul EssentialsDiscord) adalah modul resmi EssentialsX yang mengintegrasikan server Minecraft dengan server Discord. Modul ini berjalan sebagai file jar plugin bersama modul inti EssentialsX dan terhubung ke Discord melalui bot token yang telah dikonfigurasi untuk meneruskan chat, event, dan menyediakan interaksi sisi Discord yang didukung oleh API kecil.

🎯 Tujuan

Tujuan inti modul ini ada dua: meneruskan chat/event Minecraft tertentu ke saluran Discord dan meneruskan pesan/perintah Discord tertentu ke server Minecraft. Modul ini ditujukan bagi administrator server yang menginginkan komunikasi langsung, yang bisa dikonfigurasi, serta kontrol jarak jauh terbatas antara Discord dan server Minecraft berbasis EssentialsX.

⚙️ Fitur

• Pemetaan saluran yang dapat dikonfigurasi untuk berbagai jenis pesan (chat, join/leave, staff, dll.).
• Penerusan chat Minecraft ke Discord dan opsi penerusan pesan Discord ke chat Minecraft.
• Slash command di sisi Discord yang dapat menjalankan perintah konsol, mengirim pesan ke pemain, dan menampilkan daftar pemain (dapat dikonfigurasi dan dibatasi oleh peran).
• Sistem jenis pesan yang detail dan pemformatan per jenis yang ditentukan di konfigurasi plugin.
• API developer untuk mendaftarkan jenis pesan kustom dan perintah interaksi Discord melalui API DiscordService yang disediakan.

🧩 Untuk Siapa Ini

• Pemilik server yang menjalankan EssentialsX dan ingin sinkronisasi chat Discord ↔ Minecraft.
• Tim staf yang ingin saluran staf privat terhubung dengan staf di dalam game.
• Pengembang plugin yang ingin mengekspos interaksi Discord sederhana atau hook pesan kustom ke Discord.

🏗️ Contoh Penggunaan

• Meneruskan chat global ke saluran Discord khusus sambil mengirim pesan Discord khusus staf ke staf di dalam game.
• Mengizinkan peran Discord terverifikasi untuk menjalankan kueri server atau perintah yang telah dikonfigurasi melalui slash command tanpa membukanya ke publik.
• Membiarkan plugin lain mengirim notifikasi terstruktur ke Discord dengan mendaftarkan jenis pesan kustom lewat API EssentialsX Discord.

⌨️ Perintah

EssentialsX Discord menyediakan slash command sisi Discord yang dapat dikonfigurasi (didaftarkan dengan Discord), bukan perintah chat Minecraft biasa. Perintah tersebut (contoh ditampilkan di dokumentasi resmi) dijalankan dari Discord dan dapat menjalankan perintah konsol, mengirim pesan ke pemain, atau menampilkan daftar pemain. Ketersediaan perintah dan fitur yang lebih tinggi dikendalikan oleh konfigurasi peran/ID di konfigurasi plugin.

🔐 Izin

⚙️ Instalasi

📥 Pengaturan

• Unduh file jar modul EssentialsX Discord dan letakkan di direktori plugins/ server Anda bersama file jar inti EssentialsX.
• Jalankan server untuk membuat konfigurasi modul, lalu hentikan server.
• Konfigurasikan bot token, ID saluran, message-types, dan pengaturan peran perintah di plugins/EssentialsDiscord/config.yml sesuai dokumentasi, lalu mulai ulang.

📦 Dependensi

• EssentialsX (inti) — modul ini berjalan sebagai add-on untuk paket plugin EssentialsX.

🧠 Catatan Teknis

• Modul ini menyediakan API layanan (DiscordService) agar plugin lain dapat mendaftarkan jenis pesan kustom dan mengirim pesan ke saluran Discord yang dikonfigurasi.
• Perintah sisi Discord dikendalikan oleh peran/ID yang dikonfigurasi di file plugin, bukan oleh node izin Minecraft standar.
• Konfigurasi bergaya admin (bot token, ID saluran, pemformatan pesan, ID peran perintah) dilakukan di file konfigurasi modul yang dibuat saat pertama kali dijalankan.

🤝 Kapan Plugin Ini Berguna

Saat Anda membutuhkan komunikasi dua arah yang terkelola dan dapat dikonfigurasi antara komunitas Discord dan server Minecraft berbasis EssentialsX (termasuk perintah Discord yang dibatasi peran dan hook developer), EssentialsX Discord menyediakan modul fokus yang menangani pemetaan pesan dan API kecil untuk integrasi.