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
/npb checkmenampilkan versi yang dipakai dan memeriksa penyebab umum pemain Bedrock masih melihat item vanilla, masing-masing dengan cara memperbaikinya./npb report errorsmenampilkan 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
| Gejala | Penyebab yang biasa | Solusi |
|---|---|---|
| Pemain Bedrock tidak melihat perubahan apa pun | Mereka belum rejoin, atau masih ada restart yang tertunda | Baca 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-mana | Konten kustom mati di Geyser, pemain menolak pack, atau extension belum dimuat | Jalankan /npb check dan ikuti setiap barisnya; lihat Geyser dan extension |
Extension: missing atau not loaded yet | Start pertama, atau geyser_extension: manual tanpa jar-nya | Restart satu kali; pada mode manual salin nusapack-geyser.jar ke plugins/Geyser-Spigot/extensions/ |
Plugin jar: 2 copies atau Extension: 2 copies | Jar lama tertinggal di samping jar baru | Simpan hanya salinan terbaru lalu restart |
| "Conversion rejected" | Masalah penghalang dengan conversion_mode: strict | Jalankan /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-nya | Aktifkan plugin di settings.yml dan bangun pack-nya sekali |
| "Not enough disk space" | Disk tidak cukup untuk hasil konversi | Kosongkan sebagian ruang (backup lama, log) lalu jalankan /npb convert lagi |
| Sebuah plugin muncul di "Left out or adjusted" | Lihat alasannya di bagian berikutnya | Perbaiki plugin tersebut; plugin lain tetap dikonversi |
| Peringatan "untested version" | Versi plugin Anda berbeda dari versi yang diuji | Tidak perlu apa-apa; tetap dikonversi. Coba dulu dengan /npb pack keep <plugin> jika ragu |
| Glyph terlalu besar atau terlalu kecil | Ukuran PNG berbeda dari tinggi Java-nya, atau diperkecil oleh font_size | Atur ukurannya di glyphs.yml; lihat Emoji, rank, dan ikon |
| Glyph hilang atau dilaporkan sebagai referensi yang hilang | PNG aslinya tidak ada di pack | Tambahkan PNG asli di path yang ditampilkan, lalu konversi |
| Menu kustom tampil sebagai chest biasa di Bedrock | Menu belum diimpor, atau bukan menu chest | /npb gui scan, atau buka menunya lalu /npb gui capture; lihat Menu chest kustom |
| Menu chest terlihat bergeser | Offset hasil pengukuran kurang tepat | /npb gui tune <id> offset_x atau offset_y dengan nilai piksel, lalu konversi dan rejoin |
Furniture bridge disabled | Bukan Minecraft 1.21.4, atau ProtocolLib tidak ada | Furniture butuh 1.21.4 dan ProtocolLib; fitur lainnya tetap berjalan |
ModelEngine bridge disabled | ModelEngine bukan R4, atau ProtocolLib tidak ada | Pakai ModelEngine R4 dan pasang ProtocolLib |
| "NusaPack Bridge is locked" | Build berlisensi tanpa kunci yang valid | Perbaiki kunci lalu restart; lihat Kunci lisensi |
| "... is still running" | Ada tugas lain yang sedang berjalan | Tunggu, 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:
| Pesan | Artinya | Solusi |
|---|---|---|
... did not finish rebuilding in time; using the pack it built last. | Plugin terlalu lambat | Tidak 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 lambat | Tidak mendesak; blueprint yang ada di disk yang dipakai |
... left out: ... has not built its pack yet (... missing) | Tidak ada pack di path yang diharapkan | Bangun 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 tersebut | Matikan pengaturan yang disebut di akhir pesan; lihat Konten yang didukung |
... left out: its item list could not be read (...) | API item plugin tidak bisa dibaca | Pastikan plugin dimuat tanpa error; laporkan beserta versi plugin-nya |
...: ... item(s) could not be read and were left out (first: ...) | Item tertentu tidak bisa dibentuk | Periksa 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 checkmenunjukkan 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
- Penggunaan sehari-hari: alur normal konversi, rejoin, dan restart.
- Konten yang didukung: apa yang dikonversi dan apa yang perlu disiapkan per plugin.
- Geyser dan extension: masalah extension dan pengiriman pack.