Pemecahan masalah

Temukan penyebab dan solusi masalah NusaPack yang umum, pahami pesan "Left out or adjusted", dan ketahui apa yang perlu dikirim ke support.

Di halaman ini

Sebagian besar masalah NusaPack bisa diatasi dengan cepat. Mulailah dengan dua command di bawah, lalu cari gejala Anda. Setiap baris menjelaskan penyebab yang biasa dan cara memperbaikinya.

Mulai dengan dua command

  1. /npb check menampilkan versi yang dipakai dan memeriksa penyebab umum pemain Bedrock masih melihat item vanilla, masing-masing dengan cara memperbaikinya.
  2. /npb report errors menampilkan setiap masalah dari konversi terakhir, beserta alasannya.

Hasil /npb check yang sehat kurang lebih seperti ini:

Check
Versions
 NusaPack: ...
 Geyser-Spigot: ...
 floodgate: ...
 ProtocolLib: ...
Checks
 Geyser: running
 Custom content: on
 Extension: loaded
 Pack: gen-...
Content plugins
 Nexo: 1.28 | tested
 ItemsAdder: ... | untested, tested with 4.0.15
 ModelEngine: R4.2.0 | supported (R4)
 Untested versions still convert. Try one first with /npb pack keep <plugin>

Baris yang perlu ditindaklanjuti menyebutkan apa yang harus dilakukan, misalnya Custom content: off · set enable-custom-content: true in Geyser's config, then restart.

Gejala, penyebab, dan solusi

GejalaPenyebab yang biasaSolusi
Pemain Bedrock tidak melihat perubahan apa punMereka belum rejoin, atau masih ada restart yang tertundaBaca baris terakhir /npb convert: rejoin untuk "Live for Bedrock", restart satu kali untuk "Installed · restart the server once"
Pemain Bedrock melihat item vanilla di mana-manaKonten kustom mati di Geyser, pemain menolak pack, atau extension belum dimuatJalankan /npb check dan ikuti setiap barisnya; lihat Geyser dan extension
Extension: missing atau not loaded yetStart pertama, atau geyser_extension: manual tanpa jar-nyaRestart satu kali; pada mode manual salin nusapack-geyser.jar ke plugins/Geyser-Spigot/extensions/
Plugin jar: 2 copies atau Extension: 2 copiesJar lama tertinggal di samping jar baruSimpan hanya salinan terbaru lalu restart
"Conversion rejected"Masalah penghalang dengan conversion_mode: strictJalankan /npb report errors dan perbaiki file yang disebutkan, atau /npb config conversion_mode partial
"Nothing to convert"Tidak ada plugin konten yang aktif, atau belum ada yang membangun pack-nyaAktifkan plugin di settings.yml dan bangun pack-nya sekali
"Not enough disk space"Disk tidak cukup untuk hasil konversiKosongkan sebagian ruang (backup lama, log) lalu jalankan /npb convert lagi
Sebuah plugin muncul di "Left out or adjusted"Lihat alasannya di bagian berikutnyaPerbaiki plugin tersebut; plugin lain tetap dikonversi
Peringatan "untested version"Versi plugin Anda berbeda dari versi yang diujiTidak perlu apa-apa; tetap dikonversi. Coba dulu dengan /npb pack keep <plugin> jika ragu
Glyph terlalu besar atau terlalu kecilUkuran PNG berbeda dari tinggi Java-nya, atau diperkecil oleh font_sizeAtur ukurannya di glyphs.yml; lihat Emoji, rank, dan ikon
Glyph hilang atau dilaporkan sebagai referensi yang hilangPNG aslinya tidak ada di packTambahkan PNG asli di path yang ditampilkan, lalu konversi
Menu kustom tampil sebagai chest biasa di BedrockMenu belum diimpor, atau bukan menu chest/npb gui scan, atau buka menunya lalu /npb gui capture; lihat Menu chest kustom
Menu chest terlihat bergeserOffset hasil pengukuran kurang tepat/npb gui tune <id> offset_x atau offset_y dengan nilai piksel, lalu konversi dan rejoin
Furniture bridge disabledBukan Minecraft 1.21.4, atau ProtocolLib tidak adaFurniture butuh 1.21.4 dan ProtocolLib; fitur lainnya tetap berjalan
ModelEngine bridge disabledModelEngine bukan R4, atau ProtocolLib tidak adaPakai ModelEngine R4 dan pasang ProtocolLib
"NusaPack Bridge is locked"Build berlisensi tanpa kunci yang validPerbaiki kunci lalu restart; lihat Kunci lisensi
"... is still running"Ada tugas lain yang sedang berjalanTunggu, pantau dengan /npb status, atau hentikan dengan /npb cancel

Left out or adjusted

Jika sebuah plugin atau item tidak bisa dipakai, konversi tetap berjalan tanpanya dan mencantumkannya di bawah "Left out or adjusted" (maksimal enam baris di chat; sisanya ada di log console). Baris yang sering muncul:

PesanArtinyaSolusi
... did not finish rebuilding in time; using the pack it built last.Plugin terlalu lambatTidak mendesak; pack terakhir Anda yang dipakai. Jalankan konversi lagi nanti
... can't be rebuilt from here; using the pack it already built.Plugin tidak punya hook untuk membangun ulang (EcoItems)Bangun pack-nya sendiri setiap kali kontennya berubah
ModelEngine did not finish regenerating in time; converting the blueprints on disk.ModelEngine terlalu lambatTidak mendesak; blueprint yang ada di disk yang dipakai
... left out: ... has not built its pack yet (... missing)Tidak ada pack di path yang diharapkanBangun pack di plugin tersebut, atau atur source-packs.<plugin> di sources.yml
... left out: ...: pack protected. Build an unprotected source pack first; ...Proteksi atau obfuscation pack aktif di plugin tersebutMatikan pengaturan yang disebut di akhir pesan; lihat Konten yang didukung
... left out: its item list could not be read (...)API item plugin tidak bisa dibacaPastikan plugin dimuat tanpa error; laporkan beserta versi plugin-nya
...: ... item(s) could not be read and were left out (first: ...)Item tertentu tidak bisa dibentukPeriksa item yang disebutkan di plugin-nya

Membaca baris masalah

/npb report errors dan konversi yang ditolak menampilkan satu baris per masalah: file atau item yang bermasalah, apa yang salah, dan kode singkat dalam kurung. Masalah penghalang bisa ditambah baris Expected: yang berisi apa yang diharapkan NusaPack. Di chat hanya beberapa yang pertama yang ditampilkan; sisanya ada di /npb report errors.

Dengan conversion_mode: strict, setiap masalah penghalang membuat pack Bedrock yang sekarang tetap aktif. Perbaiki file yang disebutkan lalu konversi lagi, atau beralih ke partial untuk mengirim semua yang berhasil dikonversi.

Kapan perlu restart

Geyser hanya mendaftarkan item, blok, dan mob kustom saat ia mulai berjalan, jadi hal-hal berikut butuh satu kali restart server setelah konversi:

  • konversi pertama di sebuah server, serta extension NusaPack yang baru atau diperbarui
  • menambah atau menghapus item kustom, blok kustom, atau mob
  • mengubah perilaku item atau skin player head
  • menambah pancingan kustom baru

Texture, model, menu, font, dan suara langsung berlaku saat pemain Bedrock rejoin. /npb status menampilkan pack yang menunggu restart di After restart.

Versi yang belum diuji dan setup yang belum didukung

  • Versi plugin konten selain yang sudah diuji tetap dikonversi, dengan peringatan satu kali. /npb check menunjukkan versi mana saja yang sudah diuji.
  • ModelEngine wajib R4. R3 memakai API yang berbeda.
  • Folia belum didukung.
  • Geyser di proxy atau Geyser Standalone belum didukung; NusaPack membutuhkan Geyser-Spigot di server yang sama.
  • Tampilan furniture membutuhkan Minecraft 1.21.4; di versi lain hanya bridge furniture yang mati.

Yang perlu dikirim ke support

Saat menghubungi support, sertakan:

  • hasil lengkap /npb check (berisi semua versi yang dipakai)
  • hasil /npb report errors, jika konversi gagal
  • baris "Left out or adjusted", jika ada
  • versi plugin konten Anda, dan apa yang Anda ubah
  • apa yang terlihat oleh pemain Bedrock, sebaiknya dengan screenshot

Jangan pernah menyertakan kunci lisensi Anda di pesan, log, atau screenshot.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…