Emoji, ranks and icons
How bitmap font glyphs such as emoji, rank badges and icons are converted, where Bedrock players see them, how to resize them and the limits.
On this page
Many servers use font glyphs for emoji, rank badges, icons and logos. NusaPack converts them so Bedrock players see the same images. This page explains where they appear, how to check and resize them, and the glyph settings.
What Bedrock players see
Bitmap font glyphs from Nexo, ItemsAdder and the other content plugins become Bedrock font pages. Bedrock players see them in:
- chat, including
<glyph:id>tags - titles, subtitles and the action bar
- scoreboards and the tab list
- boss bars
- name tags and holograms
- item names and lore
Only what Bedrock players receive is changed. Java players keep the original characters, and the text of commands and of click or hover actions is never rewritten.
What you need
- ProtocolLib and Geyser-Spigot on the same server. The glyph bridge starts with the server when both are running and a converted pack exists; the startup summary then lists
fontunderBridges. - The original images. Each glyph's PNG must be in the content plugin's pack. If you only installed rank or emoji configs without their PNG files, the plugin may build a placeholder; NusaPack reports this as a missing reference instead of shipping the placeholder. Add the real PNG at the path shown and convert again.
Check converted glyphs
/npb report glyphsThe report shows how many glyphs were converted, how many are large, how many you resized, and how many were left out and why:
Glyphs
Converted: ... | Large: ... | Overridden: ... | Left out: ...
Review: plugins/NusaPackBridge/glyphs-auto.yml | Overrides: plugins/NusaPackBridge/glyphs.ymlAfter each conversion, plugins/NusaPackBridge/glyphs-auto.yml lists every glyph with the height it shipped at. Use it to find the ID or codepoint of a glyph you want to change. While the glyph bridge runs, /npb status also shows a Font bridge group with how many texts and item packets were rewritten for Bedrock players.
Change one glyph's size
Copy the entry from glyphs-auto.yml into plugins/NusaPackBridge/glyphs.yml and set the size you want:
glyphs: # by the glyph id used in Nexo or ItemsAdder
server_logo: { height: 64 }
codepoints: # by "font/HEX"
"nexo:default/E302": { height: 16 }
fonts: # a whole font
"nexo:default": { scale: 2 }- The glyph ID wins over the codepoint, and the codepoint wins over the font.
- Each entry sets
heightorscale, not both. - An ID that is used by more than one glyph is ignored; use the codepoint instead.
Run /npb convert, then rejoin with Bedrock to see the change.
Glyph settings
These options in settings.yml apply from the next /npb convert:
| Setting | Values | Default | Effect |
|---|---|---|---|
font_mode | original, java-height | original | original keeps each glyph's source pixels; java-height resamples glyphs to the size Java draws them |
font_size | 0, 8, 16, 32, 64, 128, 256 | 128 | The largest glyph height and Bedrock font cell, in pixels; 0 means no limit, which is 256 |
font_size_drop_oversized | on, off | off | Glyphs taller than font_size: shrink them to fit (off) or leave them out (on) |
bedrock_bossbar | full, title-only | full | title-only hides the Bedrock boss bar and keeps its title, for HUD plugins that draw in the boss bar title |
With original, a glyph whose PNG is taller than its declared Java height shows at the PNG's size, so it can look larger than on Java. Switch to java-height, or set a height in glyphs.yml, if that bothers you. To use a different mode for one texture namespace only, see Sources and advanced files.
When changes show up
Glyph images, sizes and settings are pack-only changes: after /npb convert, Bedrock players see them when they rejoin.
Known limits
- Bitmap glyphs (images placed in a font) are converted; other kinds of font are not.
- Glyphs taller than
font_sizeare shrunk, or left out whenfont_size_drop_oversizedis on. Glyphs that do not fit the Bedrock font pages are left out too. Every left-out glyph is reported in/npb report glyphs, never dropped silently. - Large glyphs used as menu backgrounds are handled by Custom chest menus, not as text glyphs.
- Without ProtocolLib, glyphs are converted but not shown in chat and other texts.
Next steps
- Custom chest menus: large glyphs used as menu backgrounds.
- Settings: all options in
settings.yml. - Troubleshooting: when a glyph is too big, too small or missing.