Skip to content

Characters, rigs and animation

The Character section of the Voxel tab turns a voxel model into an animated character. There are three templates:

Template For Rig
Biped (Human) People, orcs, robots, anything on two legs 16 body parts, IK legs, T-pose
Quadruped Horses, wolves, cows, anything on four legs Body, neck, head, tail, four three-part legs, IK feet
Slime Blobs and jellies Fitted automatically; squash-and-stretch controls

Nothing is weighted by hand. Every body part moves as a solid piece of voxels, which is how voxel characters are meant to move.

  1. With nothing selected, open Character ▸ Choose a Character and pick one (or, in Voxel Library, search for warrior, horse, wolf… and click Create Character under its thumbnail). It opens with its body parts already assigned.
  2. In Character, click Use Prepared Body Parts (③ below), check the bends, then Looks Good — Create Rig.
  3. Click Walk. Press Space to play.

The Character panel for a library character

  1. The rig type at the top of the panel: Biped (Human), Quadruped or Slime.
  2. Prepare Rig starts the wizard for your own model.
  3. Use Prepared Body Parts skips it for a library character.

Library figures with a Create Character button include the Warrior and Warrior 64 (the same height at half-size voxels), and the horse, wolf, fox, deer, pig, cow, goat, boar, donkey, sheep and mammoth.

The wizard shows where you are at the top of each step: ✓ done, ● the step you are on, ○ still to come.

The start of the Character panel, with the Character Maker below it

With nothing selected, the Character panel offers Choose a Character ① and, below it, the Character Maker. Pick the Character ② (the knight, for now), a Body to start from and the sliders, an Animation to start with, and click Make Knight ③. It comes out rigged and playing. Replace Last Knight swaps the one you made before for the new one, so you can try builds without collecting knights.

Model the character in a T-pose: arms out sideways, legs apart, facing −Y, with Z up. Then select the model and open Character. The wizard shows it from the front, facing you, so the character’s own left is on your right, and the diagram draws it that way too.

  1. Set the rig type to Biped (Human), then click Prepare Rig.

  2. The panel asks for one part at a time, starting with Part 1 of 10 · Head, and a diagram in the viewport highlights where it is.

    The wizard asking for the head, with its diagram top left

    The body-part step of the wizard

    ① The part being asked for. ② Select. ③ Mirror Limb Selections. ④ Assign … & Continue. ⑤ Show Unassigned Voxels. Drag a box with Select; Shift adds, Alt + Shift subtracts. Through takes voxels hidden behind the surface too. How to select repeats this in the panel; it folds away after the first part.

  3. Click Assign Head & Continue, and so on for each part. Back re-selects the last assignment so you can fix it.

  4. Mirror Limb Selections assigns both sides of an arm or leg from one. If the two sides differ, it changes nothing and tells you how to assign them separately.

  5. The parts are: head, neck, chest, waist/hips, and left and right upper arm, forearm, hand, thigh, lower leg and foot. Every voxel needs a part. Show Unassigned Voxels draws the ones you missed in pink, through the model, and centres the view on them. Then either:

    • Give Them to the Nearest Part, which gives each one to the part it touches, or
    • pick a part under Add to another part, select the voxels and click Add Selected Voxels. The eyedropper picks the part by clicking one of its voxels.

    When every voxel has a part, Continue: Check Bends moves on. Colours shows the parts assigned so far in their own colours.

  6. The joints are then fitted automatically. Click Elbow Bend and Knee Lift ①. These use a temporary rig and change nothing.

    Checking the bends

  7. If a bend is in the wrong place, click Elbow Point or Knee Point under Wrong bend? Move its point ②. The view shows just that limb and an orange dot where it bends. Drag the dot, or click the model where the joint should be. Enter keeps it and shows the bend again; Esc puts it back.

  8. Looks Good — Create Rig ③.

Your progress through these steps is saved with the file.

Any facing works: the wizard turns the model for you.

  1. Set the rig type to Quadruped, then click Prepare Rig.

  2. Face it forward: use Left, Around or Right ② until the head points along the arrow, then Head Faces the Arrow — Continue ③.

    A wolf at the Face it forward step ①

  3. For each part a suggestion is already selected. Adjust it if needed and assign it. Optional parts such as the tail have Skip: No Tail.

  4. Check the bends with Leg Lift and Head Down; move a bend point with Knee Point or Neck Point.

  5. Looks Good — Create Rig.

Mirroring on animals only adds the reflection and never wipes the far side, so saddles and panniers that differ left to right survive.

Setting the rig type to Slime fits the rig automatically. Three controls pose it:

  • Top: stretch or lean.
  • Body: wobble and bulge.
  • Root: move the whole creature.

Model goes back to painting the slime. A repaint updates the rig straight away; a change of shape needs Rebuild Slime Rig, which keeps your previous rig and its animations.

Every sample is a normal, editable Blender Action keyed pose-to-pose with only a few keys per curve, so you can retime it and tweak the curves in the Dope Sheet and Graph Editor. Creating a sample never overwrites an animation you already have.

The Character panel once the rig is built

The Character panel puts what you use most at the top:

① Model and Animate switch between editing the character’s voxels and seeing it move. ② The Action the character is showing, with Edit Animation and Preview Output. ③ The most used clips, one click each. ④ More Animations lists the rest, by group. ⑤ Save Animation and My Animations, New Animation and Redo Rig Setup. ⑥ Output & Bake, folded away: how the voxels follow the animation, and the bake.

The warrior mid-walk, in Rigid Parts output

A horse mid-gallop

Rig Clips
Biped (35) Walk, Run, Sprint, Strafe Left, Strafe Right, Walk Backward, Sneak, Jump · Hit Front, Hit Back, Hit Left, Hit Right, Punch, Overhead Smash, Kick, Block, Death, Sword Combo, Cast Spell, Throw, Knockdown, Get Up · Idle, Crouch Idle, Roar, Victory, Wave, Stunned, Drink Potion, Pick Up · Mine, Chop, Build, Carry Idle, Carry Walk
Quadruped (14) Walk, Trot, Gallop, Jump, Idle, Graze, Sit, Lie Down, Howl, Bite, Rear Up, Buck, Hit, Death
Slime (10) Hop, Lunge Attack, Hit, Melt, Spawn, Idle, Look Around, Happy, Dizzy, Wobble

Loops end on their first pose, with a Cycles modifier so they repeat cleanly.

The work clips put a tool in the right hand as they are made: a pickaxe for Mine, an axe for Chop and a hammer for Build; see Held items. The swings are solved for each character, so the tool clears its head and body whatever its build.

Which clip suits which game state, and how to wire them into an engine, is in Fast prototyping for games.

At the top of Character:

Control Does
Action Which animation the character shows and exports
Edit Animation Opens the rig in Pose Mode to key it normally
Preview Output Shows the voxel result of the Action
New Animation Starts a new, empty Action

Clip Start / End, the frame range used for preview and export, is in Output & Bake. A sample sets its own.

Use Pose Mode, the Dope Sheet, the Graph Editor and the NLA exactly as you would on any Blender rig. Preview shows the selected Action only, not NLA blending; exports take the animations ticked in the Export panel (see Choosing what to export).

The rig’s control shapes: rings, foot outlines and knee diamonds

In Pose Mode the rig draws a control for everything you pose:

Control Moves
A ring round a body part Turns that part: head, chest, hips, arms, hands
A flat outline round a foot Places the foot; the leg follows it
A small diamond in front of a knee Points the knee
A big circle on the ground The whole character

Left-side controls are blue, right-side red and the middle yellow. The thigh and shin bones are hidden: the foot drives them, so grabbing one would do nothing. Move the foot outline instead.

To change a sample, move a control and key it (I). A pose you change on a frame without a key goes back to the animation when the frame changes, as on any Blender rig.

A character rigged with an older version shows Update Rig Controls at the top of the Character panel. It gives the rig the new controls and keeps its animations.

Save Animation, under the sample clips, keeps the current animation on this computer, to use on any biped or animal of the same kind in any project. The My Animations menu beside it lists what you saved:

Entry Does
An animation Puts it on the character as a new Action; the current one is kept
New Folder…, Move / Rename…, Rename Folder… Sort your animations into folders
Delete Removes a saved animation or an empty folder
Open Library Folder Opens the folder on disk, to copy animations to another computer

An animation is fitted to the character it is put on, so one saved on the warrior plays on a knight of any build. Keys, interpolation and sharp contact keys come across as they were.

Output & Bake open: the output settings ① and Bake Animation ②

Character ▸ Output & Bake is closed until you need it. It holds the output settings ① and Bake Animation ②.

Animation Output Looks like Good for
Rigid Parts (default for bipeds and animals) Each body part turns intact, like an action figure Game export (FBX/glTF), clean silhouettes
Strict Grid The whole character is re-voxelised onto one fixed world grid every frame, so it always looks like axis-aligned cubes Sprites, and renders where voxels must never tilt
Skin (slimes) Squash and stretch Slime export

Voxel Size (Strict Grid only) sets the cell size. Smaller is more detailed and slower.

Update Every N Frames holds each pose for N frames, giving the choppy stop-motion look of classic sprite games. It never changes your keys.

Bake Animation caches every frame of the clip, so playback and export don’t recompute. Save the file to keep the bake.

A rigged character has two states, and the switch at the top of the Character panel moves between them:

  • Model shows the voxel model and opens it for editing. Draw, erase and paint as usual. The rig and its animations are kept.
  • Animate shows the character moving and selects its rig.

Voxels you add while in Model join the body part they touch when you press Animate, so a new shoulder plate moves with the chest. A voxel that touches nothing joins the nearest part. A message says where they went, and one undo takes it back.

The switch is the same whatever you clicked: the rig, a moving body part or the voxel model.

In Model, the Body Parts section lists every part with its voxel count. Use it to move voxels to a different part without redoing the rig:

Body Parts in Model, with the left hand picked and part of it selected

  1. Click a part in the list ①, or use Pick Part and click a voxel of that part in the view.
  2. Select the voxels with Select Tool ②.
  3. Click Add … Voxels to the part ③.

Colour by Part shows each part in its own colour while you work. Select Part selects every voxel of the part you picked. Changes show as soon as you press Animate; the rig does not need rebuilding.

  • Redo Rig Setup reopens the wizard with the current assignments. Creating the rig again keeps the old rig and its Actions. Existing Actions are not retargeted to changed proportions.
  • Things the character holds are set in Held items, below.
  • Clicking any visible part of the character selects the rig, so the Action Editor always talks to the right object.
  • Deleting the rig removes the whole character’s generated parts. Your voxel model and your Actions are kept.

The model you rigged stays an editable voxel model. The visible character is generated from it.

The Held Items panel: a row per hand

Character ▸ Held Items has a row for each hand:

Control Does
Hold Item… Pick any Voxel Library shape for this hand: a sword, a pickaxe, a torch. It is sized to the character, gripped by its handle and painted in the character’s colours. Whatever the hand held before is replaced.
✕ Empties the hand. A library item is deleted; your own model is let go where it is.
Hold the Tool for Mine, Chop and Build The work clips put their tool in the right hand when you create them, and a clip that uses no tool puts it away again. A hand holding something you chose is left alone.
Attach Left / Attach Right Puts one of your own voxel models in a hand. In Object Mode, select it and the character, then click the side.

Held items swing with the hand in every clip, and only change in Object Mode. The Export panel decides whether they are exported with the character.

See Troubleshooting for the common cases: the “Rest pose changed near Thigh” message, voxels left unassigned, and parts that cross the centre line.