1# foreign-vox23Bridge to the **MagicaVoxel `.vox`** format.
45It reads and writes voxel models in MagicaVoxel's format (a RIFF-like *chunk*
6structure: `MAIN` → `SIZE`/`XYZI`/`RGBA`) and exposes them as a **neutral**
7`VoxModel`: dimensions + a list of `(x, y, z, index)` voxels + a 256-colour RGBA
8palette indexed by the voxel's index.
910No dependencies (only `std`): the format is flat *little-endian* bytes. It knows
11**nothing** about the engine — the converter to `VoxelGrid` lives in
12`llimphi-voxel` (CLAUDE.md rule #4: the foreign thing enters through the bridge,
13the core works natively).
1415---
1617Part of **shared** — see [shared](../README.md).
README.md
foreign-vox
Bridge to the MagicaVoxel .vox format.
It reads and writes voxel models in MagicaVoxel's format (a RIFF-like chunk
structure: MAIN → SIZE/XYZI/RGBA) and exposes them as a neutralVoxModel: dimensions + a list of (x, y, z, index) voxels + a 256-colour RGBA
palette indexed by the voxel's index.
No dependencies (only std): the format is flat little-endian bytes. It knows
nothing about the engine — the converter to VoxelGrid lives in
llimphi-voxel (CLAUDE.md rule #4: the foreign thing enters through the bridge,
the core works natively).