Plugin Minecraft EssentialsGeoIP

🔌 Tentang EssentialsX GeoIP

EssentialsX GeoIP adalah modul untuk rangkaian plugin EssentialsX yang melakukan pencarian GeoIP lokal menggunakan basis data MaxMind GeoLite2. Modul ini terintegrasi dengan EssentialsX untuk menampilkan lokasi perkiraan pemain (misalnya di /whois dan, secara opsional, kepada staf saat pemain bergabung).

🎯 Tujuan

Modul ini menyediakan informasi geografis perkiraan kepada staf server yang diambil dari IP pemain untuk membantu moderasi, pencatatan, dan kesadaran lokasi dasar. Pencarian dilakukan secara lokal menggunakan basis data GeoLite2, bukan dengan meminta layanan pencarian pihak ketiga untuk setiap permintaan.

⚙️ Fitur

• Menggunakan basis data MaxMind GeoLite2 untuk pencarian lokasi berdasarkan IP.
• Terintegrasi dengan output /whois EssentialsX untuk menampilkan lokasi perkiraan.
• Opsional: menampilkan lokasi perkiraan pemain kepada staf saat mereka bergabung.
• Pembaruan basis data otomatis: modul mengunduh dan memperbarui basis data GeoLite2 secara berkala (secara default dikonfigurasi untuk diperbarui setiap 30 hari).
• Node permission untuk mengontrol siapa yang dapat melihat atau menyembunyikan hasil GeoIP.

🧩 Untuk Siapa Modul Ini

Modul ini ditujukan untuk administrator server dan tim moderasi yang menjalankan EssentialsX dan ingin data geografis perkiraan untuk keperluan moderasi atau pencatatan di server Bukkit/Spigot/Paper.

🏗️ Contoh Penggunaan

• Menunjukkan kepada staf negara atau kota perkiraan saat memeriksa pemain dengan /whois.
• Mencatat wilayah asal perkiraan untuk koneksi mencurigakan guna membantu moderasi.
• Menyembunyikan tampilan lokasi untuk pemain yang memilih keluar melalui permission.

🔐 Permissions

⚙️ Instalasi

📥 Penyiapan

• Pasang plugin utama EssentialsX (modul GeoIP memerlukan modul inti EssentialsX yang cocok).
• Unduh JAR modul EssentialsX GeoIP dan letakkan di direktori plugins/ server Anda.
• Jalankan server sekali untuk membuat file plugins/EssentialsGeoIP/config.yml.
• Daftar untuk mendapatkan akses ke basis data GeoLite2 milik MaxMind, buat license key, lalu tambahkan license key tersebut ke pengaturan license-key di plugins/EssentialsGeoIP/config.yml.
• Mulai ulang server. Modul akan mengunduh basis data GeoLite2 menggunakan kunci yang diberikan dan memperbaruinya secara otomatis.

📦 Dependensi

• EssentialsX (modul utama) — diperlukan versi yang cocok dari plugin inti EssentialsX.

🧠 Catatan Teknis

• Modul ini mengharuskan Anda menyetujui dan mematuhi EULA MaxMind GeoLite2; basis datanya bersifat perkiraan dan tidak boleh digunakan untuk menentukan lokasi pemain secara tepat.
• Perilaku pengunduhan/pembaruan basis data merupakan bagian dari modul dan dikonfigurasi untuk diperbarui setiap bulan; Anda harus menyediakan license key MaxMind yang valid untuk pembaruan otomatis.
• Menampilkan data hanya melalui fitur inti EssentialsX yang menyediakan /whois atau notifikasi saat bergabung; modul ini sendiri tidak menggantikan fungsi EssentialsX.

🤝 Kapan Plugin Ini Berguna

Jika Anda menjalankan EssentialsX dan membutuhkan pencarian lokasi perkiraan yang ringan dan lokal untuk moderasi atau pencatatan (sambil mematuhi ketentuan lisensi MaxMind), EssentialsX GeoIP menyediakan solusi GeoLite2 yang terintegrasi dan diperbarui otomatis.