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 font under Bridges.
  • 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 glyphs

The 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.yml

After 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 height or scale, 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:

SettingValuesDefaultEffect
font_modeoriginal, java-heightoriginaloriginal keeps each glyph's source pixels; java-height resamples glyphs to the size Java draws them
font_size0, 8, 16, 32, 64, 128, 256128The largest glyph height and Bedrock font cell, in pixels; 0 means no limit, which is 256
font_size_drop_oversizedon, offoffGlyphs taller than font_size: shrink them to fit (off) or leave them out (on)
bedrock_bossbarfull, title-onlyfulltitle-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_size are shrunk, or left out when font_size_drop_oversized is 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

Nusa product documentation · NusaPackPaper 1.21.x · Java 21

Loading the index…