Skip to content

RollySeth/MagicaVoxelUnity

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MagicaVoxelUnity

Unity3D plugin for MagicaVoxel's "vox" format

Features

  • Import "vox" files as meshes (faces combined if possible)
  • Import "vox" files as individual voxels (GameObjects)
    • Voxels can be combined into a single GameObject, so you can cut the voxel model into several GameObjects (meshes) for animation purposes

How To

  • Use MagicaVoxel/Load on the menubar to load and create a GameObject with a voxel model directly

  • Add MVVoxelModel script to your component

    • Use editor controls to load "vox" files onto the object

    • Or use MVVoxelModel's member methods

        LoadVOXFile(filePath, importAsIndividualVoxels)
        LoadVOXData(data, importAsIndividualVoxels)
      
        MVVoxelModel.sizePerVoxel, MVVoxelModel.voxMaterial and MVVoxelModel.meshOrigin can be configured before loading the file/data
      
  • When imported as separate voxels, selecting multiple voxels in the editor will give you a control to combine the selected voxels into a single mesh

    • The mesh can be divided into separate voxels again
  • Use static methods in MVImporter

      Load main chunk:
      
      	LoadVOX(file)
      	LoadVOXFromData(data)
      	
      Create meshes from main chunk:
      
      	CreateMeshes(mainChunk, sizePerVox)
      	
      Or create meshes and GameObjects from main chunk:
      
      	CreateVoxelGameObjects(mainChunk, parentTransform, material, sizePerVox)
      	CreateIndividualVoxelGameObjects(mainChunk, parentTransform, material, sizePerVox)
    

Todo

  • T-junction problems (intersections)
  • Optional palatte texture mode (instead of using vertex color)
  • Optional disable face combining

License

MIT

Contact

About

Unity3D plugin for MagicaVoxel's vox format.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 93.6%
  • GLSL 6.4%