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

KebutuhanPenjelasan
Geyser-Spigot di server Paper yang samaNusaPack mengirim pack-nya ke Geyser-Spigot di server ini. Geyser API 2.11.3 atau lebih baru; diuji dengan 2.12.1.
FloodgateBiasanya dipasang bersama Geyser, agar pemain Bedrock bisa masuk tanpa akun Java.
Konten kustom aktifOpsi 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:

  1. NusaPack menaruh extension-nya di plugins/Geyser-Spigot/extensions/nusapack-geyser.jar, atau mengganti build lama di sana.
  2. Salinan lain extension NusaPack di folder itu dipindahkan ke plugins/NusaPackBridge/old-extensions/. Tidak ada yang dihapus.
  3. 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:

PesanArtinya
up to dateExtension sudah sesuai dengan versi NusaPack ini. Tidak ada yang perlu dilakukan.
installed · restart to loadPemasangan pertama. Restart satu kali.
updated · restart to loadExtension yang lebih baru sudah dipasang. Restart satu kali.
update ready · applied on shutdown, then restartFile sedang terkunci. Matikan server, lalu nyalakan lagi.
skipped · Geyser not installedGeyser-Spigot tidak ada di server ini.
install failed (...) · copy nusapack-geyser.jar to Geyser's extensionsNusaPack tidak bisa menulis file. Periksa izin folder, atau salin sendiri.
manualgeyser_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: manual

Dengan 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

  1. /npb convert menyelesaikan sebuah pack. Jika auto_deliver aktif (default), NusaPack langsung menyerahkannya ke extension.
  2. 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.
  3. Jika pack menambah atau menghapus hal yang didaftarkan Geyser saat start, hasilnya berbunyi Installed · restart the server once. /npb status lalu menampilkan pack itu di After restart sampai Anda restart.
  4. 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

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…