Skip to content
weSkelDOCUMENTATION
Documentation/Rigging/Neck

Procedural modules

Neck

Neck with independent controller and joint counts.

BipedBodyC

Neck builds the neck between the torso and the skull base, with main controls, a mid corrector and a deformation joint chain.

In Module Manager, choose Neck in Module Bank, or its instance in Scene Modules.

1Side 2Controller Scale 3Output Color 4Topology 5Design
Neck · CONFIGURATION · Poseidon theme. 3 main controls, 3 joints.
Reference Purpose
1 · Side Central module: C only, without mirroring.
2 · Controller Scale Overall controller shape size, without changing placement or deformation.
3 · Output Color Deformation joint color.
4 · Topology Controllers sets the main control count; Joints sets the joint and output count. Two independent odd counts, with a minimum of 3; default 3 / 3.
5 · Design SHAPE and COLOR set the appearance of Main, Mid Correction and Options.

On an existing instance, count changes require Rebuild. Controller size, shapes and colors apply immediately.

Placer Role
Base Rest position, orientation and scale of the neck. Translation, rotation and scale are editable.
Tip Rest length of the neck. Only translation along the module’s length axis is editable.

Two placers are enough, regardless of the controller or joint count. Intermediate points are distributed between them.

Controller Role
Main Main controls distributed from Base to Tip, with Mid at the center. Keyable translation, rotation and scale.
Mid Correction Local correction, strongest at the center and zero at both ends. Hidden by default; keyable translation, rotation and scale.
Options Mid Visibility shows the mid corrector; hiding it does not disable its effect.

Base rotation is distributed progressively: 0% at the base, 50% at the middle and 100% at the top. Its translation and scale affect the entire neck.

The other main controls affect the neck from their position upwards. Joints follow the result independently of the controller count.

Module Preview
Neck · Module Preview · Poseidon theme.

Ports are central (C) and expose the driver and reference matrix channels. The total deformation output count follows Joints.

Direction Port Role
Input base Incoming motion at the neck base.
Input tip Optional upper target. With no incoming source, follows the driver and reference channels of base, with the Tip placer’s own offset.
Output base Deformation at the base.
Outputs lower_01… Additional points between the base and middle, from 5 joints onwards.
Output mid Deformation at the neck middle.
Outputs upper_01… Additional points between the middle and top, from 5 joints onwards.
Output tip Deformation at the top.

Connecting at least one tip channel activates its complete driver / reference pair. Disconnecting its last source makes the upper target follow base again, without Rebuild.

This behavior requires weSkel to be loaded before opening the scene, or the instance to be scanned in Module Manager. An older Neck module adopts this behavior through an explicit Rebuild.