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
| Komponen | Yang dibutuhkan | Diuji dengan |
|---|---|---|
| Server | Paper atau fork Paper, Minecraft 1.21.x | Paper 1.21.4 |
| Java | 21 atau lebih baru | 21 |
| Geyser | Geyser-Spigot di server yang sama, API 2.11.3 atau lebih baru | 2.12.1 |
| Floodgate | Biasanya dipasang bersama Geyser | – |
| ProtocolLib | Dibutuhkan 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 R4 | Nexo 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
- Pasang Geyser-Spigot (biasanya bersama Floodgate) dan ProtocolLib di server Paper Anda, jika belum ada.
- Matikan server, lalu taruh
nusapack-paper.jardi folderplugins/. 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 keplugins/Geyser-Spigot/extensions/. - 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. - Jika Anda memakai build berlisensi, masukkan kunci lisensi sekarang. Caranya ada di bagian Kunci lisensi di bawah.
- Restart server.
- Jalankan
/npb convertdi dalam game, ataunpb convertdi 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. - Baca baris terakhir hasilnya dan ikuti petunjuknya.
Membaca baris hasil
| Baris terakhir berbunyi | Yang perlu dilakukan |
|---|---|
| Live for Bedrock · pack ... · players rejoin to see it | Tidak 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 folder | Fungsinya |
|---|---|
settings.yml | Opsi sehari-hari, dengan satu komentar untuk tiap nilai. Mulai dari sini. |
config.yml | Lanjutan: identitas server. Biasanya dibiarkan apa adanya. |
sources.yml | Lanjutan: sumber manual dan lokasi pack yang tidak biasa. |
still-textures.yml | Texture animasi yang sebaiknya diam di Bedrock. |
glyphs-auto.yml | Ditulis setiap kali konversi: tiap glyph beserta tinggi yang dipakai. |
glyphs.yml | Opsional: ukuran glyph pilihan Anda, disalin dari glyphs-auto.yml. |
gui-bindings.json | Opsional: menu chest kustom yang Anda jelaskan secara manual. |
old-extensions/ | Salinan lama extension Geyser yang dipindahkan NusaPack agar tidak bentrok. |
nusa-license.properties | Hanya 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.
- Setelah start pertama, buka
plugins/NusaPackBridge/nusa-license.propertiesdengan text editor. - Tulis kunci lisensi Anda setelah
license-key=di baris tersebut, menggantikan placeholder yang ada, lalu simpan file. - 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
- Matikan server.
- Ganti
nusapack-paper.jardiplugins/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 keplugins/NusaPackBridge/old-extensions/. - 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
- Penggunaan sehari-hari: alur kerja setelah Anda mengubah konten.
- Pengaturan: opsi di
settings.yml. - Pemecahan masalah: jika pemain Bedrock masih melihat item vanilla.