Skip to content
nimadez edited this page Jul 22, 2025 · 1 revision
  • Each color is a Group
  • Remember to set a unique color to define color groups
  • Of course, you can use colors only for painting
  • Fun fact: you cannot delete the last voxel!

Hover Toolbox

hover

  • Free Camera: disable drawing and makes navigation easier (shortcut: Space)
  • Do not stay in drawing mode, switch to free camera as soon as possible.
  • Use ALT/Space keys for speed drawing and painting on desktop

Grid Plane and Workplanes

workplane3d

Generator

  • Create box and plane
  • Create sphere with optional outer/inner size
  • Create isometric room
  • Create random terrain
  • New primitive placed at 0,0,0 position in world space
  • You can add box, plane, sphere and isometric to the current scene

Symmetry

symmetry

  • Select [ X Y Z ] axis before start drawing or painting
  • Open "Symm." menu to symmetrize or mirror voxels
  • Set pivot to "world center" or default "local center"
  • Axis-view contain a symmetry axis-plane
  • Scene contain a symmetry pivot

Modeling

  • Add: add new voxel symmetry / workplane
  • Remove: delete a voxel symmetry
  • Box Add: add voxels by drawing a box shape symmetry / workplane
  • Set "height" to larger than "1" to draw walls
  • Connect two parallel voxels at far distance
  • Ignore existing voxels
  • Box Remove: remove voxels by drawing a box shape symmetry / workplane
  • Rect Add: add a cluster of voxels by rectangle area workplane
  • It works like a laser that only hits the first target
  • Works best with orthographic view
  • Press 'F' key to frame camera to improve accuracy
  • Use workplanes to expand the selection area
  • Respect visibility
  • Rect Remove: remove a cluster of voxels by rectangle area workplane
  • Respect visibility

Rect Add Tool:

Painting

  • Paint: paint color symmetry
  • Box Paint: paint color by drawing a box symmetry / workplane
  • Bucket: replace all similar colors
  • Paint All: re-paint all voxels
  • Rect Paint: paint by rectangle area (works best with orthographic view)
  • Eyedropper: pick a voxel color, not a pixel color
  • Pixel Eyedropper: pick a pixel color (limited browser support)

Voxels

  • Transform Box Shape: transform voxels by box-shape workplane
  • Transform Color Group: transform voxels by color group
  • Transform Rectangle: transform by marquee selection workplane
  • Transform Visible: transform visible voxels
  • Clone: clone the transform
  • The transform is applied on tool change or 'Enter' key
  • The transform is applied on UI changes
  • The transform is undoable at any point
  • Use workplanes to expand the selection area
  • Rectangle is useful for selecting voxel islands
  • Visibility is supported by all transform tools except box shapes
  • Symmetry is supported for voxel selection, but not transformation
  • Normalize Voxel Positions: transform model to center and drop the base to the floor
  • Reduce Voxels: 1 voxel deleted in a 3x3x3 cube

Voxel transformation example:
voxeltransform

You can divide the scene into 4 parts to store objects,
Enable workplane and orthographic view, use Rect transform to arrange the objects.
Later, you can use "clone" to insert a copy of the object into the main part of the scene:
voxeltransform

Use "Clone" to replicate voxels:
voxeltransform

Color Groups

  • Isolate Color: isolate color group by picking a color
  • Hide Color: hide color group by picking a color
  • Invert Visibility: invert voxels visibility
  • Unhide All: unhide all hidden voxels
  • Delete By Color: delete voxels by selecting color groups
  • Delete Hidden: delete all hidden voxels

Color Palette

  • Color palette generated on-the-fly as you draw, paint or delete voxels
  • Color palette contain unique colors
  • Right-click on colors to show/hide color groups (double-tap in touch devices)

Axis View

axisview

  • Tap on each axis to switch camera viewpoint
  • Tap the cube to frame camera

Visibility

  • Use visibility options to access underlying voxels
  • Visibility is persistent, not break by drawing and painting
  • Combine colors and visibility options to create complex shapes
  • Hidden voxels store and restore on save/load or undo/redo
  • Boolean operations are possible using colors and visibility options
Clone this wiki locally