Panduan
Pemecahan masalahImportOutputDiff

Mengapa perintah Minecraft Anda tidak berfungsi

9 menit baca

Sebagian besar perintah yang rusak gagal karena salah satu dari empat alasan: perintah menargetkan versi Minecraft yang salah, pemilih tidak cocok dengan apa pun, format JSON atau NBT salah, atau perintah menggunakan data khusus Java di Bedrock. NBTForge membantu dengan menyusun kembali perintah yang didukung ke dalam bidang yang diketik, menampilkan peringatan, dan menjaga Output tetap terlihat saat Anda mengedit.

Mulailah dengan mengidentifikasi jenis kegagalan, lalu ikuti daftar periksa sebelum mencoba kembali perintah.
Rekatkan perintah yang rusak ke Import terlebih dahulu, lalu konfirmasikan edisi Java dan target versi.
Jaga agar Output tetap terlihat saat memperbaiki perintah, dan gunakan Diff setelah setiap perubahan sehingga pengeditan sebenarnya terlihat jelas.

Hasil panduan

Pass debugging perintah berulang yang mengisolasi masalah sintaksis, target, versi, dan edisi sebelum Anda menempelkannya lagi.

Buka workflow terkaitImport, Output, DiffMen-debug perintah yang rusak

Jalur yang disarankan

  1. Tempelkan perintah ke bilah impor dan periksa apakah NBTForge dapat merutekannya ke modul visual.
  2. Atur Edition dan Version agar sesuai dengan dunia yang akan menjalankan perintah.
  3. Baca peringatan Output sebelum mengganti kolom, terutama saat berpindah antara Java dan Bedrock.
  4. Periksa pemilih target secara terpisah dengan perintah pengujian sederhana sebelum menyalahkan muatan NBT.
  5. Gunakan Diff setelah setiap perbaikan sehingga Anda mengetahui bagian mana dari perintah yang sebenarnya berubah.

Mulailah dengan ketidakcocokan versi

Perintah yang disalin dari dunia Java saat ini bisa gagal di Java 1.20.4 atau yang lebih lama karena sintaks komponen item belum ada. Kebalikannya juga umum terjadi: item lama NBT dapat diterima oleh dunia yang lebih lama tetapi gagal atau berperilaku berbeda setelah komponen item 1.20.5 berubah.

Atur versi NBTForge terlebih dahulu, lalu buat ulang outputnya. Jika perintah berubah bentuk setelah peralihan versi, perlakukan itu sebagai perbedaan sintaksis yang nyata dan bukan penulisan ulang kosmetik.

  • Gunakan Java 1.20.4 atau lebih lama untuk contoh item lama NBT.
  • Gunakan Java 1.20.5+ untuk Output item bergaya komponen.
  • Gunakan Bedrock Stabil hanya ketika keluarga perintah didukung oleh sintaksis Bedrock.

Pisahkan bug pemilih dari bug payload

Perintah yang valid dapat muncul rusak ketika pemilih tidak cocok dengan entitas atau cocok dengan pemain yang salah. Uji pemilih dengan perintah kecil seperti judul, tellraw, atau efek sebelum men-debug pemanggilan panjang atau berikan muatan.

Ketika pemilih menyertakan filter jarak, skor, tag, tim, atau NBT, hapus filter satu per satu hingga perintah mulai cocok lagi. Kemudian tambahkan kembali filter dengan langkah sekecil mungkin.

Periksa kutipan dan data bersarang

Perintah panjang biasanya memecah komponen teks JSON yang disarangkan, tanda kutip yang lolos, nama item, baris lore, atau NBT yang ditulis tangan. Jika perintah menyertakan teks pemutar yang terlihat, buat ulang teks tersebut di editor visual alih-alih mengedit karakter kutipan dengan tangan.

NBTForge paling berguna setelah impor karena mengubah string besar menjadi bidang yang diketik lebih kecil. Edit satu bidang, periksa Output, dan hindari mengubah beberapa bagian bertingkat sekaligus.

  • Nama dan lore sering gagal karena teks JSON di-escape ganda.
  • Buku bisa gagal jika teks halaman berisi tanda kutip yang tidak lolos.
  • Data khusus bisa gagal bila kurung kurawal atau tanda kurung tidak menutup dalam urutan yang benar.

Kirimkan artefak yang disalin

Gunakan panduan ini untuk menghasilkan artefak yang akan dijalankan oleh pemain atau pembuat peta: perintah yang disalin, paket Project yang dipesan, atau sumber daya datapack. Peninjauan akhir harus dilakukan pada Output yang disalin tersebut, tidak hanya pada status pembuat yang dapat diedit.

Jika alur kerja peka terhadap versi, beri label versi target di samping perintah. Saat menggunakan penyeleksi, scoreboard, bossbar, tag, loot table, atau urutan Project, uji dependensi tersebut di dunia yang bersih sebelum memublikasikan pengaturannya.

Untuk contoh langsung yang akan di-debug, bandingkan Preset perintah zombie menunggangi laba-laba, Preset perintah pemanggilan spider jockey, dan Preset loot bos api Blaze Emperor.

  • Copy dari Output untuk satu perintah dan dari Project untuk paket yang dipesan.
  • Pisahkan varian Java, Bedrock, dan snapshot.
  • Uji penyeleksi destruktif dengan Output yang tidak berbahaya terlebih dahulu.
  • Perbarui preset terkait saat panduan menjadi alur kerja kanonik.

Panduan dan preset terkait

FAQ

Mengapa suatu perintah berfungsi di satu dunia tetapi tidak di dunia lain?

Penyebab paling umum adalah ketidakcocokan versi atau edisi Minecraft. Sintaks item Java, fitur snapshot, dan dukungan perintah Bedrock dapat berbeda meskipun perintahnya terlihat serupa.

Haruskah saya memperbaiki perintah yang panjang dengan tangan?

Hanya untuk pengeditan kecil. Untuk perintah item panjang, pemanggilan, teks, atau datapack, impor perintah dan edit bidang secara visual sehingga pelolosan kutipan dan data bertumpuk tetap lebih mudah ditinjau.

Kapan panduan ini menjadi paket Project?

Gunakan Project ketika alur kerja memerlukan lebih dari satu perintah, memiliki perintah pengaturan dan pembersihan, atau harus diedit lagi setelah pengujian. Perintah satu kali dapat tetap berada di Output.