Skip to content
BasaltProjectPublic

About

World conversion and version upgrades for Basalt

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Basalt Basalt

Basalt Metamorph

Converts and upgrades Minecraft worlds. Native, no JVM.

Java Edition C++ Platforms License

About

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.

Usage

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.

Building

git submodule update --init
cmake --preset release && cmake --build build/release

Needs CMake 3.28+, Ninja and Clang. The binary is build/release/tools/cli/metamorph.

License

GPL-3.0-only.

About

World conversion and version upgrades for Basalt

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages