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, default1.20.1.--dry— encode everything in memory without writing to disk, for profiling.--generator void|minecraft— overworld generator outside of the defined area:voidby default, orminecraftfor 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:
--version | Minecraft |
|---|---|
1.20.1 (default) | 1.19 – 1.20.4 |
1.20.5 | 1.20.5 – 1.21.11 |
26.1 | 26.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:
| Flag | Behaviour |
|---|---|
--all-features | All vanilla features plus the feature layers painted in the project |
--all-resources | Vanilla ores plus the resource layers painted in the project |
--vanilla-features | Vanilla features only: caves, cactus, grass patches, flowers, sugar cane |
--vanilla-resources | Vanilla ores only |
--layer-features | Feature layers painted in the project only |
--layer-resources | Resource layers painted in the project only |
Shortcuts for individual vanilla features:
| Flag | Behaviour |
|---|---|
--caves | Vanilla caves |
--ores | Vanilla ores |
--cactus | Cactus in deserts and badlands |
--grass | Grass patches on grass blocks |
--flowers | Flowers on grass blocks |
--sugar-cane | Sugar cane along water banks |