Geyser dan extension
Apa yang dibutuhkan NusaPack dari Geyser, cara extension Geyser-nya dipasang dan diperbarui, cara pack sampai ke pemain Bedrock, dan alasan Geyser di proxy belum didukung.
Di halaman ini
NusaPack bekerja bersama Geyser, plugin yang membuat pemain Bedrock bisa masuk ke server Java Anda. Halaman ini menjelaskan pengaturan Geyser yang dibutuhkan NusaPack, cara extension NusaPack masuk ke Geyser, cara pack hasil konversi sampai ke pemain, dan perubahan mana yang butuh restart.
Yang dibutuhkan NusaPack dari Geyser
| Kebutuhan | Penjelasan |
|---|---|
| Geyser-Spigot di server Paper yang sama | NusaPack mengirim pack-nya ke Geyser-Spigot di server ini. Geyser API 2.11.3 atau lebih baru; diuji dengan 2.12.1. |
| Floodgate | Biasanya dipasang bersama Geyser, agar pemain Bedrock bisa masuk tanpa akun Java. |
| Konten kustom aktif | Opsi enable-custom-content di Geyser harus true (di file config Geyser yang lebih baru, opsi ini ada di bawah gameplay). |
| Resource pack dipaksakan (disarankan) | Jika force-resource-packs bernilai false, pemain Bedrock bisa menolak pack lalu melihat item vanilla. |
Kedua opsi ada di plugins/Geyser-Spigot/config.yml. Ubah saat server mati, atau restart setelahnya. /npb check membaca file ini dan memberi peringatan jika salah satu opsi mati.
Cara extension dipasang
Extension Geyser adalah add-on kecil yang berjalan di dalam Geyser. NusaPack membutuhkannya untuk mendaftarkan item, blok, dan mob, serta untuk menyajikan pack-nya. Anda tidak perlu memasangnya terpisah: nusapack-paper.jar sudah membawanya.
Dengan pengaturan default geyser_extension: auto, setiap kali server menyala prosesnya seperti ini:
- NusaPack menaruh extension-nya di
plugins/Geyser-Spigot/extensions/nusapack-geyser.jar, atau mengganti build lama di sana. - Salinan lain extension NusaPack di folder itu dipindahkan ke
plugins/NusaPackBridge/old-extensions/. Tidak ada yang dihapus. - Geyser memuat extension-nya sebelum NusaPack berjalan, jadi extension yang baru atau berubah baru dipakai pada start berikutnya. Console memberi tahu jika perlu restart.
Di Windows, file yang sedang berjalan bisa terkunci, sehingga penggantiannya dilakukan saat server dimatikan; nyalakan server sekali lagi setelahnya.
Pesan extension saat start
Ringkasan startup di console punya baris Extension:
| Pesan | Artinya |
|---|---|
up to date | Extension sudah sesuai dengan versi NusaPack ini. Tidak ada yang perlu dilakukan. |
installed · restart to load | Pemasangan pertama. Restart satu kali. |
updated · restart to load | Extension yang lebih baru sudah dipasang. Restart satu kali. |
update ready · applied on shutdown, then restart | File sedang terkunci. Matikan server, lalu nyalakan lagi. |
skipped · Geyser not installed | Geyser-Spigot tidak ada di server ini. |
install failed (...) · copy nusapack-geyser.jar to Geyser's extensions | NusaPack tidak bisa menulis file. Periksa izin folder, atau salin sendiri. |
manual | geyser_extension diatur ke manual; NusaPack tidak menyentuh folder itu. |
Jika ada salinan lama yang dipindahkan, baris itu juga menyebut older copy moved to old-extensions.
Mode manual
geyser_extension: manualDengan manual, NusaPack tidak pernah menyentuh plugins/Geyser-Spigot/extensions/. Anda sendiri yang menaruh dan memperbarui nusapack-geyser.jar di sana, dan versinya harus sama dengan nusapack-paper.jar. Jika extension lebih lama dari plugin, konversi akan meminta restart dan menyuruh Anda memperbarui nusapack-geyser.jar. Pengaturan ini berlaku mulai start server berikutnya. Sebagian besar server sebaiknya tetap memakai auto.
Cara pack sampai ke pemain Bedrock
/npb convertmenyelesaikan sebuah pack. Jikaauto_deliveraktif (default), NusaPack langsung menyerahkannya ke extension.- Jika pack hanya mengubah hal yang bisa diganti Geyser saat berjalan (texture, model, menu, font, suara), extension langsung menawarkannya ke sesi Bedrock yang baru. Hasilnya berbunyi Live for Bedrock, dan pemain melihatnya setelah rejoin.
- Jika pack menambah atau menghapus hal yang didaftarkan Geyser saat start, hasilnya berbunyi Installed · restart the server once.
/npb statuslalu menampilkan pack itu di After restart sampai Anda restart. - Saat pemain Bedrock masuk, Geyser mengirim pack-nya. Jika pack dipaksakan, pemain tidak bisa melewatinya.
Yang butuh restart
Geyser hanya mendaftarkan item, blok, dan mob kustom saat ia mulai berjalan. Karena Geyser-Spigot berjalan di dalam server Paper Anda, artinya server perlu restart untuk:
- extension NusaPack yang baru atau diperbarui
- konversi pertama di sebuah server
- menambah atau menghapus item kustom, blok kustom, atau mob ModelEngine
- mengubah perilaku item atau skin player head
- menambah pancingan kustom baru
Selain itu, semuanya langsung berlaku saat rejoin. Baris terakhir /npb convert selalu memberi tahu kasus mana yang berlaku.
Geyser di proxy dan standalone
NusaPack belum mendukung Geyser di proxy Velocity atau BungeeCord, maupun Geyser Standalone. Pengiriman hasil konversi dan bridge live untuk glyph, furniture, serta mob ModelEngine semuanya mengharapkan Geyser-Spigot di server Paper yang sama.
Jika network Anda saat ini menjalankan Geyser di proxy, pasang Geyser-Spigot di server Paper yang menjalankan NusaPack. Nilai manual pada geyser_extension hanya membuat NusaPack berhenti mengelola folder extensions; nilai itu tidak membuat setup proxy atau standalone menjadi didukung.
Langkah berikutnya
- Instalasi: urutan instalasi lengkap.
- Penggunaan sehari-hari: konversi dan pengiriman setelah setiap perubahan.
- Pemecahan masalah: jika
/npb checkmelaporkan masalah extension.