Skip to main content

CLI export

Export a .voxelier project to a Minecraft world without opening the UI:

voxelier --export <project.voxelier> <output_dir> [--version <minecraft>] [post-process flags] [--dry] [--generator void|minecraft]
  • <project.voxelier> — the project to load.
  • <output_dir> — where the world is written, created if needed.
  • --version <minecraft> — target Minecraft version, default 1.20.1.
  • --dry — encode everything in memory without writing to disk, for profiling.
  • --generator void|minecraft — overworld generator outside of the defined area: void by default, or minecraft for normal terrain generation.
voxelier --export my-world.voxelier ./export/my-world --version 1.20.5 --all-features --all-resources

The output is a playable Minecraft world (region/*.mca, level.dat, icon). Copy <output_dir> into your Minecraft saves/ folder to play it.

Target version

Pick the version matching the Minecraft you play in, so the world loads correctly:

--versionMinecraft
1.20.1 (default)1.19 – 1.20.4
1.20.51.20.5 – 1.21.11
26.126.1+

Any number inside a range works (e.g. 1.21.1). The same choice is available as a dropdown in the export dialog of the app.

Post-processing

By default nothing is generated. Flags add steps and can be combined; they match the checklist of the export dialog in the app.

Groups:

FlagBehaviour
--all-featuresAll vanilla features plus the feature layers painted in the project
--all-resourcesVanilla ores plus the resource layers painted in the project
--vanilla-featuresVanilla features only: caves, cactus, grass patches, flowers, sugar cane
--vanilla-resourcesVanilla ores only
--layer-featuresFeature layers painted in the project only
--layer-resourcesResource layers painted in the project only

Shortcuts for individual vanilla features:

FlagBehaviour
--cavesVanilla caves
--oresVanilla ores
--cactusCactus in deserts and badlands
--grassGrass patches on grass blocks
--flowersFlowers on grass blocks
--sugar-caneSugar cane along water banks