Emoji, rank, dan ikon

Cara glyph font bitmap seperti emoji, badge rank, dan ikon dikonversi, di mana pemain Bedrock melihatnya, cara mengubah ukurannya, dan batasannya.

Di halaman ini

Banyak server memakai glyph font untuk emoji, badge rank, ikon, dan logo. NusaPack mengonversinya agar pemain Bedrock melihat gambar yang sama. Halaman ini menjelaskan di mana glyph muncul, cara memeriksa dan mengubah ukurannya, serta pengaturan glyph.

Yang dilihat pemain Bedrock

Glyph font bitmap dari Nexo, ItemsAdder, dan plugin konten lainnya diubah menjadi halaman font Bedrock. Pemain Bedrock melihatnya di:

  • chat, termasuk tag <glyph:id>
  • title, subtitle, dan action bar
  • scoreboard dan tab list
  • boss bar
  • name tag dan hologram
  • nama dan lore item

Hanya yang diterima pemain Bedrock yang diubah. Pemain Java tetap melihat karakter aslinya, dan teks di command maupun aksi klik atau hover tidak pernah ditulis ulang.

Kebutuhan

  • ProtocolLib dan Geyser-Spigot di server yang sama. Bridge glyph mulai berjalan bersama server jika keduanya aktif dan sudah ada pack hasil konversi; ringkasan startup lalu mencantumkan font di bawah Bridges.
  • Gambar aslinya. PNG setiap glyph harus ada di pack plugin kontennya. Jika Anda hanya memasang config rank atau emoji tanpa file PNG-nya, plugin bisa membuat placeholder; NusaPack melaporkannya sebagai referensi yang hilang alih-alih mengirim placeholder tersebut. Tambahkan PNG asli di path yang ditampilkan, lalu konversi lagi.

Memeriksa glyph hasil konversi

/npb report glyphs

Laporan ini menunjukkan berapa glyph yang dikonversi, berapa yang berukuran besar, berapa yang ukurannya Anda ubah, dan berapa yang dilewati beserta alasannya:

Glyphs
Converted: ... | Large: ... | Overridden: ... | Left out: ...
Review: plugins/NusaPackBridge/glyphs-auto.yml | Overrides: plugins/NusaPackBridge/glyphs.yml

Setiap selesai konversi, plugins/NusaPackBridge/glyphs-auto.yml mencantumkan semua glyph beserta tinggi yang dipakai. Gunakan file ini untuk mencari ID atau codepoint glyph yang ingin Anda ubah. Selama bridge glyph berjalan, /npb status juga menampilkan kelompok Font bridge berisi jumlah teks dan paket item yang ditulis ulang untuk pemain Bedrock.

Mengubah ukuran satu glyph

Salin entri dari glyphs-auto.yml ke plugins/NusaPackBridge/glyphs.yml, lalu atur ukuran yang Anda inginkan:

glyphs:            # berdasarkan id glyph di Nexo atau ItemsAdder
  server_logo: { height: 64 }
codepoints:        # berdasarkan "font/HEX"
  "nexo:default/E302": { height: 16 }
fonts:             # satu font sekaligus
  "nexo:default": { scale: 2 }
  • ID glyph lebih diutamakan daripada codepoint, dan codepoint lebih diutamakan daripada font.
  • Setiap entri memakai height atau scale, tidak boleh keduanya.
  • ID yang dipakai lebih dari satu glyph akan diabaikan; gunakan codepoint-nya.

Jalankan /npb convert, lalu rejoin dengan Bedrock untuk melihat hasilnya.

Pengaturan glyph

Opsi berikut di settings.yml berlaku mulai /npb convert berikutnya:

PengaturanNilaiDefaultEfek
font_modeoriginal, java-heightoriginaloriginal mempertahankan piksel asli setiap glyph; java-height menyesuaikan glyph dengan ukuran yang digambar Java
font_size0, 8, 16, 32, 64, 128, 256128Tinggi glyph terbesar dan ukuran sel font Bedrock, dalam piksel; 0 berarti tanpa batas, yaitu 256
font_size_drop_oversizedon, offoffGlyph yang lebih tinggi dari font_size: diperkecil agar muat (off) atau dilewati (on)
bedrock_bossbarfull, title-onlyfulltitle-only menyembunyikan bar boss Bedrock dan hanya menyisakan judulnya, untuk plugin HUD yang menggambar di judul boss bar

Dengan original, glyph yang PNG-nya lebih tinggi dari tinggi Java yang dideklarasikan akan tampil sesuai ukuran PNG, sehingga bisa terlihat lebih besar daripada di Java. Beralihlah ke java-height, atau atur tingginya di glyphs.yml, jika itu mengganggu. Untuk memakai mode berbeda hanya pada satu namespace texture, lihat Sumber dan file lanjutan.

Kapan perubahan terlihat

Gambar glyph, ukuran, dan pengaturannya adalah perubahan pack saja: setelah /npb convert, pemain Bedrock melihatnya saat rejoin.

Batasan yang diketahui

  • Yang dikonversi adalah glyph bitmap (gambar yang ditaruh di font); jenis font lain tidak.
  • Glyph yang lebih tinggi dari font_size diperkecil, atau dilewati jika font_size_drop_oversized aktif. Glyph yang tidak muat di halaman font Bedrock juga dilewati. Setiap glyph yang dilewati dilaporkan di /npb report glyphs, tidak pernah dibuang diam-diam.
  • Glyph besar yang dipakai sebagai latar menu ditangani oleh Menu chest kustom, bukan sebagai glyph teks.
  • Tanpa ProtocolLib, glyph tetap dikonversi tetapi tidak ditampilkan di chat dan teks lainnya.

Langkah berikutnya

Dokumentasi produk Nusa · NusaPackPaper 1.21.x · Java 21

Memuat indeks…