Sumber dan file lanjutan
Cara NusaPack menemukan pack tiap plugin, cara menunjuk pack sendiri, sumber manual, texture diam, mode glyph per namespace, dan config.yml.
Di halaman ini
Sebagian besar server tidak pernah menyentuh file-file ini: NusaPack menemukan pack setiap plugin dengan sendirinya. Halaman ini untuk setup yang tidak biasa: pack di lokasi khusus, plugin yang tidak bisa dibangun ulang, pack yang digabung ke plugin lain, sumber manual, texture yang harus diam, dan config.yml.
Kapan file ini dibutuhkan
| Situasi | Yang dipakai |
|---|---|
| Sebuah plugin menulis pack-nya di lokasi tidak biasa | source-packs di sources.yml |
| EcoItems, atau pack yang Anda bangun sendiri | source-packs di sources.yml, dan --no-rebuild |
| Anda ingin mendaftarkan sumber secara manual | discovery: manual dan sources di sources.yml |
| Sebagian texture animasi tidak boleh bergerak | still-textures.yml |
| Satu namespace texture butuh mode glyph berbeda | font-rendering.texture-namespaces di sources.yml |
Semua file ini ada di plugins/NusaPackBridge/. Setelah mengedit salah satunya, jalankan /npb config reload, lalu /npb convert.
Cara NusaPack menemukan setiap pack
Untuk setiap plugin, NusaPack mencari dengan urutan berikut:
source-packs.<plugin>disources.yml, jika Anda mengaturnya. Ini selalu diutamakan.- Lokasi output yang disebut di config plugin itu sendiri.
- Lokasi pack default plugin tersebut.
Dari lokasi yang ditemukan di langkah 2 dan 3, ZIP terbaru yang ada yang dipakai. Setiap path harus tetap berada di dalam folder server; path di luar itu diabaikan.
| Plugin | Yang dibaca NusaPack dari config plugin | Default |
|---|---|---|
| Nexo | Pack.generation.output_path di plugins/Nexo/settings.yml | plugins/Nexo/pack/pack.zip |
| Oraxen | Pack.generation.output_path di plugins/Oraxen/settings.yml | plugins/Oraxen/pack/pack.zip |
| CraftEngine | path dari setiap langkah zip di resource-pack.workflows, dan storage_path dari pack yang di-host, di plugins/CraftEngine/config.yml | plugins/CraftEngine/generated/resource_pack.zip |
| ItemsAdder | – | plugins/ItemsAdder/output/generated.zip |
| EcoItems | – | plugins/EcoItems/pack/pack.zip |
Menunjuk pack sendiri
Atur source-packs di sources.yml jika sebuah pack berada di tempat yang tidak dicari NusaPack:
source-packs:
ecoitems: plugins/EcoItems/pack/pack.zip
nexo: plugins/Nexo/pack/pack.zipKey yang bisa dipakai: nexo, itemsadder, oraxen, craftengine, dan ecoitems. Path dihitung dari folder server dan harus tetap berada di dalamnya. File sumber hanya dibaca, tidak pernah diubah.
Sumber yang tidak bisa dibangun ulang
EcoItems tidak punya hook untuk membangun ulang, jadi NusaPack tidak bisa memintanya membuat pack baru. Saat konversi, Anda akan melihat EcoItems can't be rebuilt from here; using the pack it already built. Untuk memperbarui konten EcoItems di Bedrock:
- Bangun pack di EcoItems sendiri.
- Jika letaknya tidak di path default, atur
source-packs.ecoitems. - Jalankan
/npb convert ecoitems --no-rebuild(atau/npb convertbiasa).
Hal yang sama berlaku untuk pack apa pun yang Anda bangun sendiri: tunjuk dengan source-packs dan konversi dengan --no-rebuild. Dalam konversi beberapa plugin, plugin yang belum punya pack dilewati dengan catatan, tanpa menghentikan yang lain.
Pack yang digabung ke plugin lain
Nexo dan Oraxen bisa mengimpor pack plugin lain, misalnya workflow CraftEngine yang menulis ZIP-nya ke ../Nexo/pack/external_packs/CraftEngine.zip. NusaPack menanganinya dengan membangun ulang plugin penggabung paling akhir. Ada dua hal yang perlu diperiksa:
- Nexo hanya menyertakan pack dari
plugins/Nexo/pack/external_packs/jikaPack.import.external_packsbernilaitruedisettings.ymlNexo. - File di folder yang tidak diimpor plugin tidak menjadi bagian dari pack, jadi NusaPack juga tidak bisa melihatnya.
Sumber manual
Dengan discovery: manual di settings.yml, NusaPack berhenti mendeteksi plugin dan hanya membaca sumber yang Anda daftarkan di sources.yml. Pakai contoh berkomentar di bagian atas file itu sebagai template:
sources:
- adapter: AD-NEXO
version: "1.28"
path: plugins/Nexo/pack/pack.zip
precedence: 10Adapter yang tersedia: AD-NEXO, AD-ITEMSADDER, AD-ORAXEN, AD-CRAFTENGINE, dan AD-ECOITEMS. Setiap path harus ada dan berada di dalam folder server; sumber yang tidak bisa dibaca dilewati dengan catatan. Sebagian besar server sebaiknya tetap memakai discovery: auto.
Texture animasi yang dibuat diam
plugins/NusaPackBridge/still-textures.yml berisi daftar texture yang tidak bergerak di Bedrock, walaupun texture_motion: play. Tulis satu pola per entri dalam bentuk namespace:path (path di dalam textures/), dengan * mewakili bagian nama apa pun:
still:
- nexo:item/abyss_sword # satu texture
- mythicmobs:* # satu namespace penuh
- "*:item/weapons/*" # satu folder di semua namespace
- lava_sword # semua texture dengan nama file ini
- "nexo:item/glitch -> hidden" # transparan penuh, bukan frame pertama- Beri tanda kutip pada entri yang diawali
*atau berisi->. - Frame yang dipakai adalah frame yang pertama kali ditampilkan Java (
framesdi file.mcmeta). -> hiddenmembuat texture transparan penuh, berguna untuk overlay yang terlihat aneh jika diam.- Maksimal 256 entri.
Pack sumber Anda tidak pernah diubah; hanya salinan hasil konversi yang dibuat diam. /npb report memberi tahu berapa texture yang dibuat diam dan seberapa kecil pack jadinya. Untuk membuat semua texture animasi diam, pakai texture_motion: still di Pengaturan.
Mode glyph per namespace
font_mode di settings.yml berlaku untuk semua glyph. Untuk memakai mode berbeda pada texture glyph dari satu namespace, tambahkan di sources.yml:
font-rendering:
texture-namespaces:
nexo: java-heightSetiap nilai diisi original atau java-height. Maksimal 32 namespace. Emoji, rank, dan ikon menjelaskan kedua mode tersebut.
config.yml
config.yml menyimpan identitas server dan beberapa pengaman untuk konversi. Biarkan apa adanya. Mode konversi yang dulu ada di sini sekarang menjadi conversion_mode di settings.yml, dan update memindahkannya secara otomatis. Jika config.yml berisi kesalahan, NusaPack melaporkannya saat /npb config reload dan saat server menyala.
Langkah berikutnya
- Pengaturan: opsi sehari-hari.
- Konten yang didukung: apa yang perlu disiapkan di tiap plugin konten.
- Pemecahan masalah: jika sebuah sumber dilewati.