Repository files navigation

Addon for theBlender 3D modeling software forloadingMagicaVoxel VOX files.

If you enjoy the addon and want to support the maintenance and future development feel free to chip in onitch.io.

The latest version can be downloadedhere.

The primary goal is the support of the newest version of both MagicaVoxel and Blender. Of course the addon works wellwith other versions as well (seeCompatibility). If you need support for specific (older) versions,please feel free to create an issue withthe version info.

Starting with Blender 4.2, the addon can be installed directly inside Blender from theextensions platform!

A detailed description of how to install addons in Blender can be found intheBlender documentation for installing addons.

Go toEdit > Preferences > Add-ons, click onInstall, and selectblender_magicavoxel.py. After that, activate theaddon.

Go toFile > Import > MagicaVoxel (.vox) and select the file you want to import.

This options determines whether the hierarchy from MagicaVoxel is imported as empty axis objects in blender and alltransformations (translation and rotation) are applied hierarchically. If not, all transformations are calculatedand applied to each model and no hierarchy parent structure is created.

This option allows all models in the MagicaVoxel file to be merged into one. Joining is done on a voxel basis and beforemeshing which is superior to just combining the blender meshes for generating the voxel hull and greedy meshing.

The voxel size parameter can be used to define the unit voxel size. The example below shows a voxel model imported withvoxel size 1.0, 1.5, and 2.0.

MagicaVoxel files contain a color palette and additional material properties per color in the palette. This addonsupports different modes how this information is imported.

⚠️ Please note: Additional material props are still experimental and under development

Depending on the material mode, additional material properties are either added as a separate vertex color layer,texture, or blender material nodes.

To simplify the workflow from MagicaVoxel to "Game Ready" assets the "Textured Models (UV unwrap)" material modelgenerates textures for base color, emission, roughness, and metallic in combination with UV unwrapping the model facesonto these textures.

As game assets are generally only sensible as optimized meshes, this material mode is only usable/sensible for the"Greedy" meshing mode.

This option is only available for certain meshing types and implicitly active for others. If checked, each model isanalyzed to find the voxel hull and all other voxels inside the model are deleted/ignored.

This addon supports different methods of representing the loaded voxel models.

Voxel as models meshing generates a six-sided cube for each voxel as separate models. Depending on the voxelhull option, cubes are only generated for the hull or all voxels defined in the model.

⚠️ Beware that this option may be slow as alot of cube models may be generated!

Simple cubes meshing generates a six-sided cube for each voxel combined in one mesh per model. Depending on the voxelhull option, cubes are only generated for the hull or all voxels defined in the model.

Simple quads meshing generates the voxel hull of all models and creates only faces where voxel cube faces are visiblefrom outside.

Greedy meshing is equivalent to simple quads as it only creates faces of the voxel hull visible from outside, with theaddition of greedily joining quads where possible.

You may read more about greedymeshinghereandhere.