Skip to content
weSkelDOCUMENTATION
Documentation/Rigging/Cheek

Procedural modules

Cheek

Local cheek control, mirroring and optional scale response.

FacialL / R

Cheek builds one cheek or a mirrored pair, with a local control and one joint per side. The module connects to a Head output and offers an optional scale response.

In Module Manager, choose Cheek in Module Bank, or its instance in Scene Modules. The capture shows an L source with Mirror enabled and Scale Response disabled.

1Side 2Colors 3Scale Response 4Design
Cheek · CONFIGURATION · Poseidon theme.
Callout Purpose
1 · Side Choose L or R. Mirror also builds the opposite side. Two one-sided instances allow different options on the left and right.
2 · Colors Main Color sets the control color for each side; Output Color sets the joint color.
3 · Scale Response Adds automatic scale to the output based on the control’s local translation. Disabled by default.
4 · Design The Main row sets the control’s SHAPE and COLOR.

On an existing instance, changing sides or Scale Response requires Rebuild. Shapes and colors update immediately.

Placer Purpose
Root · L / R One placer per built side. Translation, rotation and scale define the cheek’s rest position and the control axes.

The two placers start mirrored, then remain independently editable. Place them on the character’s cheeks. Attachment to Head uses the public base inputs; it is not created automatically.

Module Preview
Cheek · Module Preview · Poseidon theme.
Control / attribute Purpose
Main Animatable translation and rotation. The control’s scale channels are locked.
scaleFactor Present with Scale Response. Animatable factor, 0.67 by default; 0 makes the automatic response neutral.
dvScaleFactor Present with Scale Response, visible in the Channel Box, 0.67 by default. This attribute is retained for compatibility and has no effect on deformation.

With Scale Response, local translation along the module’s up axis (+Z by default) uniformly reduces or increases the output scale. Manual translation and rotation remain active. The control shape does not receive this automatic scale.

Scale response

The applied factor is clamp(1 - scaleFactor × t, 0.05, 20), where t is the signed local translation along up. With the default positive factor, moving in the +up direction reduces scale; moving back increases it. The bounds prevent zero or negative automatic scale.

Disabling Scale Response removes its attributes and calculation. Removal is refused if these attributes are animated or externally connected. A removed static setting is not remembered for a later reactivation.

Each built side (L or R) has the following ports, with matrix channels driver and reference.

Direction Port Purpose
Input base Movement received from the skull, combined with the cheek’s placement.
Output main Local control result, including scale response when enabled. The cheek joint follows this output.

In Module Graph, connect a Head output to the base inputs of the built sides, with the driver + reference pairs. For example:

Output Input
Head · C · lower_skull_01 Cheek · L · base
Head · C · lower_skull_01 Cheek · R · base

Without a Lower Skull chain, use Head.main. Each cheek retains its local control after connection. A Head output that is still connected cannot be removed by a Rebuild.