Plugin Minecraft BlueMap

🔌 Tentang BlueMap

BlueMap adalah alat pemetaan Minecraft yang membaca file dunia server dan menghasilkan model 3D serta penampil web interaktif. BlueMap dapat berjalan sebagai plugin server atau mod (plugin Spigot/Paper atau Sponge, mod Fabric/Forge) atau sebagai renderer command-line mandiri. Saat dipasang di server yang sedang berjalan, BlueMap merender secara asinkron sehingga tidak memblokir thread utama server.

🎯 Tujuan

BlueMap menyediakan representasi tiga dimensi dunia Minecraft yang bisa diakses lewat browser, sehingga administrator dan pemain dapat menjelajahi medan, menemukan struktur, dan memeriksa bangunan tanpa harus bergabung ke server. Ini ditujukan untuk operator server yang membutuhkan peta visual yang selalu terbaru untuk keperluan administrasi, navigasi, atau pameran komunitas.

⚙️ Fitur

• Menghasilkan model 3D permukaan dunia dan menampilkannya di web viewer berbasis browser.
• Dapat berjalan sebagai plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) atau sebagai alat CLI mandiri.
• Rendering asinkron untuk menghindari pemblokiran thread utama Minecraft server.
• Mendukung resource pack dan data pack untuk menyesuaikan tekstur, model blok, dan warna bioma yang digunakan dalam render.
• Mendukung berbagai backend penyimpanan dan pengelolaan map lewat perintah (load, unload, list, delete, dll.).
• Dukungan marker dan API agar plugin pihak ketiga dapat menambah atau mengelola marker pada map.
• Perintah reload runtime dan kontrol rendering (reload, mulai/hentikan rendering, update/purge map, freeze/unfreeze map).

🧩 Untuk Siapa

• Server Survival dan SMP yang menginginkan peta 3D publik atau untuk admin.
• Server Creative atau showcase yang membutuhkan pratinjau build yang bisa diakses lewat browser.
• Administrator server yang memerlukan pemeriksaan jarak jauh dan alat navigasi berbasis map.

🏗️ Contoh Penggunaan

• Menyediakan pemain dengan peta 3D dunia yang di-host secara publik untuk membantu navigasi dan memamerkan build.
• Admin menemukan dan meninjau base atau klaim pemain dari web viewer sebelum mendatangi secara in-game.
• Sebuah plugin menggunakan API BlueMap untuk menampilkan marker dinamis bagi event, toko, atau lokasi teleport.

⌨️ Perintah

(Semua perintah di atas didokumentasikan oleh proyek; node izin yang tepat tersedia di dokumentasi proyek dan tidak diulang di sini.)

⚙️ Instalasi

📥 Penyiapan

• Unduh BlueMap JAR yang sesuai untuk platform Anda (plugin JAR untuk Spigot/Paper/Sponge, mod JAR untuk Fabric/Forge, atau distribusi CLI mandiri).
• Letakkan JAR ke folder plugins/ server (untuk Spigot/Paper/Sponge) atau folder mods/ (untuk Fabric/Forge), atau gunakan file distribusi CLI untuk rendering mandiri.
• Jalankan atau restart server. Periksa konsol server untuk memastikan BlueMap dan server web bawaannya berhasil dimulai.

📦 Dependensi

• Tidak diperlukan dependensi plugin eksternal wajib untuk rendering peta inti. Integrasi dan add-on opsional tersedia; lihat dokumentasi proyek untuk info add-on pihak ketiga.

🧠 Catatan Teknis

• BlueMap didistribusikan sebagai plugin server, mod, dan alat CLI; pilih artefak yang sesuai dengan setup Anda.
• Rendering dilakukan secara asinkron untuk menghindari pemblokiran thread utama server.
• Resource pack dan data pack dapat ditempatkan di direktori pack yang telah dikonfigurasi untuk mengubah tampilan map.
• Proyek ini memiliki repositori sumber publik dan build rilis; konfigurasinya berbasis file dan dapat dimuat ulang saat runtime.

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan tampilan tiga dimensi dunia Minecraft yang bisa diakses lewat browser untuk navigasi, meninjau build, atau ditampilkan ke komunitas, BlueMap menyediakan rendering otomatis, kontrol runtime, dan API untuk marker serta integrasi tanpa mengharuskan pemain bergabung ke server.