Skip to content

Export Nodes SourceIOFlexControllerNode

REDxEYE edited this page Nov 20, 2026 · 1 revision

Flex controller

Category: Flex rules · Node ID: SourceIOFlexControllerNode

Flex controller node

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.

Inputs

None.

Outputs

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").

Properties

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.)

Example workflow

  • 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.

Caveats

  • Names that clash with left_X/right_X of 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

Clone this wiki locally