A Java parser for the MagicaVoxel .vox format using libGDX
MagicaVoxel is a great way to edit 3D models easily, as individual colored cubes. If you want to read in a MagicaVoxel .vox file saved relatively recently, you might be surprised at how complicated the format became, compared to how it was around 2014-2018. Some help parsing the format is rather useful now.
This provides a little of that help. You can load up a VoxModel using
VoxParser.readVox(), and from there you can get the various sub-models a .vox
file now consists of using myModel.grids. The .vox format allows various position
adjustments to those grids in a potentially very large space, even though each grid
is at most 256x256x256 voxels in size. Just going through everything .vox can do
would take a while... You may want to look at
SpotVox to see how it works with the
newer types of chunk. This method is what uses a VoxModel there.
It uses different names, like VoxIOExtended is equivalent to VoxParser here.
vox-parser only depends on libGDX, currently 1.12.1 .
For most usage, this goes in your libGDX project's core dependencies:
implementation "com.github.tommyettinger:vox-parser:0.0.1"For GWT, it needs a sources dependency:
implementation "com.github.tommyettinger:vox-parser:0.0.1:sources"As well as this inherits line in your GdxDefinition.gwt.xml file:
<inherits name="com.github.tommyettinger.voxparser" />This may or may not work on GWT. In any case, it relies on IO classes that libGDX makes available.
This project is licensed under the Apache License 2.0.