Plugin Minecraft EssentialsDiscordLink

🔌 Tentang EssentialsX Discord Link

EssentialsX Discord Link adalah modul tambahan untuk EssentialsX Discord yang menyediakan penautan akun dan sinkronisasi antara akun Minecraft dan peran Discord. Ini dirancang untuk memperluas integrasi Discord EssentialsX dengan fitur yang berfokus pada penautan identitas pengguna dan pemetaan grup Vault ke peran Discord (dan sebaliknya).

🎯 Tujuan

Menyediakan cara yang sederhana dan mudah dipelihara agar pemain dapat menautkan akun Minecraft dan Discord mereka serta menjaga keanggotaan grup server dan peran Discord tetap tersinkronisasi. Plugin ini juga mendukung pembatasan pemain yang belum tertaut agar tidak bisa bergabung atau berinteraksi sampai mereka menyelesaikan penautan.

⚙️ Fitur

• Sinkronisasi grup Vault -> peran Discord (memetakan nama grup Vault ke ID peran Discord).
• Sinkronisasi peran Discord -> grup Vault (menetapkan grup Vault berdasarkan ID peran Discord).
• Mencegah pemain yang belum tertaut bergabung ke server.
• Mencegah pemain yang belum tertaut bergerak atau mengirim pesan chat sampai mereka menautkan akun.
• Alur penautan akun di dalam game yang menghasilkan kode singkat untuk digunakan di Discord.
• API kecil untuk pengembang untuk memeriksa status tautan, menautkan/melepas tautan pemain, dan mengambil data yang ditautkan.

🧩 Untuk Siapa Ini

• Server yang memakai EssentialsX dan modul EssentialsX Discord yang membutuhkan penautan akun Discord.
• Server yang menggunakan grup Vault dan ingin grup tersebut tercermin sebagai peran Discord (atau sebaliknya).
• Server Survival, SMP, dan komunitas yang memerlukan keanggotaan Discord terverifikasi atau sinkronisasi peran.

🏗️ Contoh Penggunaan

• Secara otomatis memberikan grup donatur berbasis Vault saat pemain memiliki peran Discord yang cocok.
• Memblokir pemain yang belum tertaut agar tidak bisa mengobrol atau bergerak sampai mereka mengonfirmasi akun Discord mereka melalui kode tautan di dalam game.
• Menggunakan plugin backend atau skrip untuk mengecek apakah seorang pemain sudah tertaut melalui API yang disediakan.

⌨️ Perintah

⚙️ Instalasi

📥 Penyiapan

• Unduh jar resmi EssentialsX Discord Link dan letakkan di direktori plugins/ server Anda.
• Jalankan server untuk membuat folder plugin dan konfigurasi default.
• Edit konfigurasi plugin di plugins/EssentialsDiscordLink/config.yml untuk menentukan groups (grup Vault -> ID peran Discord) dan roles (ID peran Discord -> grup Vault).
• Setelah menyimpan konfigurasi, jalankan perintah reload konsol EssentialsX (misalnya ess reload) atau mulai ulang server untuk menerapkan pengaturan sinkronisasi peran.

📦 Dependensi

• EssentialsX (inti) — diperlukan (modul ini adalah addon untuk EssentialsX Discord).
• EssentialsX Discord — diperlukan (addon ini memperluas modul tersebut).
• Vault — digunakan untuk pemetaan grup Vault ↔ peran Discord (dirujuk dalam fitur sinkronisasi peran).

🧠 Catatan Teknis

• Plugin ini menyediakan API kecil untuk pengembang (service) yang memungkinkan plugin lain memeriksa apakah seorang pemain sudah tertaut, menautkan/melepas tautan pemain secara terprogram, dan mengambil data yang ditautkan.
• Konfigurasi menggunakan plugins/EssentialsDiscordLink/config.yml untuk pemetaan antara grup Vault dan ID peran Discord.

🤝 Kapan Plugin Ini Berguna

Jika server Anda sudah menggunakan EssentialsX dan Anda perlu pemain memverifikasi atau menautkan akun Discord mereka (dan/atau menjaga grup Vault dan peran Discord tetap tersinkronisasi), EssentialsX Discord Link menyediakan integrasi langsung yang terdokumentasi dan bekerja dalam ekosistem modul EssentialsX.