README.md

haxe-format-vox

A reader for MagicaVoxels's VOX files. Reads most of the v0.99 chunks including the world builder nodes.

• PACK - skipped / unused
• SIZE
• XYZI
• RGBA
• MATT - skipped / unused
• MATL
• nTRN
• nSHP
• nGRP
• rOBJ - missing specs
• LAYR - missing specs

haxe

usage in haxe

var data: BytesData = ...;
format.vox.VoxReader.read(data, function( ?vox, ?err ) {
	if (err != null) {
		trace(err);
		return;
	}

	// use vox.models to get the meshes
	// use vox.nodeGraph to access to world builder nodes
});

haxe examples

• old vox viewer - code - html5 demo
• new vox viewer - code

javascript

usage in javascript

const VoxReader = require('@sh-dave/format-vox').VoxReader;
const data = ...some ArrayBuffer...;

VoxReader.read(data, (vox, err) => {
	if (err) {
		console.error(err);
		return;
	}

	// use vox.models to get the meshes
	// use vox.nodeGraph to access to world builder nodes
});

• a more complete usage example

javascript library build instructions

All dependencies are simply installed via npm thanks to lix

npm install
npx haxe build-js.hxml