Preferences
Open Edit ▸ Preferences ▸ Add-ons, find Voxel Mode and expand it. Keyboard shortcuts have their own page.
Example scenes
Section titled “Example scenes”Buttons in the preferences that open a shipped scene as a new, unsaved file:
| Button | Opens |
|---|---|
| Open Shape Examples | Every built-in shape as its own model, to look at or take apart |
| Open Water Example | A pond: water, ice and glass entries with their surfaces set up |
Settings
Section titled “Settings”| Option | Type | Default | What it does |
|---|---|---|---|
| Palette Folder | String | Folder searched for .json and .png palettes, which then appear in the palette dropdown. Leave empty to use Blender’s own scripts folder | |
| Shape Library Folder | String | Folder searched for saved shapes, which then appear in the Voxel Library. .json shapes and .vox files both count. Leave empty to use Blender’s own scripts folder | |
| My Animations Folder | String | Folder where animations saved with Save to My Animations are kept, for any character and project. Leave empty to use Blender’s own scripts folder | |
| Edit New Models Straight Away | Boolean | True | Pick up the voxel tools the moment a model is created, so Add > Voxel leaves you ready to build. Off, the new model is made and left selected in Object Mode, and Tab or the Enter Voxel Mode button starts editing |
| Use a Voxel Workspace | Boolean | False | Switch to a Voxel workspace when a model is created, creating it the first time. The workspace is a copy of whichever one you were on, set to Solid shading with vertex colour so the model looks painted. Off, models are made in the workspace you are already in |
| Start With Voxel Grid | Boolean | True | Turn Show Voxel Grid on in every scene whenever a file is opened or a new one started, so each voxel stays readable from the first stroke. Off, it starts off |
| Fold Idle Models | Boolean | True | Draw a model nobody is editing as one object instead of one object per chunk, and drop its grid from memory. Blender pays for every object on every frame, so this is what keeps a scene of many large models moving. A model unfolds when you start editing it |
| Fold After | Float | 1.5 | How long a model waits after you leave Edit Mode before it folds, so stepping out and straight back in costs nothing |
| Keep Decoded (MB) | Int | 512 | How much of the most recently folded models’ voxel data stays decoded in memory, so re-entering one is instant. 0 drops every folded model’s grid; it is read back from the file data when needed |
| Swatch Columns | Int | 16 | Swatches per row in the palette grid. Fewer makes each one wider, because a row is always the panel’s width. The built-in palettes are eight step ramps, so 16 or 8 keeps a ramp lined up with the rows |