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

SituasiYang dipakai
Sebuah plugin menulis pack-nya di lokasi tidak biasasource-packs di sources.yml
EcoItems, atau pack yang Anda bangun sendirisource-packs di sources.yml, dan --no-rebuild
Anda ingin mendaftarkan sumber secara manualdiscovery: manual dan sources di sources.yml
Sebagian texture animasi tidak boleh bergerakstill-textures.yml
Satu namespace texture butuh mode glyph berbedafont-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:

  1. source-packs.<plugin> di sources.yml, jika Anda mengaturnya. Ini selalu diutamakan.
  2. Lokasi output yang disebut di config plugin itu sendiri.
  3. 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.

PluginYang dibaca NusaPack dari config pluginDefault
NexoPack.generation.output_path di plugins/Nexo/settings.ymlplugins/Nexo/pack/pack.zip
OraxenPack.generation.output_path di plugins/Oraxen/settings.ymlplugins/Oraxen/pack/pack.zip
CraftEnginepath dari setiap langkah zip di resource-pack.workflows, dan storage_path dari pack yang di-host, di plugins/CraftEngine/config.ymlplugins/CraftEngine/generated/resource_pack.zip
ItemsAdder–plugins/ItemsAdder/output/generated.zip
EcoItems–plugins/EcoItems/pack/pack.zip

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.zip

Key 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:

  1. Bangun pack di EcoItems sendiri.
  2. Jika letaknya tidak di path default, atur source-packs.ecoitems.
  3. Jalankan /npb convert ecoitems --no-rebuild (atau /npb convert biasa).

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/ jika Pack.import.external_packs bernilai true di settings.yml Nexo.
  • 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: 10

Adapter 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 (frames di file .mcmeta).
  • -> hidden membuat 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-height

Setiap 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

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…