Repository navigation
Export Nodes SourceIOSfmIkRigNode
REDxEYE edited this page Nov 20, 2026
·
1 revision
Generates a Source Filmmaker (SFM) rig script for the exported model. The script appears in the Animation Set Editor's Rig menu and builds handles, IK limbs, FK chains and constraints for the model's own skeleton, instead of relying on hard-coded ValveBiped bone names. This node is the hub: IK chains, FK chains, fingers and constraints are separate nodes that plug into it.

Category: SFM rig. Node ID: SourceIOSfmIkRigNode.
All three inputs are multi-input sockets: any number of nodes can be linked to each.
| Socket | Accepts | Meaning |
|---|---|---|
| IK chains | SFM IK chain | Two-bone IK limbs (arms, legs, generic chains). |
| FK chains | SFM FK chain | One handle per bone along a bone path (tails, extra spines, ears). |
| Constraints | SFM constraint and SFM finger | Point/orient/parent/aim constraints, rotation sliders, and finger rigs (finger nodes use the Constraint socket). |
| Socket | Type | Meaning |
|---|---|---|
| SFM rig | SFM rig socket | Link to SFM rig on the Source 1 model output (single link). |
| Property | Meaning |
|---|---|
| Armature | Armature used to pick and detect bones. The export validates against the rig of the model's $model/$body entries. |
| Detect bones (button) | Fills Pelvis, Chest and Head from the armature and adds an IK chain node for every arm and leg it finds that is not already covered. Hands, feet, pelvis and head are found by name; the rest by hierarchy. Hand-picked bones that detection cannot find are kept. Reports what was not found. |
| Pole targets (button) | Creates an Empty (parented to the middle bone) for every IK limb without a pole target, placed where the script would put the pole control; assigns it to the chain. Move the empties to choose the bend direction. |
| Heel attachments (button) | For every leg with a toe bone, adds a pvt_heel_<name> (or the chain's Heel attachment) Attachment node, with an empty on the foot bone, to the connected model output. Requires the rig to be connected to a model output. |
| Script name | Name in SFM's Rig menu and file name of the script. Blank uses rig_ik_<model file name>. Only letters, digits and _. |
| Pelvis | Root of the body. rig_pelvis moves everything above; rig_hips only the pelvis. Required.
|
| Chest | Last spine bone. Every bone between the pelvis and the chest gets a spine control (the chest itself is rig_chest). Must be a descendant of the pelvis. |
| Head | Bones between the chest (or pelvis, if no chest) and the head get neck controls (rig_neck, rig_head). |
| Foot roll | Adds the foot roll slider for legs with a toe bone, when the model has the matching pvt_heel_* attachment (for example pvt_heel_R / pvt_heel_L). |
| Hide groups | Comma-separated SFM control groups hidden while the rig is attached. Default Body, Arms, Legs, Root. Add Unknown and Other to match Valve's rig when every extra bone is covered elsewhere. |
| Hide driven bones | Moves the bones the rig drives into a hidden control group so they cannot be selected instead of a rig handle; other bones stay visible in Unknown. |
| Also hide bones | Comma-separated extra bones to hide with the rig, for example helper bones that overlap a handle. |
- The script is written to
<game root>/scripts/sfm/animset/<script name>.pywhen you export or compile the model. It is a Python 2 SFM script that uses SFM's injectedsfm/sfmUtils; bone names in it are the exported (renamed) names. - It is not part of the QC and is not compiled into the model.
-
Preview Source 1 export shows it in a Text called
SourceIO SFM rig preview - <output node> - scripts/sfm/animset/<name>.py. - With Direct export the script is still written as an asset.
- Handles:
rig_root,rig_hips,rig_pelvis, spine/neck controls, plus handles named by the chain, finger and constraint nodes.
- Add an SFM IK rig node and link it to the model output's SFM rig socket.
- Pick the Armature and press Detect bones. Four IK chain nodes (right/left arm and leg) are added and linked.
- Press Pole targets and move the empties so knees and elbows bend the right way.
- If the legs have toe bones, press Heel attachments to add
pvt_heel_R/pvt_heel_Lattachments (move their empties to the heel). - Add SFM finger, SFM FK chain and SFM constraint nodes for extra parts and link them to Constraints / FK chains.
- Preview, then export; load the model in SFM and choose the script from the Rig menu.
- The rig is validated against the armature of the model entries: the model entries must use exactly one armature, and the pelvis, chest, head and every chain bone must exist in it.
- Each bone can be driven by only one control; handle names must be unique; rotation slider names must be unique; FK chains and fingers need their own names.
- A bone that hangs below an IK-solved joint cannot get its own FK handle ("leave such bones as plain bone controls").
- Pole targets must not sit on the middle joint.
- Chain, finger and constraint names may contain only letters, digits and underscores.
- Older graphs: saved rig nodes are migrated (the Fingers input moves to Constraints; on Blender 5 old arm/leg fields become chain nodes named R and L). Blender 4.5 graphs with the old fields are not migrated.
Back to Export Nodes.