https://github.com/dust-engine/dot_vox

Rust parser for MagicaVoxel .vox files.
https://github.com/dust-engine/dot_vox

hacktoberfest rust

Last synced: 3 months ago
JSON representation

Rust parser for MagicaVoxel .vox files.

• Host: GitHub
• URL: https://github.com/dust-engine/dot_vox
• Owner: dust-engine
• License: mit
• Created: 2016-10-17T06:23:18.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2026-01-28T09:50:48.000Z (5 months ago)
• Last Synced: 2026-01-29T01:12:06.675Z (5 months ago)
• Topics: hacktoberfest, rust
• Language: Rust
• Homepage:
• Size: 112 KB
• Stars: 63
• Watchers: 5
• Forks: 24
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# dot_vox

[![](https://img.shields.io/crates/v/dot_vox.svg)](https://crates.io/crates/dot_vox)

[![CI](https://github.com/dust-engine/dot_vox/actions/workflows/ci.yml/badge.svg)](https://github.com/dust-engine/dot_vox/actions/workflows/ci.yml)

[![](https://docs.rs/dot_vox/badge.svg)](https://docs.rs/dot_vox/latest/dot_vox/)

Rust parser for [MagicaVoxel](https://ephtracy.github.io/) .vox files, using

[Nom](https://github.com/Geal/nom).

## Current status

As of version 3.0.0, we no longer support files with the old `MATT` chunk. If you wish to use 

v3.0.0, please open your file in the latest version of MagicaVoxel and resave - this should 

switch you over to the newer dictionary-based `MATL` chunks. Alternatively, continue to use 

v2.0.0.

The [Dust Engine](https://github.com/dust-engine) project is currently maintaining this crate.

If there are any changes in the MagicaVoxel file format, feel free to open an issue or a PR, and we'll work to get them implemented.

## RustDoc

Kindly hosted over at https://docs.rs/dot_vox/.

## Thanks

`dot_vox` was originally developed by [@davidedmonds](https://github.com/davidedmonds) and many people have contributed to its development.

- [@davidedmonds](https://github.com/davidedmonds) (The original author of this crate)

- [@jice-nospam](https://github.com/jice-nospam) (first crack at palette parsing)

- [@expenses](https://github.com/expenses) (bug report on palette indexing)

- [@xMAC94x](https://github.com/xMAC94x) (bug report on material parsing)

- [@bonsairobo](https://github.com/bonsairobo) (implementation of `write_vox` functionality)

- [@Sixmorphugus](https://github.com/Sixmorphugus) (implementation of Scene Graph parsing)

- [@nickelc](https://github.com/nickelc) (migrating to nom 7 and modernizing the code base)

- [@InBetweenNames](https://github.com/InBetweenNames) (Rolled up changes in multiple PRs and added various helper methods)

- [@virtualritz](https://github.com/virtualritz) (Upgrading the codebase to Rust 2021)