Moveset guideКак работать с Moveset

Moveset is a Blender extension for Blender 4.2 and newer (tested on 5.2). It needs nothing else installed

1. Download moveset-1.0.0.zip. Do not unpack it
2. In Blender open Edit › Preferences › Get Extensions, click the arrow at the top right and choose Install from Disk…
3. Pick the zip. The add-on switches on by itself
4. In the 3D View press N to open the sidebar and select the Moveset tab

The interface follows Blender's language: Russian if Blender is in Russian, English otherwise. You can force one in the add-on preferences

These skeletons are recognised on their own, the panel shows Rig: … and whether it has fingers:

• Rigify metarig and the generated Rigify rig (the add-on drives the FK controls)
• Mixamo, with or without the mixamorig: prefix, 2- or 3-bone fingers
• VRoid / VRM imported through glTF
• Unreal Engine 5 and 4 mannequin skeletons
• Any rig with humanoid names: Hips, Spine, LeftUpperLeg…

A skeleton the add-on does not know

Press Map bones manually. The add-on guesses each slot from bone names (left/right, .L/_l, thigh/upleg/femur, forearm/lowerarm…) and from the skeleton's structure, and skips twist bones, IK targets, hair and clothes

Check the list: body (hips, spine 1 and 2, chest, neck, head), then thigh, shin, foot, toe, upper arm, forearm and hand for each side, and the fingers. A check mark means the bone is found; pick any missing one from the field's search

Test pose shows a step with one arm forward and a fist - a swapped side is obvious at once. Then press Use this map. Save map to library makes rigs with the same bone names recognised by themselves next time

Required: hips, chest, head, and thigh, shin, foot, upper arm, forearm and hand on both sides. Neck, toes and fingers are optional

Proportions

When you create a character, arm and leg lengths are measured from the rig, so a hand lands on this model's forehead, chest or hip. If you change the model later, press From rig next to Proportions

Each slider group has a ↺ button that resets the group

A state is how the person is right now: brisk, weary, cold, drunk, elderly and so on, 14 in the library. It sets the walk and the idle and colours every action. The build (height, shoulders, proportions) is shared by all states of the character

• Add a state from the library with + next to the state list
• Mix two states, for example 60% Brisk and 40% Weary
• Mirror a state for a left-handed character: the manner and the carried item switch sides
• An action played in another state is baked as <action>_<state>, for example wave_cold
• Add to this state's set marks an action as a habit of the state; Bake all then bakes it in that state

Loop or one-off

With the loop switch off, a gesture starts and ends in the idle pose. With it on, the pose holds for the whole clip and the clip closes without a seam - what a game needs for a repeating animation

Speed

Speed × under Play makes any clip faster or slower. For walks it changes stride and cadence together, the way a person speeds up

While walking

Do it while walking keeps the legs walking and puts the action on the upper body: talking on the phone, drinking, waving on the move. The clip gets a whole number of steps, so it loops

Props

• Props of this animation creates simple stand-in objects for a guitar, sword, shovel or phone and parents them to the hand bone. Replace them with your own models
• To give the character your own object, select it, then the rig, and press Object to right hand or left
• Some props appear and disappear during the clip: the sword leaves its scabbard, a grenade leaves the hand. The Action gets markers sword_show, grenade_hide and so on

The For games section is built for an animation state machine:

• Loops in place: run, sprint, walking back, side steps, crouching, crawling, and an 8-way grid for blend spaces. Each has its root speed written into the export file
• Transitions: start and stop from a walk or a run, a 180° pivot, crouch down and up. They begin and end on the exact frames of the loops they connect
• Jumps: takeoff, rise and fall loops, soft and hard landing, running jump
• Obstacles: stairs up and down, a ladder (get on, climb, get off at the top), vault, climbing onto a ledge, dropping from one, dodge roll. Heights are sliders; the root moves up and down as well as forward
• Hits and falls: four directions, light and heavy, knockdown, get up, three deaths
• Interaction and NPC ambience: doors, levers, chests, terminals, leaning, dozing, talking

19 kits - swordsman, archer, rifleman, zombie, stealth, carrier and others - each with the full set around one weapon or role: idle, 8-way walk, run, crouch, turns, start and stop, jump, hits, knockdown and deaths, all with the item in hand, plus the kit's own moves. Add a whole kit from Library › Character kits

The Ready slider moves the weapon between on guard (1) and lowered (0). For the rifle and pistol it is Barrel

Live preview shows the pose on the rig, but an engine or a render needs keyframes. Everything below is in Bake and export

• Bake this one - the selected animation in the selected state. Bake all - every walk, idle and action of the character, in each state's set; tick Actions and Links to choose what goes in
• Bake all selected - the same for several characters at once
• Frames follow the scene frame rate (24, 30, 60)
• Root motion puts the path into the root bone, and adds a root bone if the rig has none. Off: the character moves in place
• Walk forward (for videos) moves the character in the scene without root motion. Make the timeline longer than the clip
• With mirrored copies and Mirrored copy add …_mirror clips; Aim poses (9) makes an aim offset
• After a slider change, the baked Action is marked outdated; Rebake redoes only those, aim poses included
• The list under Bake all shows every baked Action: click one to play it on the rig, the bin deletes it from the file. Actions whose animation you removed from the character are marked with a cross; Remove clears them all
• Rigs copied with Shift+D become separate characters when baked. If a clip name is already used by another character, the new clip gets the rig name in front, for example Hero.002.walk_normal

Press Unity, Unreal or Godot and pick a file name. The rig, its meshes and all its baked Actions go out with the settings each engine expects. With several characters selected, each gets its own file with only its own clips

Next to the model you get <file>.moveset.json:

1. Put a few rigs in the scene, for example copies of one character made with Shift+D, and select them all
2. In Bake and export press Crowd from selected…
3. Tick the states to hand out, set the share of walkers, the slider spread, the share of left-handed characters and the time offset
4. Press OK. Each character gets its own state and clip, placed on an NLA track named Moveset crowd with its own start frame

The same Seed rebuilds the same crowd; change it to reshuffle. Every character stays editable as usual