Finalising and exporting
Everything about getting a model out lives in the Export section of the Voxel tab. There are four ways out:
| Way out | Gives you | Use when |
|---|---|---|
| Finalise To Mesh | An ordinary Blender mesh, in the scene | Rendering, sculpting, or your own export settings |
| Export File | A .glb or .fbx for a chosen engine |
Shipping to a game engine |
| Export .vox | A .vox file |
Opening the model in another voxel editor |
| Export Sprite Sheets | 8-direction PNG sheets + metadata | 2D games (animated characters) |

- What will be exported: the model’s name and size, or for a character its name, how many animations and what it holds. With nothing selected it says so.
- Export File: pick an engine preset.
- Export .vox: save the model as a
.voxfile. - Game-Ready Settings, what Export File does to make a model light for an engine (see below), and Send To Unreal (Live Link).
Finalise To Mesh
Section titled “Finalise To Mesh”In the Voxel Mode section. It bakes the model to one mesh carrying its colours and materials.
| Option | Meaning |
|---|---|
| Merge Coplanar Faces | Merge flat runs of faces into big quads. Much lighter, and a quad never crosses from one colour to another. |
| Keep Voxel Model | Leave the editable model in the scene beside the mesh |
| One Object Per Group | One mesh per group instead of one mesh |
| Build Rig | Also build an armature from the groups (see Groups) |
Export File: engine presets
Section titled “Export File: engine presets”Export ▸ Export File, or File ▸ Export ▸ Voxel Model (.glb/.fbx). Pick an engine and a file name:
| Engine | Format | Conventions |
|---|---|---|
| Godot | glTF binary (.glb) |
Godot’s recommended format, Y up |
| Unity | FBX | −Z forward, Y up, metres |
| Unreal | FBX | Centimetres, the same settings as the live link |
| glTF | glTF binary (.glb) |
Engine neutral: Three.js, Babylon, Sketchfab, web |
| FBX | FBX | Engine neutral: Blender’s own axes, −Z forward, Y up, metres |
These are presets, not options, on purpose. Every engine disagrees about which way is up and how big a metre is, and getting it wrong doesn’t fail: it gives you a model on its side at a hundredth of the size.
Bake Atlas (on by default) collapses the palette into one material and one texture. An engine pays a draw call per material, so shipping 256 palette materials is not an option. The exported model carries one material, one embedded texture and UVs into it.
Animation is included when the model is a rigged character or has a rig from its groups. The selected Action is exported with its frame stepping. See Characters for what each output mode can export.
Game-ready settings: what the atlas is
Section titled “Game-ready settings: what the atlas is”A voxel model in Blender uses its palette: up to 256 colours, each one its own material. That is how it stays editable, but a game engine pays for every material it draws (a draw call each), so a model with thirty materials costs thirty times what it needs to.
So Export File makes the model game-ready on the way out. It does two things, both automatically:
- One texture, one material. Every colour the model uses becomes a small solid square in one image, the atlas, and every face points at its colour’s square. Seven colours make a 32 × 32 pixel texture of about 4 KB.
- Fewer faces. Flat runs of faces of the same colour are merged into big ones. A wall of a hundred voxel faces becomes a handful.
The model looks exactly the same; it’s just far cheaper to draw. Nothing in your scene changes, and you don’t need to do anything first: this happens as the file is written, for models and characters alike.

Export ▸ Game-Ready Settings holds what Export File uses. The defaults suit nearly every model, so most people never open it.
| Group | Setting | Does |
|---|---|---|
| Texture ② | Pixels per Colour | How big each colour’s square is. The colours are solid, so more only helps where an engine blurs textures from far away. |
| Texture Name | The name of the texture and its material. Give each exported set its own, so two exports don’t overwrite each other’s textures in the engine. Empty takes the model’s name. | |
| One Texture for All | Several models exported together share one texture and one material, instead of one each. | |
| (the box below) | How big the texture will be for what is selected: its colours, size and memory. | |
| Mesh ③ | Merge Flat Faces, Angle | Merge flat same-colour faces. This is nearly all of the saving. |
| Merge Distance | Weld points closer than this first. Leave it at 0 for voxel models. | |
| Triangulate | Write triangles, which is what an engine turns everything into anyway. | |
| Texture Files ④ | Roughness Map, Glow Map | Also write a texture of how rough and metallic each colour is (ORM) and one of what glows (emissive), for engines that use them. Auto writes them only when the palette has such materials. |
| Texture Folder, Texture Prefix | Where the texture PNGs go and how their names start. With no folder they are packed into the .blend. |
Make Game-Ready Copy ⑤ does the same to a plain voxel model in the scene: a copy with the atlas and merged faces, beside your editable model. Use it to look at what Export File writes, or to use the light version in Blender itself. A character doesn’t need it (the panel says so instead of showing the button): it’s made game-ready each time you export it.
Export .vox
Section titled “Export .vox”Export ▸ Export .vox, or File ▸ Export ▸ Voxels (.vox). This writes the
voxels, palette and materials to a .vox file.
- Metallic and emission are saved. The roughness of plain matte colours is not.
- A
.voxmodel can be at most 256 on a side. A bigger grid is saved as several models placed side by side in the file. - The active model is written, one model per file.
- Rigs, animation and groups have no place in the
.voxformat and are not written.
Sprite sheets
Section titled “Sprite sheets”For an animated character, Export ▸ Export Sprite Sheets ① renders the animations ticked in Animations & Held Items ▸ Animations to Export ③ (or the character’s current one, if none is ticked) from eight directions.
![]()
② Frame Size and Camera Angle.
| Setting | Choices |
|---|---|
| Frame Size | 64, 128, 256, 512 or 1024 px |
| Camera Angle | Level (0°): true front/back/side views for side-scrollers. Angled (30°): the classic three-quarter view. High (45°). Top-Down (60°) for top-down games. |
It writes a new animation_sprites folder (it never overwrites an old one)
holding:
- one sheet per direction,
- every frame as its own transparent PNG,
- a JSON file with frame timing and the pivot point.
With several animations ticked, each gets its own folder inside it, laid out the
same way, plus an index.json listing them. Every animation is framed alike, so
the sprites line up with each other in a game. A held item is drawn in the
sprites when it is set to Include, and left out otherwise.
Update Every N Frames and Strict Grid carry through, so a sprite sheet can have the stepped, perfectly axis-aligned look of hand-made pixel art.
Choosing what to export
Section titled “Choosing what to export”For a rigged character, Export ▸ Animations & Held Items lists its animations and what it holds. Every export reads it: Export File, sprite sheets and Send To Unreal.
Animations to Export has a tick box for each of the character’s animations. Tick the ones you want: an engine file carries them all as separate, named animations on one skeleton, and sprite sheets get a folder each. With none ticked, the current animation is exported, as before.
Held Items in Export has a row for each thing the character holds (see Held items):
| Choice | Result |
|---|---|
| Include | Part of the character, in every exported frame |
| Leave Out | Not exported |
| Separate | Its own mesh file beside the character’s, named after it, to attach in the engine. The character’s skeleton has a Grip bone in each hand to attach it to. Left out of sprite sheets. |
Separate is what a game with swappable weapons wants: one character, and the sword, axe or torch as their own models, hung on the hand at run time.
Send To Unreal (Live Link)
Section titled “Send To Unreal (Live Link)”If you use Unreal, Send To Unreal pushes the model straight into an open Unreal project, with no file dialog. It needs the paired Voxel Mode Unreal plugin installed in the project; the plugin watches an exchange folder.
The plugin ships with the add-on. Press Install Unreal Plugin in this panel,
pick your Unreal project’s folder (the one with the .uproject file), then
restart the Unreal editor. It is copied to the project’s Plugins folder;
to update it later, close Unreal and press the button again.
| Setting | Meaning |
|---|---|
| Destination Path | Where in the Content Browser the asset lands |
| Pivot | Where the asset’s origin goes |
| Collision | Collision to generate |
| Send Textures | Include the atlas textures |
| Animation | Mode, export all Actions, morph targets, bake step, name prefixes for skeletal mesh / skeleton / animation |
| Options | Asset, material and suffix naming, master material, lightmap UVs, replace existing, exchange folder |
Check For Models looks for models waiting to come back from Unreal, and Open Exchange Folder shows the folder the two sides share.