Item dan armor

Cara item kustom, model 3D, perilaku item, player head, armor, dan equipment dikonversi, apa yang dilihat pemain Bedrock, dan batasannya.

Di halaman ini

Item kustom adalah inti dari sebagian besar plugin konten. Halaman ini menjelaskan apa yang dikonversi NusaPack untuk item, armor, dan equipment, apa yang dilihat pemain Bedrock, dan apa yang perlu dilakukan saat sebuah item butuh bantuan Anda.

Yang dilihat pemain Bedrock

  • Setiap item kustom dengan texture atau model 3D-nya sendiri, di tangan, di tanah, dan di inventory.
  • Ikon inventory untuk item 3D.
  • Perilaku item: pemain bisa memakan makanan kustom, menambang dengan tool kustom pada kecepatan yang benar, dan memakai armor kustom, sama seperti di Java.
  • Player head dengan skin kustomnya.
  • Armor yang diwarnai (dyed) dan berlapis dengan warnanya sendiri.

Pemain Java tidak melihat perbedaan apa pun: NusaPack tidak pernah mengubah pack sumber maupun item di server.

Model item dan ikon

NusaPack mengonversi item datar (2D) maupun model item 3D. Untuk item 3D, NusaPack juga membuat ikon inventory. Ukuran ikon mengikuti pengaturan icon_size:

icon_sizeUkuran ikon
auto (default)Mengikuti texture sumber: 16 px menjadi 64, 32 px menjadi 128, lebih besar menjadi 256
32, 64, 128, atau 256Ukuran yang sama untuk semua ikon

Item dengan model 3D yang dipakai di kepala, seperti topi dan helm, terpasang di kepala pemain Bedrock sesuai pengaturan tampilan kepala pada modelnya. Model yang dipakai disembunyikan di sudut pandang orang pertama, sama seperti di Java.

Pack sering merujuk bentuk vanilla tanpa menyertakannya, misalnya block/cross, block/slab, block/stairs, block/cube_column, atau block/leaves. NusaPack menyediakan geometrinya sendiri. Jika pack Anda menyertakan versinya sendiri, versi Anda yang dipakai.

Perilaku item

Perilaku dibaca dari item yang ada di server, bukan ditebak dari pack:

PropertiDi Bedrock
Makanan dan consumable lainBisa dimakan atau dipakai
ToolMenambang dengan kecepatan seperti di Java
Cooldown pemakaianCooldown yang sama
DurabilityDurability yang sama
Ukuran stackBatas stack yang sama
Enchantability dan kilauBisa di-enchant seperti di Java; efek kilau muncul jika diatur
Slot equipmentBisa dipakai di slot yang benar

Geyser membentuk perilaku item satu kali, saat ia mulai berjalan. Karena itu, mengubah perilaku item butuh satu kali restart server setelah konversi.

Player head

Player head dengan skin kustom menampilkan skin tersebut di Bedrock. Mengubah skin sebuah head butuh satu kali restart setelah konversi.

Armor dan equipment

Armor yang diwarnai dan berlapis tampil dengan warnanya sendiri. Mewarnai ulang armor di dalam game tidak mengubah tampilannya di Bedrock.

Untuk equipment Nexo, setiap lapisan equipment Java dicocokkan dengan model Bedrock yang sejenis:

Lapisan JavaDi Bedrock
humanoid, humanoid_leggingsBagian armor biasa, menggantikan lapisan armor vanilla
wingsSayap bergaya elytra, dengan pose meluncur, jongkok, tidur, dan berenang seperti biasa
horse_bodyArmor kuda, hanya pada kuda yang memang ditujukan
llama_bodyArmor llama, juga jika material dasar item-nya PAPER
wolf_bodyArmor serigala; texture Java diberi ruang tambahan agar pas, tidak pernah ditarik

Setiap keluarga equipment memakai satu lapisan texture tetap. Equipment dari pack di plugins/Nexo/pack/external_packs/ hanya dikonversi jika Nexo mengimpor pack eksternal, seperti dijelaskan di Konten yang didukung.

Kasus khusus

  • Item tak terlihat. Item yang model Java-nya minecraft:empty tetap tak terlihat di Bedrock, dengan ikon transparan.
  • Pancingan. Pancingan kustom yang tampilannya berbeda saat dilempar (predicate cast atau kondisi fishing_rod/cast) juga mendapat tampilan itu di Bedrock: Geyser menggantinya selama pelampung berada di air. Pancingan baru butuh satu kali restart, sama seperti setiap item kustom baru.
  • Texture animasi. Texture animasi juga bergerak di Bedrock. Agar diam dan pack lebih kecil, pakai texture_motion di Pengaturan, atau daftarkan texture tertentu di still-textures.yml seperti di Sumber dan file lanjutan.

Item yang menunggu material dasar

Kadang NusaPack tidak bisa memutuskan material dasar Java yang cocok untuk sebuah item. Item seperti itu menunggu pilihan Anda:

/npb report items
/npb report items resolve <item-id> <material>

ID item berbentuk namespace:item/path, dan material adalah nama material Minecraft, misalnya:

/npb report items resolve mypack:item/ruby_sword diamond_sword

Pilihan Anda disimpan; jalankan /npb convert lagi setelahnya. Di panel /npb, tombol Waiting items menampilkan daftar yang sama.

Kapan perubahan terlihat

PerubahanYang dibutuhkan pemain Bedrock
Texture atau model baru untuk item yang sudah adaRejoin
Item baru atau dihapusSatu kali restart server
Perilaku berbeda (makanan, tool, durability, ukuran stack)Satu kali restart server
Skin player head berbedaSatu kali restart server

Baris terakhir /npb convert selalu memberi tahu mana yang berlaku.

Batasan yang diketahui

  • Mewarnai ulang armor di dalam game tidak mengubah tampilannya di Bedrock.
  • Lapisan armor yang berubah saat bermain, seperti dye dinamis atau texture pemain, dilaporkan sebagai masalah alih-alih dikonversi. Begitu juga texture equipment yang hilang dan ukuran texture yang tidak bisa dipakai Bedrock.
  • Item yang modelnya merujuk model atau texture yang tidak ada akan dilaporkan sebagai masalah. Dengan conversion_mode: strict, ini menghalangi konversi sampai Anda memperbaikinya atau beralih ke partial.
  • Item yang modelnya berubah sesuai keadaan atau warna item belum diverifikasi sama persis dengan Java di setiap variasi.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…