Supported content
What NusaPack converts for Bedrock players, notes for each content plugin, and the current limits.
On this page
This page lists what Bedrock players get from your content plugins, plugin by plugin, and what is not supported yet, so you know what to expect before you convert.
Supported content plugins
| Plugin | Notes |
|---|---|
| Nexo | The pack location is read from Nexo's own config (Pack.generation.output_path). Packs under plugins/Nexo/pack/external_packs/ are only included when Nexo imports them (Pack.import.external_packs: true in Nexo's settings). |
| ItemsAdder | Uses output/generated.zip. Rebuilt with /iazip only, after ItemsAdder has finished loading; ItemsAdder reloads its own content. |
| Oraxen | Rebuilt and converted automatically. Like Nexo, it is handled after the others because it merges their packs. |
| CraftEngine | The pack is found from CraftEngine's workflow zip steps or its hosted pack storage_path. |
| EcoItems | Has no rebuild hook, so NusaPack uses the pack it built last. Build it in EcoItems first; if it lives in an unusual place, set its path in sources.yml. |
| ModelEngine R4 | Blueprints (custom mobs) are converted together with the others, before them. R3 is not supported. |
Any version of these plugins is accepted. Versions other than the tested ones convert normally, with a one-time "untested version" warning. When several plugins are installed, they are merged into one Bedrock pack. You can switch any of them off in Settings.
What Bedrock players get
Items and item behaviour
Custom items, including 3D item models with an inventory icon. Behaviour is read from the live items: custom food and other consumables, tools with their mining speed, cooldowns, durability, stack size and enchantment glint. Bedrock players can eat, mine with or wear these items as on Java.
Custom blocks
Blocks drawn through note blocks, tripwire, chorus plants, mushroom blocks or leaves (Nexo, Oraxen, ItemsAdder, CraftEngine) become real Bedrock blocks, with their model, rotation and textures. Collision follows what the server simulates: a block based on a note block is solid, a plant based on tripwire is not.
Player heads and armour
- Player heads with a custom skin show that skin.
- Dyed and layered armour shows its own colour.
- Nexo wings and horse, llama and wolf armour use the matching Bedrock models.
Furniture
Furniture is shown to Bedrock players through a live bridge, which needs ProtocolLib. The furniture itself still works on the server as before: collision, seats, storage, permissions and breaking are handled by your content plugin.
Furniture display is verified with Nexo furniture on Minecraft 1.21.4. On other Minecraft versions the furniture bridge turns itself off with a log message, and everything else keeps working. Furniture the bridge cannot show is counted under Problems in the status panel.
ModelEngine mobs
ModelEngine R4 models are converted and shown through a live bridge, which also needs ProtocolLib. Adding or removing mobs needs one restart. /npb status shows how many models are active and how many Bedrock players see them.
Emoji, ranks and icons
Bitmap font glyphs from Nexo, ItemsAdder and the other plugins become Bedrock font pages. Bedrock players see them in chat (including <glyph:id> tags), titles, the action bar, scoreboards, the tab list, boss bars, name tags, holograms, and item names and lore.
After each conversion, plugins/NusaPackBridge/glyphs-auto.yml lists every glyph with the height it shipped at. To change one, copy it into glyphs.yml in the same folder:
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. Convert again and rejoin to see the change.
Custom chest menus
A custom menu is a normal chest whose title holds a large background image (a glyph), shifted into place. NusaPack draws that background on the Bedrock chest screen. Slots and clicks stay on the server, so your menu plugins keep working unchanged.
The easiest way is to import menus automatically:
/npb gui scan read the menu files of every supported menu plugin
/npb gui scan deluxemenus only some plugins (comma list)
/npb convert then convert (restart only if it asks)Auto import reads DeluxeMenus, AuraSkills, zMenu, CommandPanels, ChestCommands and TrMenu menu files, so nothing has to be opened in game. It understands titles written with ItemsAdder %img_name%, :name: and :offset_N:, Nexo or Oraxen <glyph:name>, <shift:N> and %nexo_shift_N%, and colour codes. With gui_auto_import on (the default), this runs before every conversion, so new menus are picked up by themselves.
For a menu built in code, or one that still looks wrong, open it in game and run /npb gui capture. It records the title exactly as the server built it, with the real row count, and a later auto import never undoes it. Fine-tune the position with /npb gui tune, described in Commands.
On Bedrock, the Java art becomes the whole background, without the grey Bedrock dialog frame or title. When the art already draws slot frames, Bedrock draws only the items. When it does not, Bedrock draws its own slot frames and a plain panel behind the art.
For full control you can describe a menu by hand in 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 is top_left (offsets from the Java title position) or center. /npb gui remove <id> removes an entry again.
Sounds, animated textures and more
- Custom sounds from your packs are converted too.
- Animated textures move on Bedrock as well. To keep them still for a smaller pack, use
texture_motionor list single textures instill-textures.yml; see Settings. - A custom fishing rod with a different look while cast gets that look on Bedrock too. A new fishing rod needs one restart, like every new custom item.
- Packs often use vanilla shapes without shipping them, such as
block/cross,block/slaborblock/stairs. NusaPack provides that geometry itself; if your pack ships its own version, yours is used.
When something is left out
One plugin never stops the others. A plugin that cannot rebuild in time is converted from the pack it built last. A plugin with no built pack, a protected or obfuscated pack, or an item list that cannot be read is left out. Every such case is listed under "Left out or adjusted" in the result, with the reason.
With conversion_mode set to strict (the default), a blocking problem keeps your current Bedrock pack and lists the problems. With partial, NusaPack ships everything that did convert.
Known limits
- Folia and Geyser on a proxy (Velocity or BungeeCord) are not supported yet.
- Furniture display is verified only on Minecraft 1.21.4, with Nexo furniture.
- ModelEngine must be R4; R3 is not supported.
- Only chest menus are converted. Other containers, such as hoppers, furnaces or anvils, keep their normal Bedrock screen. The pocket (touch) UI layout still shows the vanilla chest.
- Animated menu backgrounds show only their first frame.
- Re-dyeing armour in game does not change its Bedrock look. Armour layers that change while playing, such as dynamic dye or player textures, are reported instead of converted.
- Glyphs taller than the
font_sizelimit are shrunk, or left out if you choose so, and reported in/npb report glyphs.
Next steps
- Everyday use: when changes need a rejoin or a restart.
- Settings: font, icon and animation options.
- Troubleshooting: fixes for menus, glyphs and missing content.