Kit rig

112 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Herramientas

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

rig.add_aim_template (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Aim template: a target control plus an Aim (AimItem) node that points a bone axis at it.

Argumento	Tipo	Descripción
bone	string	obligatorio. Bone to aim.
controlName	string	Name of the created target control; empty = bone + '_aim'.
aimAxis	{x,y,z}	Bone-local axis that points at the target. Valor predeterminado FUeaVec3(1.0, 0.0, 0.0).
targetOffset	{x,y,z}	Initial target offset from the bone in rig space. Valor predeterminado FUeaVec3(100.0, 0.0, 0.0).
executeAfter	string	Optional node whose execute output starts the chain.
position	UeaRigVec2	Position of the first node.

Devuelve: graph, controls, nodes, links, entryPin, exitPin.

rig.add_animation_channel (riesgo 2, modifica, UE 5.1+, requiere el plugin ControlRig, smoke)

Adds an animation channel (an extra animatable value hosted by a control) on UE5.1+.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Bare channel name.
parentControl	string	obligatorio. Host control name.
controlType	string	Channel type: bool, float, integer, vector2D, position, scale, rotator, scaleFloat (5.4+). Valor predeterminado TEXT("float").

Devuelve: control.

rig.add_array_pin (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds (index -1) or inserts an element pin into an array pin.

Argumento	Tipo	Descripción
index	integer	Insert index; -1 appends. Valor predeterminado -1.
defaultValue	string	Default of the new element as exported text.

Devuelve: graph, pin, createdPin.

rig.add_available_space (riesgo 2, modifica, UE 5.5+, requiere el plugin ControlRig, smoke)

Adds a space to a control's space-switching list (UE5.5+).

Argumento	Tipo	Descripción
space	string	obligatorio. Space element name.
spaceType	string	Space element type: bone, control or null. Valor predeterminado TEXT("bone").

Devuelve: control.

rig.add_bone (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a user bone with an optional parent (bone by default; see parentType) and returns it with its transforms.

Argumento	Tipo	Descripción
parent	string	Optional parent element name.
parentType	string	Parent type: bone (default), control, null (UE5). On UE4.27 bones take bone parents and controls take control or space parents. Valor predeterminado TEXT("bone").
controlType	string	add_control only: control type (bool, float, integer, vector2D, position, scale, rotator, transform, transformNoScale, eulerTransform, scaleFloat on UE5.4+). Valor predeterminado TEXT("transform").

Devuelve: element, transforms, children.

rig.add_bone_chain (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a chain of bones, each offset from its predecessor, below an optional parent bone.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
names	array of string	obligatorio. Bare bone names, root of the chain first.
parent	string	Optional parent bone of the first chain bone.
offset	{x,y,z}	Local translation of each bone relative to its predecessor, in centimetres. Valor predeterminado FUeaVec3(0.0, 0.0, 20.0).

Devuelve: elements, count.

rig.add_branch_node (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a Branch (if) node.

Argumento	Tipo	Descripción
position	UeaRigVec2	Graph position.
nodeName	string	Requested node name.

Devuelve: graph, node.

rig.add_comment (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a comment box.

Argumento	Tipo	Descripción
text	string	obligatorio. Comment text.
position	UeaRigVec2	Graph position.
size	UeaRigVec2	Comment box size.
color	UeaRigColor	Comment colour.
nodeName	string	Requested node name.

Devuelve: graph, node.

rig.add_control (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a control of any control type (default transform) with an optional parent and returns it. UE4.27 controls take control or space parents only.

Argumento	Tipo	Descripción
parent	string	Optional parent element name.
parentType	string	Parent type: bone (default), control, null (UE5). On UE4.27 bones take bone parents and controls take control or space parents. Valor predeterminado TEXT("bone").
controlType	string	add_control only: control type (bool, float, integer, vector2D, position, scale, rotator, transform, transformNoScale, eulerTransform, scaleFloat on UE5.4+). Valor predeterminado TEXT("transform").

Devuelve: element, transforms, children.

rig.add_curve (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a float curve element with an explicit initial value.

Argumento	Tipo	Descripción
name	string	obligatorio. Bare curve name.
value	number	Initial curve value. Valor predeterminado 0.0.

Devuelve: element, transforms, children.

rig.add_fk_template (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

FK template: one control per bone (at the bone pose) plus Get Transform -> Set Transform nodes chained by execution.

Argumento	Tipo	Descripción
bones	array of string	obligatorio. Bones to drive, parents first. One control per bone is created at the bone's initial global transform.
controlSuffix	string	Suffix of the created control names. Valor predeterminado TEXT("_fk").
executeAfter	string	Optional node whose execute output starts the chain (e.g. the Forwards Solve event node).
position	UeaRigVec2	Position of the first node.

Devuelve: graph, controls, nodes, links, entryPin, exitPin.

rig.add_function (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Adds a function to the rig's local function library (UE5).

Argumento	Tipo	Descripción
name	string	obligatorio. Function name.
mutable	boolean	add_function: the function has an execute pin (mutable). Valor predeterminado true.
position	UeaRigVec2	add_function: position in the function library.

Devuelve: functions, count.

rig.add_function_reference (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Adds a node that calls a local library function (UE5).

Argumento	Tipo	Descripción
function	string	obligatorio. Local library function name.
position	UeaRigVec2	Graph position.
nodeName	string	Requested node name.

Devuelve: graph, node.

rig.add_member_variable (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a blueprint member variable (bool, int, float, name, vector, rotator, transform) usable by variable nodes.

Argumento	Tipo	Descripción
name	string	obligatorio. Bare variable name.
type	string	bool, int, float, name, vector, rotator or transform. Valor predeterminado TEXT("float").
public	boolean	Expose the variable on spawn / as a rig input. Valor predeterminado true.

Devuelve: variables, count.

rig.add_null (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Adds a null transform element with an optional parent. Available in UE 5.0 and later.

Argumento	Tipo	Descripción
parent	string	Optional parent element name.
parentType	string	Parent type: bone (default), control, null (UE5). On UE4.27 bones take bone parents and controls take control or space parents. Valor predeterminado TEXT("bone").
controlType	string	add_control only: control type (bool, float, integer, vector2D, position, scale, rotator, transform, transformNoScale, eulerTransform, scaleFloat on UE5.4+). Valor predeterminado TEXT("transform").

Devuelve: element, transforms, children.

rig.add_parent (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Adds an extra weighted parent to an element (UE5 multi-parent space switching).

Argumento	Tipo	Descripción
parent	string	obligatorio. Parent element name.
parentType	string	Parent element type: bone, control or null. Valor predeterminado TEXT("bone").
weight	UeaRigWeight	Weight of the relation (add_parent uses location as the single initial weight).
maintainGlobalTransform	boolean	Keep the child's global transform while changing relations. Valor predeterminado true.
initial	boolean	set_parent_weight: write the initial weight instead of the current one. Valor predeterminado true.

Devuelve: element, parents, count.

rig.add_socket (riesgo 2, modifica, UE 5.4+, requiere el plugin ControlRig, smoke)

Adds a socket (UE5.4+) below a parent element.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Bare socket name.
parent	string	obligatorio. Parent element name.
parentType	string	Parent element type. Valor predeterminado TEXT("bone").
transform	UeaRigTransform	Socket transform relative to the parent.
description	string	Description shown by modular rigs.

Devuelve: element, transforms, children.

rig.add_two_bone_ik_template (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Two-bone IK template: an effector control plus a Basic IK (TwoBoneIKSimplePerItem) node driven by it.

Argumento	Tipo	Descripción
itemA	string	obligatorio. Upper bone (e.g. upperarm).
itemB	string	obligatorio. Lower bone (e.g. lowerarm).
effector	string	obligatorio. Effector bone (e.g. hand).
controlName	string	Name of the created effector control; empty = effector + '_ik'.
poleVector	{x,y,z}	Pole vector in rig space. Valor predeterminado FUeaVec3(0.0, 100.0, 0.0).
executeAfter	string	Optional node whose execute output starts the chain.
position	UeaRigVec2	Position of the first node.

Devuelve: graph, controls, nodes, links, entryPin, exitPin.

rig.add_unit_node (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a RigUnit node (struct path or unique name) and returns it with its pins.

Argumento	Tipo	Descripción
unit	string	obligatorio. RigUnit struct path or unique name (see rig.search_rig_units).
method	string	Unit method. Valor predeterminado TEXT("Execute").
position	UeaRigVec2	Graph position.
nodeName	string	Requested node name (the engine makes it unique); empty lets the engine name it.

Devuelve: graph, node.

rig.add_variable_node (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Adds a Get or Set node for a member variable.

Argumento	Tipo	Descripción
variable	string	obligatorio. Member variable name (see rig.add_member_variable).
isGetter	boolean	true = Get node, false = Set node. Valor predeterminado true.
position	UeaRigVec2	Graph position.
nodeName	string	Requested node name.

Devuelve: graph, node.

rig.audit_hierarchy (riesgo 0, requiere el plugin ControlRig, smoke)

Checks that every hierarchy element has a non-empty unique typed key.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.audit_rigs (riesgo 0, requiere el plugin ControlRig, smoke)

Audits every Control Rig of a folder: compile status, preview mesh, hierarchy and graph counts, with problems listed per rig.

Argumento	Tipo	Descripción
folder	string	Content folder searched recursively. Valor predeterminado TEXT("/Game").
nameContains	string	Optional case-insensitive asset-name fragment.
limit	integer	Maximum processed assets; 0 = unlimited. Valor predeterminado 100.

Devuelve: rigs, count, problemCount.

rig.break_pin_links (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Breaks every link of a pin.

Argumento	Tipo	Descripción
asInput	boolean	Break the links that feed the pin (true) or leave it (false). Valor predeterminado true.

Devuelve: graph, links, count.

rig.clear_mapped_elements (riesgo 2, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Removes every bone/curve mapping of a Control Rig component.

Argumento	Tipo	Descripción
actor	string	obligatorio. Actor label or name (or class:).

Devuelve: component, changedActors.

rig.collapse_nodes (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Collapses nodes into a collapse node with its own graph (UE5).

Argumento	Tipo	Descripción
nodes	array of string	Node names.
newName	string	collapse_nodes: requested name of the collapse node.

Devuelve: graph, node.

rig.compile_control_rig (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Compiles a Control Rig Blueprint so its generated class is usable by animation and Sequencer tools.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: rig.

rig.compile_rigs (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Compiles every Control Rig of a folder and reports per-rig status and message counts.

Argumento	Tipo	Descripción
folder	string	Content folder searched recursively. Valor predeterminado TEXT("/Game").
nameContains	string	Optional case-insensitive asset-name fragment.
limit	integer	Maximum processed assets; 0 = unlimited. Valor predeterminado 100.

Devuelve: rigs, count, failedCount.

rig.connect_pins (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Links an output pin to an input pin.

Argumento	Tipo	Descripción
source	string	obligatorio. Source (output) pin path.
target	string	obligatorio. Target (input) pin path.

Devuelve: graph, links, count.

rig.create_control_rig (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Creates an empty Control Rig Blueprint and returns its asset state.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination content folder, beginning with /Game.
name	string	obligatorio. Bare asset name.

Devuelve: rig.

rig.disconnect_pins (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Removes the link between two pins.

Argumento	Tipo	Descripción
source	string	obligatorio. Source (output) pin path.
target	string	obligatorio. Target (input) pin path.

Devuelve: graph, links, count.

rig.duplicate_element (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Duplicates one hierarchy element and returns the duplicated element key.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Element name.
type	string	Element type: bone, control, curve, null (UE5), socket (UE5.4+) or space (UE4.27). Valor predeterminado TEXT("bone").

Devuelve: element, transforms, children.

rig.evaluate_rig_component (riesgo 1, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Evaluates the rig instance of a Control Rig component once (forward solve) and returns its element counts.

Argumento	Tipo	Descripción
deltaTime	number	Delta time passed to the rig update, in seconds. Valor predeterminado 0.0.

Devuelve: component, changedActors.

rig.expand_collapse_node (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Expands a collapse node back into its graph (UE5).

Argumento	Tipo	Descripción
node	string	obligatorio. Node name.

Devuelve: graph, nodes, count.

rig.export_hierarchy (riesgo 0, requiere el plugin ControlRig, smoke)

Exports elements (all when 'elements' is empty) to the engine's hierarchy copy/paste text.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
elements	array of UeaRigElementRef	Elements; empty means every element (export) or clears the selection (select_elements).

Devuelve: text, count.

rig.export_nodes (riesgo 0, requiere el plugin ControlRig, smoke)

Exports nodes to the RigVM copy/paste text.

Argumento	Tipo	Descripción
nodes	array of string	Node names.
newName	string	collapse_nodes: requested name of the collapse node.

Devuelve: text, count.

rig.find_elements (riesgo 0, requiere el plugin ControlRig, smoke)

Finds hierarchy elements by type and case-insensitive name fragment.

Argumento	Tipo	Descripción
nameContains	string	Optional case-insensitive element-name fragment.
type	string	Optional exact element type such as bone, control, null, or curve.

Devuelve: elements, count.

rig.find_rigs_by_mesh (riesgo 0, requiere el plugin ControlRig, smoke)

Finds the Control Rigs whose preview mesh is (or shares the skeleton of) a skeletal mesh or skeleton.

Argumento	Tipo	Descripción
mesh	string	obligatorio. Skeletal mesh or skeleton asset.
folder	string	Content folder searched recursively. Valor predeterminado TEXT("/Game").
matchSkeleton	boolean	Also match rigs whose preview mesh shares the skeleton of 'mesh'. Valor predeterminado true.

Devuelve: rigs, count.

rig.get_children (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the children of an element, optionally recursively.

Argumento	Tipo	Descripción
recursive	boolean	Include indirect relatives (grandparents / grandchildren). Valor predeterminado false.

Devuelve: elements, count.

rig.get_compile_errors (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Compiles the rig and returns its typed compiler messages.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: rig, errorCount, warningCount, messages.

rig.get_control_rig_info (riesgo 0, requiere el plugin ControlRig, smoke)

Gets Control Rig asset state, including its compiled class and hierarchy count.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: rig.

rig.get_control_settings (riesgo 0, requiere el plugin ControlRig, smoke)

Returns a control's full authored state: type, display name, shape, offset, limits, min/max, initial and current values, and available spaces.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Control name.

Devuelve: control.

rig.get_control_value (riesgo 0, requiere el plugin ControlRig, smoke)

Reads one control value (kind: initial, current, minimum, maximum), typed by the control type.

Argumento	Tipo	Descripción
kind	string	current or initial (setters); getters also accept minimum and maximum. Valor predeterminado TEXT("initial").
value	UeaRigControlValue	New value (setters).

Devuelve: element, kind, value.

rig.get_curve_value (riesgo 0, requiere el plugin ControlRig, smoke)

Reads the value of a curve element.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Curve name.
value	number	New value (setter). Valor predeterminado 0.0.

Devuelve: name, value.

rig.get_element (riesgo 0, requiere el plugin ControlRig, smoke)

Gets one exact hierarchy element by type and name with its parent, children and initial/current local/global transforms.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Element name.
type	string	Element type: bone, control, curve, null (UE5), socket (UE5.4+) or space (UE4.27). Valor predeterminado TEXT("bone").

Devuelve: element, transforms, children.

rig.get_element_metadata (riesgo 0, UE 5.1+, requiere el plugin ControlRig, smoke)

Lists the metadata names, types and values of an element (UE5.1+).

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Element name.
type	string	Element type: bone, control, curve, null (UE5), socket (UE5.4+) or space (UE4.27). Valor predeterminado TEXT("bone").

Devuelve: element, entries, count.

rig.get_global_transform (riesgo 0, requiere el plugin ControlRig, smoke)

Gets an element's global authored transform.

Argumento	Tipo	Descripción
initial	boolean	Reads or writes the authored initial (setup pose) transform instead of the current transform. Valor predeterminado true.
transform	UeaRigTransform	New transform value for setter tools.
affectChildren	boolean	Propagates the transform change to children. UE4.27 always propagates; false is rejected there. Valor predeterminado true.

Devuelve: element, transform, transforms.

rig.get_local_transform (riesgo 0, requiere el plugin ControlRig, smoke)

Gets an element's local authored transform.

Argumento	Tipo	Descripción
initial	boolean	Reads or writes the authored initial (setup pose) transform instead of the current transform. Valor predeterminado true.
transform	UeaRigTransform	New transform value for setter tools.
affectChildren	boolean	Propagates the transform change to children. UE4.27 always propagates; false is rejected there. Valor predeterminado true.

Devuelve: element, transform, transforms.

rig.get_node (riesgo 0, requiere el plugin ControlRig, smoke)

Returns one node with all its pins, defaults and links.

Argumento	Tipo	Descripción
node	string	obligatorio. Node name.

Devuelve: graph, node.

rig.get_parents (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the parents of an element with their weights (UE5 multi-parent; UE4.27 has one parent).

Argumento	Tipo	Descripción
recursive	boolean	Include indirect relatives (grandparents / grandchildren). Valor predeterminado false.

Devuelve: element, parents, count.

rig.get_pin_default (riesgo 0, requiere el plugin ControlRig, smoke)

Reads one pin with its default value and links.

Argumento	Tipo	Descripción
pin	string	obligatorio. Pin path (Node.Pin or Node.Pin.SubPin).

Devuelve: graph, pin, createdPin.

rig.get_pose (riesgo 0, requiere el plugin ControlRig, smoke)

Returns initial/current local/global transforms of every element (optionally one type).

Argumento	Tipo	Descripción
type	string	Optional element type filter.

Devuelve: entries, count.

rig.get_rig_component_bone (riesgo 0, requiere el plugin ControlRig, requiere mundo, smoke)

Reads a bone transform of the running rig in world, actor, component or rig space.

Argumento	Tipo	Descripción
bone	string	obligatorio. Bone name.
space	string	worldSpace, actorSpace, componentSpace or rigSpace. Valor predeterminado TEXT("rigSpace").
initial	boolean	Read the initial (reference) transform instead of the current one (getter). Valor predeterminado false.
transform	UeaRigTransform	New transform (setter).
weight	number	Blend weight of the write (setter). Valor predeterminado 1.0.
propagateToChildren	boolean	Propagate the write to children (setter). Valor predeterminado true.

Devuelve: name, space, transform.

rig.get_rig_component_control (riesgo 0, requiere el plugin ControlRig, requiere mundo, smoke)

Reads a control of the running rig (transform, float, bool, int, vector2D, position, rotator or scale).

Argumento	Tipo	Descripción
control	string	obligatorio. Control name.
valueKind	string	Value kind: transform, float, bool, int, vector2D, position, rotator, scale. Valor predeterminado TEXT("transform").
space	string	Space for transform/position/rotator/scale: worldSpace, actorSpace, componentSpace, rigSpace, localSpace. Valor predeterminado TEXT("rigSpace").
number	number	Scalar value (float, bool 0/1, int). Valor predeterminado 0.0.
vector	{x,y,z}	Vector value (vector2D x/y, position, rotator pitch/yaw/roll, scale).
transform	UeaRigTransform	Transform value.

Devuelve: control, valueKind, number, vector, transform.

rig.get_rig_component_elements (riesgo 0, requiere el plugin ControlRig, requiere mundo, smoke)

Lists the element names of the running rig by type.

Argumento	Tipo	Descripción
type	string	bone, control, curve, null (UE5) or space (UE4.27). Valor predeterminado TEXT("bone").

Devuelve: names, count.

rig.get_selection (riesgo 0, requiere el plugin ControlRig, smoke)

Returns the elements selected in the Control Rig editor.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.import_bones (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Imports the bone hierarchy of a skeletal mesh or skeleton into the rig.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
source	string	obligatorio. Skeletal mesh or skeleton asset.
replaceExisting	boolean	Replace bones that already exist (updating their transforms). Valor predeterminado false.
removeObsolete	boolean	Remove bones that do not exist in the source. Valor predeterminado false.

Devuelve: elements, count.

rig.import_hierarchy (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Imports hierarchy text (from rig.export_hierarchy) or copies elements from another rig.

Argumento	Tipo	Descripción
rig	string	obligatorio. Target Control Rig Blueprint.
text	string	Hierarchy text from rig.export_hierarchy. Set either text or sourceRig.
sourceRig	string	Rig to copy elements from (exported and imported in one call).
sourceElements	array of UeaRigElementRef	Elements of sourceRig to copy; empty copies all of them.
replaceExisting	boolean	Replace elements with the same name instead of creating uniquely named copies. Valor predeterminado false.

Devuelve: elements, count.

rig.import_nodes (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Imports node text, or copies nodes from another rig graph, into a graph.

Argumento	Tipo	Descripción
text	string	Node text from rig.export_nodes. Set either text or sourceRig.
sourceRig	string	Rig to copy nodes from.
sourceGraph	string	Graph of sourceRig (empty = main graph).
sourceNodes	array of string	Node names in the source graph.

Devuelve: graph, nodes, count.

rig.list_bones (riesgo 0, requiere el plugin ControlRig, smoke)

Lists only hierarchy bones.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.list_control_rigs (riesgo 0, requiere el plugin ControlRig, smoke)

Lists Control Rig Blueprint assets under a content folder.

Argumento	Tipo	Descripción
folder	string	Content folder to search. Valor predeterminado TEXT("/Game").
nameContains	string	Optional case-insensitive asset-name fragment.
limit	integer	Maximum returned assets; zero means no limit. Valor predeterminado 100.

Devuelve: rigs, count.

rig.list_control_shapes (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the shape names available to controls from the rig's shape (gizmo) libraries.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: libraries, shapes, count.

rig.list_controls (riesgo 0, requiere el plugin ControlRig, smoke)

Lists only hierarchy controls.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.list_curves (riesgo 0, requiere el plugin ControlRig, smoke)

Lists UE5 curve elements.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.list_functions (riesgo 0, UE 5.0+, requiere el plugin ControlRig, smoke)

Lists the functions of the rig's local function library (UE5).

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: functions, count.

rig.list_graphs (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the RigVM graphs of a rig (main graph, collapse and function graphs, function library).

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: graphs, count.

rig.list_hierarchy (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the elements in a Control Rig hierarchy.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.list_links (riesgo 0, requiere el plugin ControlRig, smoke)

Lists every link of a graph as source/target pin paths.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
graph	string	Graph path from rig.list_graphs (function or collapse graph, UE5); empty = the rig's main graph.

Devuelve: graph, links, count.

rig.list_nodes (riesgo 0, requiere el plugin ControlRig, smoke)

Lists the nodes of a graph, optionally filtered and with pins.

Argumento	Tipo	Descripción
nameContains	string	Optional case-insensitive fragment of the node name, title or unit.
includePins	boolean	Include every pin of every node. Valor predeterminado false.

Devuelve: graph, nodes, count.

rig.list_nulls (riesgo 0, UE 5.0+, requiere el plugin ControlRig, smoke)

Lists UE5 null transform elements.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: elements, count.

rig.list_rig_components (riesgo 0, requiere el plugin ControlRig, requiere mundo, smoke)

Lists the Control Rig components in the editor world.

Argumento	Tipo	Descripción
rig	string	Optional Control Rig Blueprint: only components running its generated class.

Devuelve: components, count.

rig.map_skeletal_mesh (riesgo 2, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Maps every bone of an actor's skeletal mesh component to the rig so evaluation drives the mesh.

Argumento	Tipo	Descripción
meshActor	string	Actor that owns the skeletal mesh component; empty = the rig actor itself.

Devuelve: component, changedActors.

rig.mirror_elements (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Mirrors elements across an axis, renaming them with search/replace (e.g. _l to _r).

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
elements	array of UeaRigElementRef	obligatorio. Elements to mirror.
mirrorAxis	string	Mirror plane normal axis: x, y or z. Valor predeterminado TEXT("x").
axisToFlip	string	Axis to flip: x, y or z. Valor predeterminado TEXT("z").
search	string	Name fragment to replace in the mirrored names (e.g. _l).
replace	string	Replacement fragment (e.g. _r).

Devuelve: elements, count.

rig.remove_array_pin (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Removes an element pin from an array pin.

Argumento	Tipo	Descripción
pin	string	obligatorio. Pin path (Node.Pin or Node.Pin.SubPin).

Devuelve: graph, pin, createdPin.

rig.remove_available_space (riesgo 2, modifica, UE 5.5+, requiere el plugin ControlRig, smoke)

Removes a space from a control's space-switching list (UE5.5+).

Argumento	Tipo	Descripción
space	string	obligatorio. Space element name.
spaceType	string	Space element type: bone, control or null. Valor predeterminado TEXT("bone").

Devuelve: control.

rig.remove_element (riesgo 3, modifica, destructivo, requiere el plugin ControlRig, smoke)

Removes one hierarchy element. This can remove dependent hierarchy content.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Element name.
type	string	Element type: bone, control, curve, null (UE5), socket (UE5.4+) or space (UE4.27). Valor predeterminado TEXT("bone").

Devuelve: elements, count.

rig.remove_element_metadata (riesgo 2, modifica, UE 5.1+, requiere el plugin ControlRig, smoke)

Removes one metadata entry from an element (UE5.1+).

Argumento	Tipo	Descripción
metadataName	string	obligatorio. Metadata name.
metadataType	string	bool, float, int32, name, vector, rotator, transform or linearColor. Valor predeterminado TEXT("float").
number	number	Value for bool (0/1), float and int32. Valor predeterminado 0.0.
text	string	Value for name.
vector	{x,y,z}	Value for vector and rotator (pitch, yaw, roll).
transform	UeaRigTransform	Value for transform.
color	UeaRigColor	Value for linearColor.

Devuelve: element, entries, count.

rig.remove_function (riesgo 3, modifica, destructivo, UE 5.0+, requiere el plugin ControlRig, smoke)

Removes a local library function (UE5); nodes that reference it are removed by the engine.

Argumento	Tipo	Descripción
name	string	obligatorio. Function name.
mutable	boolean	add_function: the function has an execute pin (mutable). Valor predeterminado true.
position	UeaRigVec2	add_function: position in the function library.

Devuelve: functions, count.

rig.remove_node (riesgo 3, modifica, destructivo, requiere el plugin ControlRig, smoke)

Removes a node and its links.

Argumento	Tipo	Descripción
node	string	obligatorio. Node name.

Devuelve: graph, nodes, count.

rig.remove_parent (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Removes one parent relation of an element (UE5 multi-parent).

Argumento	Tipo	Descripción
parent	string	obligatorio. Parent element name.
parentType	string	Parent element type: bone, control or null. Valor predeterminado TEXT("bone").
weight	UeaRigWeight	Weight of the relation (add_parent uses location as the single initial weight).
maintainGlobalTransform	boolean	Keep the child's global transform while changing relations. Valor predeterminado true.
initial	boolean	set_parent_weight: write the initial weight instead of the current one. Valor predeterminado true.

Devuelve: element, parents, count.

rig.remove_rig_actor (riesgo 3, modifica, destructivo, requiere el plugin ControlRig, requiere mundo, smoke)

Destroys an actor that carries a Control Rig component (exact label or name; refuses actors without one).

Argumento	Tipo	Descripción
actor	string	obligatorio. Actor label or name (or class:).

Devuelve: component, changedActors.

rig.rename_element (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Renames a hierarchy element and returns its new key.

Argumento	Tipo	Descripción
newName	string	obligatorio. New bare element name.

Devuelve: element, transforms, children.

rig.rename_node (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Renames a node (UE5).

Argumento	Tipo	Descripción
newName	string	obligatorio. New node name.

Devuelve: graph, node.

rig.reorder_element (riesgo 2, modifica, UE 5.2+, requiere el plugin ControlRig, smoke)

Moves an element to another index among its siblings (UE5.2+).

Argumento	Tipo	Descripción
index	integer	New index among the siblings. Valor predeterminado 0.

Devuelve: elements, count.

rig.reparent_element (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Replaces the parent of an element; an empty parent makes it a root element (UE5 removes all parents).

Argumento	Tipo	Descripción
parent	string	New parent name, or empty to clear the parent.
parentType	string	New parent type: bone, control, or null (UE5). Valor predeterminado TEXT("bone").
maintainGlobalTransform	boolean	Preserves global location while changing the hierarchy parent. UE4.27 always preserves it; false is rejected there. Valor predeterminado true.

Devuelve: element, transforms, children.

rig.reset_pin_default (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Restores a pin's default to the unit default.

Argumento	Tipo	Descripción
pin	string	obligatorio. Pin path (Node.Pin or Node.Pin.SubPin).

Devuelve: graph, pin, createdPin.

rig.reset_pose (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Resets every current transform to the initial (setup) pose.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: entries, count.

rig.search_rig_units (riesgo 0, requiere el plugin ControlRig, smoke)

Searches the loaded RigUnit structs usable by rig.add_unit_node.

Argumento	Tipo	Descripción
nameContains	string	Optional case-insensitive fragment of the struct name, display name or category.
limit	integer	Maximum results; 0 = unlimited. Valor predeterminado 100.

Devuelve: units, count.

rig.select_elements (riesgo 1, modifica, requiere el plugin ControlRig, smoke)

Replaces the editor selection with the given elements (empty clears it).

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
elements	array of UeaRigElementRef	Elements; empty means every element (export) or clears the selection (select_elements).

Devuelve: elements, count.

rig.select_nodes (riesgo 1, modifica, requiere el plugin ControlRig, smoke)

Replaces the node selection of the graph (empty clears it).

Argumento	Tipo	Descripción
nodes	array of string	Node names.
newName	string	collapse_nodes: requested name of the collapse node.

Devuelve: graph, nodes, count.

rig.set_array_pin_size (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Sets the element count of an array pin.

Argumento	Tipo	Descripción
size	integer	New element count. Valor predeterminado 0.
defaultValue	string	Default of added elements as exported text.

Devuelve: graph, pin, createdPin.

rig.set_comment_text (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Changes a comment's text (and UE5 font size / bubble options).

Argumento	Tipo	Descripción
text	string	obligatorio. New comment text.
fontSize	integer	UE5 font size. Valor predeterminado 18.
bubbleVisible	boolean	UE5 show the comment bubble. Valor predeterminado false.
colorBubble	boolean	UE5 colour the comment bubble. Valor predeterminado false.

Devuelve: graph, node.

rig.set_control_animation_type (riesgo 2, modifica, UE 5.1+, requiere el plugin ControlRig, smoke)

Sets the UE5.1+ animation type of a control (animationControl, animationChannel, proxyControl, visualCue).

Argumento	Tipo	Descripción
animationType	string	obligatorio. animationControl, animationChannel, proxyControl or visualCue.

Devuelve: control.

rig.set_control_display_name (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Sets the display name the editor and Sequencer show for a control.

Argumento	Tipo	Descripción
displayName	string	New display name (empty clears it).

Devuelve: control.

rig.set_control_limits (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Enables translation/rotation/scale limits and writes the minimum and maximum values of a control.

Argumento	Tipo	Descripción
limitTranslation	boolean	Limit translation (or the single channel of float/integer/vector2D controls). Valor predeterminado false.
limitRotation	boolean	Limit rotation channels. Valor predeterminado false.
limitScale	boolean	Limit scale channels. Valor predeterminado false.
drawLimits	boolean	Draw the limits in the viewport. Valor predeterminado true.
minimum	UeaRigControlValue	Minimum value, typed like the control.
maximum	UeaRigControlValue	Maximum value, typed like the control.

Devuelve: control.

rig.set_control_offset (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Sets a control's offset transform (the frame between its parent and the control).

Argumento	Tipo	Descripción
transform	UeaRigTransform	New offset transform relative to the parent.
initial	boolean	Writes the initial offset (UE4.27 stores one offset; false is rejected there). Valor predeterminado true.

Devuelve: control.

rig.set_control_shape (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Changes a control's shape name, colour, visibility and/or shape transform.

Argumento	Tipo	Descripción
shapeName	string	New shape name from the rig's shape library (see rig.list_control_shapes); empty leaves it unchanged.
applyColor	boolean	Apply 'color'. Valor predeterminado false.
color	UeaRigColor	New shape colour.
visibility	string	visible, hidden, or empty to leave visibility unchanged.
applyTransform	boolean	Apply 'transform'. Valor predeterminado false.
transform	UeaRigTransform	New initial shape transform relative to the control.

Devuelve: control.

rig.set_control_value (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Writes the initial or current value of a control; the field matching the control type is used.

Argumento	Tipo	Descripción
kind	string	current or initial (setters); getters also accept minimum and maximum. Valor predeterminado TEXT("initial").
value	UeaRigControlValue	New value (setters).

Devuelve: element, kind, value.

rig.set_curve_value (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Writes the value of a curve element.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.
name	string	obligatorio. Curve name.
value	number	New value (setter). Valor predeterminado 0.0.

Devuelve: name, value.

rig.set_element_metadata (riesgo 2, modifica, UE 5.1+, requiere el plugin ControlRig, smoke)

Writes one typed metadata value on an element (UE5.1+).

Argumento	Tipo	Descripción
metadataName	string	obligatorio. Metadata name.
metadataType	string	bool, float, int32, name, vector, rotator, transform or linearColor. Valor predeterminado TEXT("float").
number	number	Value for bool (0/1), float and int32. Valor predeterminado 0.0.
text	string	Value for name.
vector	{x,y,z}	Value for vector and rotator (pitch, yaw, roll).
transform	UeaRigTransform	Value for transform.
color	UeaRigColor	Value for linearColor.

Devuelve: element, entries, count.

rig.set_global_transform (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Sets an element's global authored transform.

Argumento	Tipo	Descripción
initial	boolean	Reads or writes the authored initial (setup pose) transform instead of the current transform. Valor predeterminado true.
transform	UeaRigTransform	New transform value for setter tools.
affectChildren	boolean	Propagates the transform change to children. UE4.27 always propagates; false is rejected there. Valor predeterminado true.

Devuelve: element, transform, transforms.

rig.set_local_transform (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Sets an element's local authored transform.

Argumento	Tipo	Descripción
initial	boolean	Reads or writes the authored initial (setup pose) transform instead of the current transform. Valor predeterminado true.
transform	UeaRigTransform	New transform value for setter tools.
affectChildren	boolean	Propagates the transform change to children. UE4.27 always propagates; false is rejected there. Valor predeterminado true.

Devuelve: element, transform, transforms.

rig.set_node_color (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Recolours a node.

Argumento	Tipo	Descripción
color	UeaRigColor	New node colour.

Devuelve: graph, node.

rig.set_node_position (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Moves a node.

Argumento	Tipo	Descripción
value	UeaRigVec2	New position (set_node_position) or size (set_node_size).

Devuelve: graph, node.

rig.set_node_size (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Resizes a node (mostly comment boxes).

Argumento	Tipo	Descripción
value	UeaRigVec2	New position (set_node_position) or size (set_node_size).

Devuelve: graph, node.

rig.set_parent_weight (riesgo 2, modifica, UE 5.0+, requiere el plugin ControlRig, smoke)

Sets the per-channel weight of an existing parent relation (UE5).

Argumento	Tipo	Descripción
parent	string	obligatorio. Parent element name.
parentType	string	Parent element type: bone, control or null. Valor predeterminado TEXT("bone").
weight	UeaRigWeight	Weight of the relation (add_parent uses location as the single initial weight).
maintainGlobalTransform	boolean	Keep the child's global transform while changing relations. Valor predeterminado true.
initial	boolean	set_parent_weight: write the initial weight instead of the current one. Valor predeterminado true.

Devuelve: element, parents, count.

rig.set_pin_default (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Writes a pin default value as exported text.

Argumento	Tipo	Descripción
value	string	New default as exported text (e.g. 0.5, (X=1,Y=0,Z=0), (Type=Bone,Name="hand_l")).
resizeArrays	boolean	Resize array pins to match an array value. Valor predeterminado true.

Devuelve: graph, pin, createdPin.

rig.set_pin_expansion (riesgo 1, modifica, requiere el plugin ControlRig, smoke)

Expands or collapses a struct or array pin in the editor.

Argumento	Tipo	Descripción
expanded	boolean	Expanded state. Valor predeterminado true.

Devuelve: graph, pin, createdPin.

rig.set_preview_mesh (riesgo 2, modifica, requiere el plugin ControlRig, smoke)

Assigns a skeletal mesh as the editor preview mesh and returns updated state.

Argumento	Tipo	Descripción
skeletalMesh	string	obligatorio. Skeletal mesh asset used as the rig preview mesh.

Devuelve: rig.

rig.set_rig_component_bone (riesgo 1, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Writes a bone transform of the running rig.

Argumento	Tipo	Descripción
bone	string	obligatorio. Bone name.
space	string	worldSpace, actorSpace, componentSpace or rigSpace. Valor predeterminado TEXT("rigSpace").
initial	boolean	Read the initial (reference) transform instead of the current one (getter). Valor predeterminado false.
transform	UeaRigTransform	New transform (setter).
weight	number	Blend weight of the write (setter). Valor predeterminado 1.0.
propagateToChildren	boolean	Propagate the write to children (setter). Valor predeterminado true.

Devuelve: name, space, transform.

rig.set_rig_component_control (riesgo 1, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Drives a control of the running rig.

Argumento	Tipo	Descripción
control	string	obligatorio. Control name.
valueKind	string	Value kind: transform, float, bool, int, vector2D, position, rotator, scale. Valor predeterminado TEXT("transform").
space	string	Space for transform/position/rotator/scale: worldSpace, actorSpace, componentSpace, rigSpace, localSpace. Valor predeterminado TEXT("rigSpace").
number	number	Scalar value (float, bool 0/1, int). Valor predeterminado 0.0.
vector	{x,y,z}	Vector value (vector2D x/y, position, rotator pitch/yaw/roll, scale).
transform	UeaRigTransform	Transform value.

Devuelve: control, valueKind, number, vector, transform.

rig.spawn_rig_actor (riesgo 2, modifica, requiere el plugin ControlRig, requiere mundo, smoke)

Spawns an actor with a Control Rig component running a compiled rig, optionally with a mapped skeletal mesh.

Argumento	Tipo	Descripción
rig	string	obligatorio. Compiled Control Rig Blueprint whose generated class the component runs.
label	string	Actor label. Valor predeterminado TEXT("ControlRigActor").
location	{x,y,z}	World location in centimetres.
skeletalMesh	string	Optional skeletal mesh shown by the actor and driven by the rig (all bones mapped).

Devuelve: component, changedActors.

rig.validate_hierarchy (riesgo 0, requiere el plugin ControlRig, smoke)

Checks the hierarchy for missing parents, degenerate transforms, duplicate display names and empty names.

Argumento	Tipo	Descripción
rig	string	obligatorio. Control Rig Blueprint object or package path.

Devuelve: valid, issues, errorCount, warningCount, elementCount.