Skip to content

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)

The Export section for a voxel model

  1. 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.
  2. Export File: pick an engine preset.
  3. Export .vox: save the model as a .vox file.
  4. Game-Ready Settings, what Export File does to make a model light for an engine (see below), and Send To Unreal (Live Link).

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 ▸ 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.

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.

Game-Ready Settings: what it does ①, the texture ②, the mesh ③, texture files ④, Make Game-Ready Copy ⑤

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 ▸ 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 .vox model 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 .vox format and are not written.

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.

Export for a rigged character: sprite sheets and their settings

② 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.

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.

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.