NusaPack overview
What NusaPack does for Bedrock players on your Java server, how it works, and where to start.
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:
| Term | In plain words |
|---|---|
| Geyser | A plugin that lets Bedrock players (phone, console, Windows) join a Java server |
| Floodgate | Geyser's companion plugin that lets Bedrock players join without a Java account |
| Resource pack | The bundle of textures, models, fonts and sounds a client downloads to show custom content |
.mcpack | The file format Bedrock uses for its packs; NusaPack builds one for you |
| Content plugin | A 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 menusYou 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 conversion | Installation |
| Learn the routine after changing content | Everyday use |
| Look up a command | Commands |
| See what converts from each content plugin | Supported content |
| Fix something that does not show up | Troubleshooting |