Skeleton Socket
Add one named attachment transform to a rigged character. Chain Skeleton Socket nodes for an axe grip, a left-hand grip, a back slot or any other attachment.
character Rigged character.
preview Optional Optional display-only tool, origin at grip.
Unchanged character with one additional socket joint.
Fit a grip
Section titled “Fit a grip”Choose Bone, then Name. The name follows the bone until you type a name yourself. Offset moves the joint in the bone’s frame, shown in cm; Rotation turns it from its default frame, in XYZ degrees. Hands start at the palm centre with a fist grip. Other bones start at their joint.
Select the node and choose Preview: None, Pipe (1 m), Sword, Axe, Pickaxe or Shovel. Wire an Import or any mesh into Preview mesh to use your own tool instead. The tool’s origin is its grip. Previews are display data and never enter an exported mesh or an Engine Output push.
Click the axis tripod in the viewport, then W to move or E to rotate. The prop follows the drag; releasing writes both parameters as one graph undo step.
Grip frame
Section titled “Grip frame”The socket origin is where the hand grips. Green +Y runs up the handle toward the head or blade. Blue +Z points toward the business side: axe edge, pick point or shovel face. Red +X completes the frame. A game tool authored to this frame attaches with identity position and rotation.
+Y: head / blade | | grip (0)--+---- +Z: business side / +XCheck a clip
Section titled “Check a clip”On a downstream rigged display, choose the socket in Hold beside Motion. Only one prop shows at a time; None hides it. A socket with Preview None still has its tripod. Hold belongs to the displayed node’s viewport state and resets when that socket disappears.
Pause or scrub to the frame you care about and click the held socket’s tripod. W/E edits the socket in that pose. Releasing converts the transform back to bone-local Offset / Rotation on the source Skeleton Socket node, including inside unlocked subnets. A locked library pin shows Unlock to edit and stays read-only. Playing disables editing.
Export and migration
Section titled “Export and migration”Sockets export as unweighted joint nodes under their chosen bones, with no animation tracks. The game looks them up by Name and owns attachment. A duplicate joint name, a missing bone or an input without a rig is a cook error.
Saved Auto Rig nodes gain an explicit RightHandSocket node automatically. Their offsets and rotations are rebased to preserve the old absolute bind pose, including in project files, clipboard graphs and library definitions.
| Parameter | What it does | Default |
|---|---|---|
Name | Joint name; empty follows Bone. | Blank |
Bone | Parent body or finger joint. Picked from the input mesh. | RightHand |
Offset | Offset in the bone frame, in cm. | 0, 0, 0 cm |
Rotation | XYZ rotation from the grip base. | 0, 0, 0 |
Preview | Display-only stand-in tool. Options: None, Pipe, Sword, Axe, Pickaxe, Shovel | None |