Opposable Arm

Rigs an arm with IK and a pole, on top of a forward chain you can still pose by hand, ending in a hand that stays free.

Video placeholder: Adding an Opposable Arm: selecting the upper arm, lower arm and hand on the Oriented armature, adding the module with mirroring on, moving the IK target and pole, then using Vector Influence and snapping between IK and FK

Overview

Use this for arms and other limbs that end in a bone that doesn’t plant on the ground. For legs with a foot roll, use Plantigrade Leg.

Each chain bone gets a forward bone plus inverse, offset and stretch mechanism bones. The controls are the IK target at the hand, a pole target at the elbow, and a vector bone at the shoulder that aims at the target and carries the pole. Vector Influence decides whether the pole follows it or stays free.

The forward bone at the ending can have other modules attached. An optional bone in the Root row can carry the target and pole, and Floor Target adds a floor bone at the armature’s ground level that stops the target going through it.

UI Location

Modules are listed in Properties > Armature > Rigging Modules, which shows when an armature from the character’s hierarchy is active and selected. Their settings only show in Pose mode, in the Settings, Naming, Colors and Shapes subpanels under the list.

You add one from Pose > Add Rigging, or Shift + A in Pose mode. The + beside the list adds an empty entry instead, and you pick its type from the Rigging dropdown.

Once built, its controls are in the Controls subpanel. With the Rigging armature active in Pose mode, they’re also at 3D Viewport > Sidebar > Animation > Controls for whichever module owns the active bone.

Adding the Module

  1. Make the Oriented armature active and enter Pose mode. Set Oriented Armature creates it if the character doesn’t have one.
  2. Select at least the upper arm, lower arm and hand.
  3. Open Pose > Add Rigging and choose Opposable Arm.
  4. Check Offset and Position in the Rigging Modules panel, so the pole sits where you want it.

Three bones is the hard minimum and there’s no maximum. The last selected bone is always the Ending, and the rest are the chain.

Filled in for you, none of it required: Origin from the first bone’s parent, Mirror Rigging, Position, and Axis when the chain is straight. The Root row starts empty.

Selection order doesn’t matter, bones are read in the armature’s own order.

See Add Rigging Module for the operator itself. The first module creates <name>_Rigging above the Oriented armature, and that armature is active afterwards, with the Oriented one still in Pose mode. Modules only read bones selected on the Oriented armature, so keep selecting there.

Module Settings

Every change here rebuilds the module straight away.

The Naming, Colors and Shapes values, along with Axis, Offset and Floor Target, are remembered for the next module of this type, in any file. Bones and mirroring aren’t.

Settings

  • Origin (suffices) — Bone name; the first bone’s parent. Optional. Where the chain attaches.
  • Root (suffices) — Bone name; empty. Optional. A bone that carries the IK target and pole, and floor if there is one, adding Root Influence to the controls. It’s copied as a bone of its own if nothing has rigged it.
  • First, Second and so on (suffices) — Bone name; one row per chain bone. Required.
  • Ending (suffices) — Bone name; the last selected bone. Required. The hand.
  • Axis (axis) — Choice of Auto, +X, -X, +Z or -Z; default Auto. Picks a side of the first chain bone for the direction that controls sit in. A chosen axis always beats the bend of the chain. On Auto a bent chain uses its bend, and a straight chain gets an axis filled in when the module is added.
  • Offset (offset) — Float; default 0.3. How far the pole sits from the chain. Negative puts it on the other side. It starts multiplied by the inverse of the scene’s Unit Scale.
  • Position (position) — Float; range 0 to 1. How far along the chain the pole sits. It’s set when adding, to the middle joint closest to halfway, and isn’t carried over from the last module.
  • Floor Target (floor) — Checkbox; default off. Adds a floor bone at the ground below the ending, adding Floor Influence to the controls.
  • Edit Shared (shared) — Checkbox. On for the first module to claim a shared bone, off when another module already has it. On lets this module restyle that bone and off leaves it as it is.
  • Mirror Rigging (mirror) — Checkbox; on when adding if every selected bone has an opposite side, found through names like arm_l and arm_r or LeftArm and RightArm. Builds the other side as its own list entry. An origin with no side in its name is shared by both. Settings stay matched and either side can be edited. With no opposite side it adds nothing. Turning it off removes the other side’s bones.

Naming

Prefixes added to bone names.

  • Target — default ikt_. Prefix for the IK target. Required.
  • Pole — default pvt_. Prefix for the pole target. Required.
  • Vector — default ikv_. Prefix for the vector bone that aims at the IK target. Required.
  • Forward — default empty. Prefix for the chain bones. Leave it empty, see Limitations.
  • Inverse — default ikc_. Prefix for the inverse mechanism bones. Required.
  • Offset — default iko_. Prefix for the offset mechanism bones. Required.
  • Stretch — default skc_. Prefix for the stretch mechanism bones. Required.
  • Floor — default fvt_. Prefix for the floor bone. Required. Only used once Floor Target is on.
  • Root — default empty. Prefix for the bone picked in the Root row. Only used once the Root row has a bone.

Colors

  • Origin — default 13 - Theme Color Set. Inactive, see Limitations.
  • Target — default 01 - Theme Color Set. Colors the IK target. Also colors every other control in this module.
  • Pole — default 01 - Theme Color Set. Inactive, see Limitations.
  • Vector — default 01 - Theme Color Set. Inactive, see Limitations.
  • Forward — default 13 - Theme Color Set. Colors the chain bones. Also colors the origin and ending.
  • Inverse — default 10 - Theme Color Set. Colors the inverse mechanism bones.
  • Offset — default 10 - Theme Color Set. Colors the offset mechanism bones.
  • Stretch — default 10 - Theme Color Set. Colors the stretch mechanism bones.
  • Floor — default 01 - Theme Color Set. Inactive, see Limitations.
  • Root — default 01 - Theme Color Set. Colors the bone picked in the Root row. Only used once the Root row has a bone.

Shapes

Each row has a dropdown on its right that switches the row between Shape, Translation, Rotation and Scale. Translation is multiplied by the bone’s length. Rotation starts at zero on every row.

  • Origin — default Ring Half, scale 2, translation 0, 0.75, 0. Used by the origin bone.
  • Target — default Ring Half, scale 2. Used by the IK target.
  • Pole — default Ball Half. Used by the pole target.
  • Vector — default Arrow Half. Used by the vector bone that aims at the IK target.
  • Forward — default Ring Half, translation 0, 0.3, 0. Used by the chain bones.
  • Inverse — default Ball Half, scale 0.5. Used by the inverse mechanism bones.
  • Offset — default Ball Half, scale 0.3. Used by the offset mechanism bones.
  • Stretch — default Dash Half. Used by the stretch mechanism bones.
  • Ending — default Ring Half, scale 1.5. Used by the ending bone.
  • Floor — default Circle Half, scale 2. Used by the floor bone. Only used once Floor Target is on.
  • Root — default Circle Full. Used by the bone picked in the Root row. Only used once the Root row has a bone.

Controls

  • Vector Influence — On by default. How much the pole follows the vector bone, so turning it down leaves the pole free.
  • Root Influence — Only with a bone in the Root row. How much the target and pole follow it.
  • Floor Influence — Only with Floor Target on. How strongly the floor holds the target.

Each chain bone has its own dropdown, First Bone, Second Bone and so on:

  • Rotation Influence — How much of the IK result reaches this bone, so lowering it lets you pose the bone by hand.
  • Location Influence — Off by default. Lets the bone move as well as rotate.
  • IK Stretch — This bone’s own stretch, spread gently up the chain by default.
  • X, Y and Z rows — Each has this bone’s IK lock, stiffness, limit toggle, minimum and maximum.

End Bone has Rotation Influence and Location Influence for the ending.

Press Snap IK to FK or Snap FK to IK to swap between the two without a pop. See Snap IK to FK.

Limitations

  • Some Colors rows change nothing. Origin takes its color from Forward, and Pole, Vector and Floor take theirs from Target. Use those rows instead.
  • A failed setup only reports to the system console. With fewer than three bones selected, the module doesn’t build. The Rigging armature is still created, and the entry stays in the list with its Rigging dropdown on Select a module.... To fix it, select the right bones and pick the type from that dropdown, or press - to drop the entry.
  • Offset compounds when Unit Scale isn’t 1. Each new module of this type multiplies the remembered value by the scene’s scale again. At 0.01 three of this module in a row gave 30, 3,000 and 300,000. This matters most in Unreal scale scenes, so check Offset on each new module and set it by hand.
  • A Forward prefix breaks this module, so leave it empty. Any prefix makes the rebuild fail partway with a KeyError, leaves the armature in Edit mode and stops later setting changes from rebuilding the module. Clearing it again doesn’t recover the module. In testing, going back to Pose mode, clearing it and running Rebuild Rigging took this module from 15 bones to 17, with stale zz_ bones left behind and the origin only under its prefixed name. Undo straight away if it happens, though that recovery couldn’t be tested.
  • Axis is only filled in for the first module. After that the last value is remembered for this type, even on a different chain, and a chosen axis always beats the chain’s bend. In testing a saved -Z carried straight over, so check Axis on each new chain.
  • An invalid value removes the module’s bones. A required row left blank, a repeated name, or a bone name that doesn’t exist removes every bone in the module until you fix it, and then it rebuilds by itself. In testing a wrong bone name on this module went from 15 bones to 0, and fixing it brought all 15 back. A blank or repeated row turns red, but a bone name that doesn’t exist doesn’t, so disappearing controls may be the only sign.
  • Nothing checks that bones are connected. A selection of unconnected bones built without complaint in testing, as Opposable (head - tail_02), so check your selection.
  • Adding the same bones twice isn’t stopped. It builds a second list entry with the same name as the first, with no warning, so check your selection.
  • Turning Mirror Rigging off leaves a dead entry. The other side’s bones go, 29 bones down to 15 in testing, but its entry stays in the list with settings and no bones. Select it and press -.
  • Don’t change the Rigging dropdown on a built module. It relabels the module and swaps the settings shown without rebuilding. In testing all 15 bones stayed as they were while the panel showed another module’s settings. To change type, choose Select a module..., which removes the module, and removes the Rigging armature if it was the last one, then add the new one.