Converts and upgrades Minecraft worlds. Native, no JVM.
Metamorph reads a Minecraft Java Edition world and writes it back in another shape, without touching the original:
- Between region formats: Anvil (
.mca), Linear (.linear) and Basalt's own bsw (.bsw), the default for new Basalt Server worlds. Each chunk is checked after converting. - Between versions: every chunk and entity file from an older game is brought to the current world version, with the same fixes the official game applies when it opens an old world.
It is a command line tool for people moving a world, and the library that Basalt Server uses to read and convert worlds on load, as a git submodule.
metamorph convert <world> --to anvil|linear|bsw [-o <out>]
metamorph upgrade <world> [-o <out>]
The input is never modified: the result goes to <world>.converted unless -o says otherwise, and an output folder
that already holds files is refused.
git submodule update --init
cmake --preset release && cmake --build build/releaseNeeds CMake 3.28+, Ninja and Clang. The binary is build/release/tools/cli/metamorph.