Menu chest kustom

Cara GUI chest kustom diimpor, direkam, diatur, dan dijelaskan manual agar pemain Bedrock melihat gambar latarnya, beserta batasannya.

Di halaman ini

Menu kustom memberi pemain Java layar chest bergaya dengan gambar latar sendiri. NusaPack juga menggambar latar itu di layar chest Bedrock. Halaman ini menunjukkan cara mengimpor menu, merekam menu yang dibuat lewat kode, mengatur posisinya, dan menjelaskannya secara manual.

Cara kerja menu kustom

Menu kustom adalah chest biasa yang judulnya berisi gambar latar besar: sebuah glyph font, ditambah pergeseran ruang negatif yang memindahkannya ke posisi yang tepat. NusaPack menemukan glyph latar tersebut, mengukur posisinya, lalu menggambarnya di belakang layar chest Bedrock.

Slot, item, dan klik tetap ditangani server. Plugin menu Anda tetap bekerja tanpa perubahan, dan NusaPack tidak menjalankan aksi menu apa pun.

Yang dilihat pemain Bedrock

  • Gambar dari Java menjadi seluruh latar, tanpa bingkai dialog abu-abu dan judul bawaan Bedrock.
  • Slot chest, inventory, dan hotbar berada tepat di posisi yang sama seperti di Java.
  • Jika gambarnya sudah menggambar bingkai slot, Bedrock hanya menggambar item-nya. Jika belum (misalnya gambar yang hanya berupa header), Bedrock menggambar bingkai slot dan panel polos di belakang gambar, seperti texture chest bawaan Java.
  • Tombol tutup di pojok menu, karena pemain layar sentuh tidak punya tombol Esc. Anda bisa mematikannya per menu.
  • 1 sampai 3 baris memakai chest kecil Bedrock; 4 sampai 6 baris memakai chest besar.

Hanya pemain Bedrock yang mendapat judul hasil konversi; pemain Java tetap melihat judul aslinya.

Mengimpor menu secara otomatis

/npb gui scan                      baca file menu dari semua plugin menu yang didukung
/npb gui scan deluxemenus,zmenu    hanya plugin tertentu (dipisah koma)
/npb convert                       lalu konversi

Impor otomatis membaca file menu dari plugin-plugin berikut. Tidak ada yang perlu dibuka di dalam game:

Plugin menuFolder yang dibaca
DeluxeMenusplugins/DeluxeMenus/gui_menus/ (hanya menu chest)
AuraSkillsplugins/AuraSkills/menus/
zMenuplugins/zMenu/inventories/
CommandPanelsplugins/CommandPanels/panels/
ChestCommandsplugins/ChestCommands/menu/
TrMenuplugins/TrMenu/menus/

Judul dikenali jika memakai %img_name%, :name:, dan :offset_N: dari ItemsAdder, <glyph:name>, <shift:N>, dan %nexo_shift_N% dari Nexo atau Oraxen, serta kode warna. Posisi latar dihitung dari pergeseran dan spasi di depan glyph, dan jumlah baris dari file menu. File menu hanya dibaca, tidak pernah diubah atau dijalankan.

Hasilnya menunjukkan apa yang berubah, misalnya Added 3 | Updated 0 | Unchanged 2 | Skipped 0. Menu disimpan di plugins/NusaPackBridge/gui-bindings.json, maksimal 64 menu. Jika gui_auto_import aktif (default), impor ini juga berjalan sebelum setiap /npb convert, sehingga menu baru ikut terbaca dengan sendirinya.

Merekam menu di dalam game

Untuk menu yang dibuat lewat kode, atau menu yang masih terlihat salah setelah diimpor, ukur langsung:

  1. Buka menunya di dalam game sebagai pemain.
  2. Selagi menu terbuka, jalankan /npb gui capture, atau /npb gui capture <id> untuk memilih ID-nya.
  3. Jalankan /npb convert.

Rekaman ini menyimpan judul persis seperti yang dibuat server, dengan jumlah baris yang sebenarnya. Impor otomatis berikutnya tidak pernah menimpa hasil rekaman.

Mengatur menu

/npb gui list menampilkan semua menu hasil konversi beserta ID, ukuran, baris, dan offset-nya. Panel /npb punya daftar yang sama di tombol Menus. Lalu atur satu menu:

/npb gui tune <id> offset_y -30      geser latar ke atas atau bawah
/npb gui tune <id> offset_x -8       geser ke kiri atau kanan
/npb gui tune <id> rows 6            1 sampai 6
/npb gui tune <id> enabled off       biarkan menu ini sebagai chest biasa
/npb gui tune <id> close_button off  tanpa tombol tutup di pojok
/npb gui tune <id> slots auto        auto, art, atau native
FieldNilaiEfek
offset_xpikselMenggeser latar ke kiri atau kanan, dalam piksel pada skala GUI Java
offset_ypikselMenggeser latar ke atas atau bawah
rows1 sampai 61 sampai 3 baris memakai chest kecil, 4 sampai 6 memakai chest besar
slotsauto, art, nativeauto memutuskan dari gambarnya; art berarti gambar sudah menggambar bingkai slot; native menggambar bingkai slot Bedrock
enabledon, offoff membiarkan menu ini sebagai chest biasa
close_buttonon, offTombol tutup di pojok menu (aktif secara default)

Menu yang sudah Anda ubah ditandai "edited": true di gui-bindings.json, dan impor tidak akan menyentuhnya. /npb gui list dan plugins/NusaPackBridge/gui-layouts.json menunjukkan keputusan untuk slot (chestSlotsFromArt, inventorySlotsFromArt).

Menjelaskan menu secara manual

Menu yang latarnya berupa glyph besar juga dikenali tanpa impor, dengan asumsi pergeseran -8 px yang umum. Untuk kontrol penuh, jelaskan menu sendiri di plugins/NusaPackBridge/gui-bindings.json:

{
  "schema": 1,
  "layouts": [
    {
      "id": "skills_menu",
      "match": "glyph",
      "texture": "textures/myplugin/skills_menu",
      "rows": 6,
      "width": 256, "height": 256,
      "offsetX": -8, "offsetY": -35,
      "anchor": "top_left"
    }
  ]
}
  • anchor diisi top_left (offset dihitung dari posisi judul Java) atau center.
  • Alih-alih title, sebuah entri bisa memakai javaTitle lengkap (dengan <shift:N> untuk pergeseran) dan membiarkan title kosong. NusaPack lalu mencari glyph latarnya dan mengukur posisinya.
  • ID menu memakai huruf kecil, angka, dan garis bawah.
  • /npb gui remove <id> menghapus entri buatan manual. Menu yang terdeteksi otomatis tidak bisa dihapus dengan cara ini, karena mengikuti pack sumber; gunakan /npb gui tune <id> enabled off.

Kapan perubahan terlihat

Perubahan menu berlaku setelah /npb convert. Perubahan yang hanya menyangkut menu adalah perubahan pack saja, jadi pemain Bedrock melihatnya setelah rejoin. Jika baris terakhir /npb convert meminta restart, restart satu kali.

Batasan yang diketahui

  • Hanya menu chest (1 sampai 6 baris) yang dikonversi. Container lain seperti hopper, furnace, atau anvil tetap memakai layar Bedrock biasa.
  • Tata letak UI pocket (layar sentuh) masih menampilkan chest vanilla.
  • Latar menu yang beranimasi hanya menampilkan frame pertamanya.
  • Gambar latar yang sangat besar, dan karakter glyph yang dipakai beberapa font, mungkin tidak terkonversi penuh; konversi melaporkannya, dan menu tetap menjadi chest biasa.
  • Judul yang tersusun dari beberapa glyph latar bertumpuk tetap memakai judul aslinya.
  • Teks judul yang terlihat di belakang glyph latar disembunyikan di Bedrock.
  • Glyph besar untuk elemen HUD, bukan menu, tidak dikonversi sebagai menu.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…