NusaPack overview

What NusaPack does for Bedrock players on your Java server, how it works, and where to start.

On this page

NusaPack (full name NusaPack Bridge) lets Bedrock players who join through Geyser see your Java server's custom content. This page explains what it does, where it sits between your plugins and Geyser, and which page to read next.

What NusaPack does

Many Java servers use content plugins such as Nexo, ItemsAdder, Oraxen or CraftEngine to add custom items, blocks and menus. Those plugins build a Java resource pack: a bundle of textures, models, fonts and sounds that the Java client downloads. Bedrock players cannot use a Java resource pack, so without help they see plain vanilla items, missing textures and ordinary chests.

NusaPack reads the packs your content plugins already build and turns them into a Bedrock pack. You do not move or copy any files, and your source packs are never changed. Bedrock players can then see:

  • custom items and 3D item models, with their behaviour (food, tools, durability and more)
  • custom blocks and furniture
  • custom armour, and player heads with custom skins
  • emoji, rank and icon glyphs in chat, titles, scoreboards and the tab list
  • custom chest menus (GUIs) drawn with the same background art
  • ModelEngine R4 mobs and custom sounds

A few words you will see in these docs:

TermIn plain words
GeyserA plugin that lets Bedrock players (phone, console, Windows) join a Java server
FloodgateGeyser's companion plugin that lets Bedrock players join without a Java account
Resource packThe bundle of textures, models, fonts and sounds a client downloads to show custom content
.mcpackThe file format Bedrock uses for its packs; NusaPack builds one for you
Content pluginA plugin that adds custom items, blocks or mobs, such as Nexo, ItemsAdder or ModelEngine

How it works

Content plugin (Nexo, ItemsAdder, Oraxen, CraftEngine, EcoItems, ModelEngine)
    |  builds its Java resource pack, as usual
    v
NusaPack  (/npb convert)
    |  converts that pack into a Bedrock pack and item mappings
    v
Geyser on the same Paper server
    |  sends the Bedrock pack to Bedrock players
    v
Bedrock player sees your custom items, blocks, models and menus

You keep working in your content plugins exactly as before. When you change something, run /npb convert and NusaPack does the rest: it rebuilds each plugin's pack, converts everything and hands the result to Geyser.

Gameplay stays on the Java server. Menu clicks, furniture interactions and item rules are still handled by your plugins, so they keep working unchanged.

Before you start

Next steps

I want to...Read
Install NusaPack and run the first conversionInstallation
Learn the routine after changing contentEveryday use
Look up a commandCommands
See what converts from each content pluginSupported content
Fix something that does not show upTroubleshooting
Nusa product documentation · NusaPackPaper 1.21.x · Java 21

Loading the index…