Introduction to Magica Voxel – a Free 3D Voxel Modelling Tool

In this article, I will introduce how to download Magica Voxel, how to use it, and how to export a 3D model created with it.

In this tutorial, I am using macOS, but you can use Windows in the same way. Please be aware that the UI and other features may be different.

About Magica Voxel

Magica Voxel is open-source software which allows you to create models with voxels.

The official site is here. You can download the software from this site.

Magica Voxel – Top page

How to Download Magica Voxel

Access the official site, where you will be able to download the software.
There is a version for each OS (Magica Voxel supports Mac and Windows only), so download the one compatible with your system. The download doesn’t take long.

Download ‘Magica Voxel’


About the Error When Launching

When launching Magica Voxel on macOS, you may see it doesn’t start up, showing a black screen.


‘Magica Voxel’ icon

In that case, follow the sequence below to launch.

  1. Decompress the compressed file you downloaded.
  2. Temporarily move the ‘Magica Voxel’ icon (See the image above) from the decompressed file to the desktop or another folder.
  3. Move the ‘Magica Voxel’ icon, which you just moved to the desktop, back to the decompressed file.

How to solve the error when launching Magica Voxel

That should fix any launch errors. Please try this solution if you struggle with this error.

Navigation Tools and User Interface in Magica Voxel 

Now, I will explain how to use the navigation tools and user interface in Magica Voxel.
Of course, you can use the navigation tools with your mouse. But, I will be using them with a trackpad.

Navigation Tools 

  • Scale > Slide two fingers

Navigation – Scale-up


Navigation – Scale-down


  • Rotate camera (Scene Tumbling) >  Click with two fingers and slide them. If you do the same with one finger, it selects an area or creates a voxel, etc.
  • Undo (Ctrl+Z)
  • Cancel the selection (Ctrl+D)
  • Delete (‘Delete’ key) > you can delete the voxel selected.

By the way, I found that ‘Copy and Paste’ commands will not work.

User Interface in Magica Voxel

Now, I will explain the basics of the user interface in Magica Voxel.

The UI in Magica Voxel

1. Color Palette

You can change the color of each voxel here. The numbers, 1 to 4, are written below the caption ‘Palette’. These are the color palettes for each color tone. By default, there are some color palettes that are available like grayscale, low-tone colors, etc.

2. Brush Palette

This palette allows you to change the ‘Edit’ mode when you paint or create voxels. 

The Edit mode

The Brush tool has the following Edit modes .

When you create a line, press the ‘Attach’ button first. Then, you can draw a line with voxels. There are ‘Project’ and ‘Straight’ modes.

When you create a face, press the ‘Attach’ button first. You can create ‘Circle’ or ‘Square’ faces. They are created from the center point.


You can add a registered pattern. Patterns can be rotated around X, Y, and Z-axes.

This allows you to create a sphere or voxel. You can create or add them in ‘Attach’ mode and you can paint them in ‘Paint’ mode. In ‘Erase’ mode, you can erase voxels with the pattern you set.

This allows you to create a face with voxels. You can create or add it in ‘Attach’ mode and paint a face in ‘Paint’ mode. In ‘Erase’ mode, you can delete the face selected.

You can add, paint, and delete voxels with a box specified by dragging the mouse. ‘Attach’ mode adds voxels and ‘Paint’ mode paints them with the color selected from the color palette. In ‘Erase’ mode, you can delete voxels with the box specified.

3. Scene

You make your voxel model here. You can switch the screen to display the rendered image by selecting the ‘Render’ tab that is highlighted in the red box below.

‘Rendering’ screen

4. Edit Tool

In the panel highlighted in the red box below, you can set scale, flip, and rotate voxels.

By the way, in Magica Voxel, you can only create voxels in the wireframe box that contains the model. If you want to modify it you change the values highlighted in the light blue box below.

Edit tool


5. Project and Outline

In the panel highlight in the red box, you can find voxel models available by default and there is the ‘Outline’ tab where you can manage the hierarchy of the model.

Project / Pattern / Outline


Next, let’s create a voxel model.

Modelling with Magica Voxel

First, launch Magica Voxel and display a new Scene.

After getting used to the user interface, press the ‘Document’ icon (New Project) in the top right corner of the screen to create a new voxel model.

‘Create New’

First, select ‘Line Mode’, ‘Attach’, and ‘Box Select’. Set ‘Line Mode Option’ to ‘Straight’ and then select one-fifth of the total height from the bottom.

‘Box Select’


Next, select a green color from the color palette and press the ‘Replace Vox Color’ icon.
By clicking the voxels selected earlier you can paint them all at the same time.

Color voxels #1

Similarly, paint the rest (i.e. remaining 80% of the height) red.

Colour voxels #2


Next, let’s shape the model.
Select voxels with ‘Box Select’ and press the ‘Delete’ key. As shown in the image below, delete each end by 1/3 of the width.

Delete by using ‘Box Select’


Now, let’s add the details.
Select ‘Voxel Mode’ and ‘Erase’. Then set ‘Mirror’ to ‘Y’ and ‘Axis’ to ‘X’. As shown in the following screenshot, draw lines to form a triangle.

Erase with ‘Mirror’ function


After drawing a triangle with ‘Mirror’ function, we are going to cut off unnecessary voxels. 
Select ‘Face Mode’ and ‘Erase’. Then set ‘Mirror’ to ‘Y’ and ‘Axis’ to ‘X’. You can delete the remaining part all at once by selecting it and pressing the Delete button.

Erase with ‘Face’ mode


Lastly, we will paint the model.
Select ‘Voxel Mode’ and ‘Paint’. Then, select color from a color palette.

Paint the model



To finish this model, I will briefly explain how to apply ‘Rendering’.


1. Render Button

Press this button to switch to the ‘Rendering’ screen.


2. Light Editor

You can set up ‘Area Light’, ‘Sky Light’, ‘Fog’, etc.


3. Matter Editor

This allows you to change the material (Diffuse, Metal, Glass, etc.). You can set up the camera and insert an image. You can also modify the image size when exporting the model.


4. ‘Render’ Button

This will start exporting the rendered image.


The rendered image

If you change parameters often, this could drain the battery quickly. So, render the model step by step while monitoring the condition.



When the model is completed, export it in a 3D file format.

In the ‘Export’ menu in the bottom right corner of the screen, select a file format to export. This time we export the model as an .obj file format.
Specify where to save it and press ‘Save’ to export the model.

Export the model


Import Your Model Into STYLY

After preparing your 3D model, check the final state by importing it into STYLY.
Login to STYLY and create a VR space. Please refer to the following article to create your STYLY account.

STYLY – top page

Open the Import screen as shown below (Press ① and then ②).

STYLY – ‘3D model import’ screen

After uploading the model, click on the added model from your ‘My Model’ page.

I found that the model imported to STYLY had its pivot point shifted and had no textures attached. You could adjust the pivot center and textures in Unity if you want to. The model doesn’t make sense without textures.

The model imported

That’s all for this tutorial. In this tutorial we have ‘created a simple model’ and ‘imported it to STYLY’.

How did you like this tutorial? It’s fairly easy to create a voxel model with Magica Voxel. Although it’s a free software, the renderer feature performs very well. You can generate a beautiful high-quality image. Please try Magica Voxel and create your own original models through trial and error.