Cloud converter · v3 engine

Turn a Java pack into a Bedrock pack.

Upload a .zip, pick a mapping style, and get back a Bedrock pack with its Geyser mappings. Most packs finish in about five minutes. Below that, two studios — a GUI Maker for container menus and a HUD Maker for on-screen overlays.

Getting started

The recommended path

If you're not sure where to begin, follow these three. Everything else on this page is detail you reach for only when you need it.

The converter

Upload & options

Drop a zip, choose a mapping style, start. Refreshing the page is safe — the job reattaches to your session.

[ screenshot — Convert page: upload panel + mapping style + options ]

Zip the contents, not the folder

This is the single most common upload mistake. Your zip has to open directly onto the pack contents.

On Windows: open the pack folder, select everything inside it, then Send to → Compressed (zipped) folder. Selecting the folder itself creates the broken layout above.

Mapping style

Options

In-game

Nova plugin

The hands-off path. One command gathers your pack and plugin files, converts them, and installs the result to Geyser for you.

account:
  api-key: "your-key-here"

Commands

All commands need nova.convert (default: op). Progress shows on a boss bar and your action bar — no chat spam.

After conversion

Install the output

If you're not using the Nova plugin's auto-upload, install by hand. It's three files in three places — plus one optional extension each for 3D display items and MEG4 models.

Manual install

3D display items (furniture, plushies, crops)

If your pack has 3D display items, the converter also outputs a geyser_display_entities file. It's read by the GeyserDisplayEntity extension, which you install once:

MEG4 / BetterModel models

Converted entity models run through GeyserModelEngine — a Geyser extension plus a server plugin. On a proxy network, put the plugin on your backend (sub-)servers only, not the proxy.

The extension reads Novaic's converted model bundle, generates the runtime Bedrock pack itself, and loads it. Do not copy a separate MEG4 or BetterModel pack into Geyser-.../packs/ by hand.

GeyserUtils bridge

Install GeyserUtils-Geyser in Geyser's extensions folder, then install exactly one matching bridge jar for your server or proxy. This is needed by integrations that exchange live server data with Geyser.

Plugin pack

Convert Nexo

Check which item format Nexo generates, match it here, and include your Nexo/items folder.

Pack:
  generation:
    prefer_item_models: true

OBFUSCATION: NONE

Plugin pack

Convert ItemsAdder

Disable every protection, enable legacy CIT armor, regenerate, then upload the generated zip with its contents folder.

zip:
  protect-file-from-unzip:
    protection_1: false
    protection_2: false
    protection_3: false
    short_texture_references: false

resource-pack:
  protect-pack: false
  obfuscation:
    enabled: false

zip:
  custom_armors_shaders_legacy:
    optifine:
      generate_cit:
        1_20_4_lower: true

Entity models

MEG4 / BetterModel

Convert a folder of .bbmodel files to GeyserModelEngine.

Put your .bbmodel files in a models/ folder at the pack root, then turn on MEG4 / BetterModel models on the upload screen — it's off by default, so the folder alone won't convert. Discovered models appear under Model Targets to search and select.

From a server, set converter.model-engine: true and blueprints from plugins/ModelEngine/blueprints/ and plugins/BetterModel/models ride along with every conversion.

During conversion

Material review

Some converted models have no base material defined — nothing in the pack says which vanilla item they should sit on. The panel lists them, each row showing the model with its icon.

In-game, you get clickable [Approve] / [Skip] buttons in chat. Ignore them and it auto-skips after 60 seconds.

During conversion

Fonts & glyphs

Turn your custom emojis, icons and symbols into Bedrock glyph pages. Three related switches — one to convert, two to shape the result, one to review it.

Extra tool

Mapping inspector

Open a finished mapping, see every entry with its icon, and switch a problem item between formats — no re-conversion.

Capabilities

What's supported

Basic is a limited local Nova plugin tier. Premium is the full converter. GUI Maker and HUD Maker are separate UI add-ons.

Studio

GUI Maker

Build chest and container menus on a 512×512 canvas, line the texture up to the real slots, then export an .mcpack.

Set it up

Import a PNG or a Java pack to start. Turn the coloured slot overlays and sample apple icons on while aligning, then off before export so they don't ship in the pack.

Reference

Troubleshooting

The problems people actually hit, and the one-line fix for each.