Instalasi NusaPack

Pasang NusaPack, lakukan start pertama dan satu kali restart, jalankan konversi pertama, dan temukan file konfigurasinya.

Di halaman ini

Halaman ini memandu Anda dari folder plugins/ yang masih kosong sampai pemain Bedrock bisa melihat konten kustom Anda. Siapkan waktu untuk satu atau dua kali restart selama setup pertama.

Kebutuhan

KomponenYang dibutuhkanDiuji dengan
ServerPaper atau fork Paper, Minecraft 1.21.xPaper 1.21.4
Java21 atau lebih baru21
GeyserGeyser-Spigot di server yang sama, API 2.11.3 atau lebih baru2.12.1
FloodgateBiasanya dipasang bersama Geyser–
ProtocolLibDibutuhkan untuk tampilan live di Bedrock: glyph di chat dan tab list, menu kustom, furniture, dan mob ModelEngine. Konversi tetap bisa berjalan tanpanya.5.4.0
Plugin konten (opsional, kombinasi apa pun)Nexo, ItemsAdder, Oraxen, CraftEngine, EcoItems, ModelEngine R4Nexo 1.28, ItemsAdder 4.0.15, Oraxen 1.220.1, CraftEngine 26.9.2, EcoItems 5.58.0, ModelEngine R4.2.0

Versi plugin konten lainnya juga diterima. Konversinya tetap berjalan normal dengan peringatan "untested version" satu kali, dan /npb check menunjukkan versi mana saja yang sudah diuji. ModelEngine wajib versi R4; R3 memakai API yang berbeda.

Langkah instalasi

  1. Pasang Geyser-Spigot (biasanya bersama Floodgate) dan ProtocolLib di server Paper Anda, jika belum ada.
  2. Matikan server, lalu taruh nusapack-paper.jar di folder plugins/. Hanya file ini yang perlu Anda pasang dan perbarui. Di dalamnya sudah ada extension Geyser milik NusaPack (add-on kecil yang berjalan di dalam Geyser), dan NusaPack menyalinnya sendiri ke plugins/Geyser-Spigot/extensions/.
  3. Nyalakan server. Pada start pertama ini, NusaPack memasang extension Geyser-nya dan membuat folder plugins/NusaPackBridge/. Console lalu meminta satu kali restart lagi agar Geyser bisa memuat extension tersebut.
  4. Jika Anda memakai build berlisensi, masukkan kunci lisensi sekarang. Caranya ada di bagian Kunci lisensi di bawah.
  5. Restart server.
  6. Jalankan /npb convert di dalam game, atau npb convert di console. Satu command ini mengerjakan semuanya: membangun ulang pack setiap plugin konten yang terpasang, mengimpor menu chest kustom, mengonversi item, blok, armor, font, suara, menu, dan mob ModelEngine, lalu menyerahkan hasilnya ke Geyser.
  7. Baca baris terakhir hasilnya dan ikuti petunjuknya.

Membaca baris hasil

Baris terakhir berbunyiYang perlu dilakukan
Live for Bedrock · pack ... · players rejoin to see itTidak ada lagi. Pemain Bedrock melihat pack baru setelah keluar lalu masuk lagi (rejoin).
Installed · restart the server once (...)Restart server satu kali. Geyser hanya mendaftarkan item, blok, dan mob kustom saat ia mulai berjalan; itu aturan Geyser, bukan aturan NusaPack.

Konversi pertama di sebuah server selalu membutuhkan satu kali restart. Setelah itu, banyak perubahan cukup dengan rejoin; Penggunaan sehari-hari menjelaskan mana saja.

Jika ada konten yang tidak ikut terkonversi, hasilnya mencantumkannya di bawah "Left out or adjusted" beserta alasannya. Masalah di satu plugin tidak pernah menghentikan plugin lain.

Lokasi file

Semua yang dibuat NusaPack ada di plugins/NusaPackBridge/:

File atau folderFungsinya
settings.ymlOpsi sehari-hari, dengan satu komentar untuk tiap nilai. Mulai dari sini.
config.ymlLanjutan: identitas server. Biasanya dibiarkan apa adanya.
sources.ymlLanjutan: sumber manual dan lokasi pack yang tidak biasa.
still-textures.ymlTexture animasi yang sebaiknya diam di Bedrock.
glyphs-auto.ymlDitulis setiap kali konversi: tiap glyph beserta tinggi yang dipakai.
glyphs.ymlOpsional: ukuran glyph pilihan Anda, disalin dari glyphs-auto.yml.
gui-bindings.jsonOpsional: menu chest kustom yang Anda jelaskan secara manual.
old-extensions/Salinan lama extension Geyser yang dipindahkan NusaPack agar tidak bentrok.
nusa-license.propertiesHanya untuk build berlisensi: tempat kunci lisensi Anda.

Extension Geyser-nya sendiri berada di plugins/Geyser-Spigot/extensions/.

Kunci lisensi

Langkah ini hanya untuk build berlisensi.

  1. Setelah start pertama, buka plugins/NusaPackBridge/nusa-license.properties dengan text editor.
  2. Tulis kunci lisensi Anda setelah license-key= di baris tersebut, menggantikan placeholder yang ada, lalu simpan file.
  3. Restart server.

Jika hosting Anda mendukung environment variable, Anda juga bisa menaruh kunci di NUSAPACK_LICENSE_KEY. Jika variabel itu diisi, nilainya yang dipakai, bukan isi file.

Extension Geyser membaca file yang sama, jadi kunci cukup dimasukkan sekali. Selama belum ada kunci yang valid, plugin tetap nonaktif dan setiap command /npb menjawab "NusaPack Bridge is locked". Console akan menjelaskan apa yang salah. Jaga kerahasiaan kunci Anda: jangan pernah menempelkannya di chat, tiket, atau screenshot.

Memperbarui NusaPack

  1. Matikan server.
  2. Ganti nusapack-paper.jar di plugins/ dengan versi baru. Extension Geyser tidak perlu Anda sentuh: saat server menyala, NusaPack mengganti build lama di folder extensions Geyser, dan memindahkan salinan lama dengan nama lain ke plugins/NusaPackBridge/old-extensions/.
  3. Nyalakan server dan baca console. Extension yang baru atau berubah dimuat mulai start berikutnya, dan console akan memberi tahu bila perlu restart.

Pengaturan Anda tetap aman. Opsi baru ditambahkan di akhir settings.yml lengkap dengan komentarnya, dan nilai yang sudah Anda atur tidak disentuh. Nilai dari versi lama di sources.yml atau config.yml dipindahkan ke settings.yml secara otomatis.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…