Penggunaan sehari-hari

Alur kerja setelah mengubah konten, kapan cukup rejoin dan kapan perlu restart, serta konversi otomatis dan panel di dalam game.

Di halaman ini

Setelah NusaPack terpasang, menjaga pemain Bedrock tetap mendapat konten terbaru hanya butuh alur singkat. Halaman ini menjelaskan alur tersebut, kapan cukup rejoin dan kapan perlu restart, serta cara memakai panel di dalam game.

Alur dasar

  1. Ubah konten seperti biasa di Nexo, ItemsAdder, Oraxen, CraftEngine, EcoItems, atau ModelEngine.
  2. Jalankan /npb convert.
  3. Baca baris terakhir hasilnya. Minta pemain Bedrock untuk rejoin, atau restart server satu kali.

Tiga command ini sudah cukup untuk sebagian besar hari:

/npb convert          konversi semuanya dan serahkan ke Geyser
/npb status           apa yang aktif dan apa yang menunggu restart
/npb report errors    alasan sesuatu gagal dikonversi

Di console, ketik command yang sama tanpa garis miring, misalnya npb convert.

Apa yang dilakukan konversi

/npb convert mengerjakan seluruh prosesnya:

  • Mendeteksi plugin konten yang terpasang dan aktif, lalu menampilkan hasilnya, misalnya Detected: Nexo 1.28, ItemsAdder 4.0.15.
  • Membangun ulang pack tiap plugin. ModelEngine dikerjakan pertama, Nexo dan Oraxen terakhir karena keduanya menggabungkan pack plugin lain. ItemsAdder dibangun ulang dengan /iazip, setelah NusaPack menunggu ItemsAdder selesai dimuat.
  • Mengimpor menu chest kustom dari plugin menu Anda (jika gui_auto_import aktif).
  • Mengonversi semuanya menjadi satu pack Bedrock dan menyerahkannya ke Geyser.

Sebelum mengonversi, NusaPack memeriksa sisa ruang disk. Jika ruangnya tidak cukup untuk hasil konversi, proses berhenti dan memberi tahu berapa ruang yang tersedia dan berapa yang dibutuhkan.

Untuk mengonversi plugin tertentu saja, sebutkan namanya: /npb convert nexo atau /npb convert nexo,itemsadder. /npb convert list memungkinkan Anda memilih dari plugin yang terpasang. Tambahkan --no-rebuild untuk memakai pack terakhir yang sudah dibangun tiap plugin, tanpa membangunnya ulang.

Jika sebuah plugin tidak sempat membangun ulang pack-nya, NusaPack memakai pack terakhir yang dibuat plugin itu. Plugin yang belum punya pack, atau daftar itemnya tidak bisa dibaca, dilewati. Plugin lain tetap dikonversi, dan setiap kasus dicantumkan di bawah "Left out or adjusted" beserta alasannya.

Konversi tidak pernah mematikan server atau mengeluarkan pemain dengan sendirinya.

Rejoin atau restart

Yang Anda ubahYang dibutuhkan pemain Bedrock
Texture, model, gambar atau tata letak menu (GUI), font dan glyph, suaraCukup rejoin
Menambah atau menghapus item kustom, blok kustom, atau mob ModelEngineSatu kali restart server
Perilaku item (makanan, tool, durability, dan sejenisnya)Satu kali restart server
Skin player headSatu kali restart server
Pancingan (fishing rod) kustom baruSatu kali restart server
Apa pun, pada konversi pertama di server iniSatu kali restart server

Anda tidak perlu menghafal tabel ini, karena baris terakhir /npb convert selalu memberi tahu. "Live for Bedrock ... players rejoin to see it" berarti cukup rejoin. "Installed · restart the server once" berarti restart satu kali. Geyser hanya mendaftarkan item, blok, dan mob kustom saat ia mulai berjalan, itulah sebabnya perubahan tersebut butuh restart.

Konversi otomatis

Jika Anda sering mengubah konten, biarkan NusaPack mengonversi sendiri setiap kali plugin konten membangun ulang pack-nya:

/npb config auto_convert on

Opsi ini mati secara default. Hasil konversi otomatis ditulis ke console, dan aturan rejoin atau restart di atas tetap berlaku.

Ada juga opsi auto_deliver (aktif secara default) yang langsung menyerahkan setiap konversi yang selesai ke Geyser. Jika dimatikan, hasil konversi disimpan sebagai kandidat dan bisa Anda pasang nanti dengan /npb pack use. Lihat Pengaturan.

Panel di dalam game

Ketik /npb di dalam game untuk membuka panel kontrol NusaPack. Setiap aksi tersedia sebagai tombol, jadi Anda bisa mengonversi, memeriksa, dan mengubah pengaturan tanpa menghafal command. Di console, npb saja akan menampilkan status.

Nether star di bagian atas panel menampilkan status dalam baris-baris singkat, dikelompokkan agar muat di layar Java maupun Bedrock. Contohnya:

Pack
 Active pack: gen-...
 Task: idle
 
ModelEngine bridge
 Models: 4 | Bedrock viewers: 1
 Modeled nearby: 0
 Problems: none
 
Furniture
 Furniture types: 12 | Bedrock viewers: 1
 Shown now: 0
 Problems: none

Sebuah kelompok hanya muncul selama bridge-nya berjalan. Problems menghitung frame yang ditolak atau terlalu besar, serta furniture yang tidak bisa ditampilkan. Untuk angka mentahnya, jalankan npb status di console.

Kembali ke pack sebelumnya

NusaPack menyimpan pack-pack sebelumnya. Jika hasil konversi baru terlihat salah:

  1. Jalankan /npb pack untuk melihat daftar pack sebelumnya, dengan pack aktif di urutan pertama.
  2. Jalankan /npb pack undo untuk kembali ke pack sebelumnya, atau /npb pack use <pack> untuk memasang pack tertentu yang tersimpan.
  3. Jalankan /npb status untuk melihat apakah pack tersebut menunggu restart.

/npb pack keep mengonversi tanpa memasang hasilnya, berguna jika Anda ingin mencoba perubahan lebih dulu.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…