Repository navigation
Export Nodes SourceIOFlexControllerNode
REDxEYE edited this page Nov 20, 2026
·
1 revision
Category: Flex rules · Node ID: SourceIOFlexControllerNode

Defines one flex controller (a facial slider, like the sliders in SFM or Hammer's face poser) and exposes it two ways: its Value feeds expressions and rules, and its Controller output registers it in the Flex rules collector so it is written to the exported model.
If exactly one rule uses this controller as its whole expression (a rule's Value linked straight to this node's Value), the controller becomes the direct controller of that rule's shape key and carries its wrinkle scale. With zero or several direct rules it behaves like a Virtual controller: the slider only feeds expressions.
None.
| Socket | Type | Description |
|---|---|---|
| Value | Flex expression | The controller's name as an expression value. Link to a rule's Value, or into Flex arithmetic, Flex clamp, Flex remap, Flex invert, Flex crossfade or a Corrective rule's Drivers. |
| Controller | Flex controller | Link to the collector's Controllers input. Required if Value is linked anywhere – otherwise export fails ("connect Controller to the Flex Rules collector"). |
| Control | Meaning |
|---|---|
| Controller name | Name of the controller as used in expressions and in the exported model. Spaces and symbols become _, a leading digit gets a _ prefix; if the exported name differs a line "Exports as …" shows it. Required; must be unique across the rule set. |
| Stereo | Marks a left/right slider. When the controller is used by a rule, it is exported as the pair right_<name> + left_<name>, which studiomdl merges into one stereo slider; plain rules using it are split into generated shape.L/shape.R halves (see the collector page). |
| Eyelid | Writes the controller's eyelid flag (eyelid) into the exported combination controller. SourceIO only sets the flag; how the engine or tools use it is up to them. |
| Minimum / Maximum | Slider range (defaults 0.0 and 1.0). Minimum must be smaller than maximum. A rule with Use shape key range overrides these with the shape key's slider range. |
(The hidden group ID that the shape-key sync assigns is not user-editable.)
- Simple: Controller name
smile, link Value → Shape flex rule Value, Controller → collector Controllers. - Combined: link Value into a Flex arithmetic together with another controller to build
smile * (1.0 - blink)style expressions.
- Names that clash with
left_X/right_Xof a stereo controller are rejected. - The same shape key must be directly driven by only one controller.
- Deleting a shape key orphans its rule; the shape-key sync then unlinks this controller from the collector until a live rule comes back (controllers without rules are untouched).
- Generated graphs (Add rules for them, Generate flex rule graph) create these nodes automatically, named after the shape key.
Back to Export Nodes