logo enkisoftware
Independent game developer making AVOYD
en  fr


juliette#enki - posted Tue, 21 Dec 2021 17:48:55 UTC - edited Mon, 28 Aug 2023 16:32:04 UTC - permalink

This tutorial shows how to convert Wavefront .obj file and texture maps to .vox format which Avoyd can import. The output of VoxTool isn't directly compatible with Avoyd as of version 0.8.11, but there is a workaround: open and then save the .vox file in MagicaVoxel before importing it into Avoyd.

Step 1 - convert the 3D polygon mesh using VoxTool

VoxelTool example 3D polygon mesh in Blender VoxelTool example 3D polygon mesh in Blender

Download VoxTool and configure the settings following the video's recommendations:

In the MeshToVoxel tab, starting from the defaults, set:

  • Displacement
    • Signed Displacement Map = True
    • Max Height = 6.00
  • Fill Layer
    • Fill Types = FloodFill
    • Num Layers = 4
  • Options
    • Compressed Output = False

If you use the example files from the video to test the voxelizer:

  • Input Mesh
    • Input File = <..\basic-terrain.obj>
  • Output vox
    • Vox file = <..\basic-terrain.vox>
  • Color
    • ColorMap file = <..\basic-terrain-color.png>
  • Material
    • MaterialMap file = <..\basic-terrain-material.png>
  • Displacement
    • DisplacementMap file = <..\basic-terrain-displacement.png>
  • Grass
    • CoverageMap file = <..\basic-terrain-grasscoverage.png>
    • ColorMap file = <..\basic-terrain-grasscolor.png>

Generate the .vox file.

Step 2 - Use MagicaVoxel to make the vox file compatible with Avoyd

Download and install MagicaVoxel if you don't have it already.

Open the vox file in MagicaVoxel (use the menu, not drag and drop), and save it.

VoxelTool example voxelized and open in MagicaVoxel Voxelized example in MagicaVoxel

Step 3 - Import in Avoyd

Open Avoyd voxel editor and import the vox file: menu File > Import > MagicaVoxel.

VoxelTool example voxelized and open in Avoyd voxel editor Voxelized example in Avoyd voxel editor