blender_magicavoxel addon

blender_magicavoxel is a free and open-source addon for the Blender 3D modeling software for loading MagicaVoxel VOX files. This itch.io page is intended to make the addon more accessible for users unfamiliar with GitHub. If you enjoy the addon and want to support the maintenance and future development feel free to donate on this page.

Join the Discord to share your creations, discuss, provide feedback, or report issues. If you are familiar with GitHub raising issues over there is appreciated.

blender_magicavoxel is freely available under the MIT license.

---

🧪️ Version Compatibility

The primary goal is the support of the newest version of both MagicaVoxel and Blender. Of course the addon works well with other versions (see Compatibility). If you need support for specific (older) versions, please feel free to create an issue with the version info on GitHub or ask in the comments below.

---

🔧 Installation

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

Go to Edit > Preferences > Add-ons, click on Install, and select blender_magicavoxel.py. After that, activate the addon.

---

✈️ Usage

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

For a fully detailed overview over all import options visit the GitHub repository.

Import Hierarchy

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

Join Models

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

Voxel Size

The voxel size parameter can be used to define the unit voxel size in meters.

Material Modes

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

• ignore
• vertex color
• material per color
• material as texture
• textured models (UV unwrap)

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

Meshing Types

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

• voxels as individual mesh objects
• simple cubes
• simple quads
• greedy

Voxel Hull

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