Notch Notch Manual 0.9.23
 Light | Dark
XSens Mocap Skeleton

XSens Mocap Skeleton

Control skeletal rigs from an Xsens mocap system.

Method #

This node reads bone data from a XSens motion capture suit and applies it to Bone nodes, either via direct input links or by a connection to the root of the target hierarchy.

A network connection must be made to the XSens software which provides a stream of bone data from the suit. The server address and port must be entered to match the output address and port in XSens. If there is no connection the node will be hatched out in red.

The input skeleton the node is applied to must have been designed to receive motion capture data: the bones must be named, oriented and arranged appropriately. Mixamo rigs are a good reference.

Please be advised you can only import one live stream into a notch project at a time.
Imported characters tend work best with Convert FBX disabled on import, and Rotate Bind Joints enabled. Although, because rigged characters can come from various sources with different standards, you may need to try a few different combinations to see which works right for your character.


These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.

Position XMove along the local x-axis.
Position YMove along the local y-axis.
Position ZMove along the local z-axis.
Rotation HeadingRotate around the local y-axis.
Rotation PitchRotate around the local x-axis.
Rotation BankRotate around the local z-axis.
Scale XScale along the local x-axis.
Scale YScale along the local y-axis.
Scale ZScale along the local z-axis.

Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.

Position XToggle inheritance of the X Position from the parent.
Position YToggle inheritance of the Y Position from the parent.
Position ZToggle inheritance of the Z Position from the parent.
Rotation HeadingToggle inheritance of the Rotation Heading from the parent.
Rotation PitchToggle inheritance of the Rotation Pitch from the parent.
Rotation BankToggle inheritance of the Rotation Bank from the parent.
Scale XToggle inheritance of the X Scale from the parent.
Scale YToggle inheritance of the Y Scale from the parent.
Scale ZToggle inheritance of the Z Scale from the parent.
World Position OnlyInherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit TimeToggle inheritance of time from the parent.

These properties control the core behaviours of the node.

XSens Server AddressThe address / IP of the XSens server providing the skeleton stream.
XSens Server PortThe port of the XSens server providing the skeleton stream.
Avatar IndexSelect the mocap actor to drive the skeleton.
Rotate Bind Pose Joints By Facing DirectionDetermines whether the input skeleton has been rigged so that the bones in their bind pose are rotated to point in the direction of the next bone, or whether they are unrotated in their bind pose.
Input Skeleton ScaleUniformly scale the size of the input mocap skeleton.
MirroredMirror the movements of the incoming mobcap data along the x axis.


NameDescriptionTypical Input
Mocap StreamInput a pre-recorded mocap stream to run instead of any live data.Mocap Stream
Hierarchy RootThe root of the input skeleton to be driven by motion capture.You’ll need to connect the skeleton root within an Imported 3D Scene.
Transform ModifiersApply the transforms of another node to this node.Null
Target NodeModifiy the rotations of the node to always direct the z axis towards the input.Null
Local Transform OverrideApply the transforms of another node to this node, relative to its parent.Null