Kit statetree

52 ferramentas. Gerado a partir do código-fonte do plugin; não edite manualmente.

As descrições das ferramentas e dos argumentos são exibidas em inglês porque espelham o schema das ferramentas (o mesmo texto que o agente recebe em tools/list).

Guia

Use statetree.* to build and edit StateTree assets on UE 5.8 with the StateTree plugin enabled (the kit is not loaded otherwise; UE 4.27 and 5.0-5.7 hide every tool). Schemas come from other plugins: enable GameplayStateTree for StateTreeComponentSchema / StateTreeAIComponentSchema.

Addressing

• States: slash paths of state names, case-sensitive (Root/Patrol/Wait), as returned by statetree.list_states. Sibling names are unique (the kit refuses duplicates).
• Nodes (tasks, conditions, evaluators, global tasks): the node GUID or its unique name. Give nodes a name when you add them; statetree.list_nodes / list_global_nodes show both.
• Transitions: statePath + transition index (statetree.list_transitions).
• Node types: /Script/Module.Struct paths, bare struct names (StateTreeDelayTask) or a Blueprint node class path (/Game/AI/BP_MyTask). statetree.list_node_types {kind, asset} lists the types the tree's schema accepts.

Recipe: a working tree

1. statetree.list_schemas, then statetree.create_asset {folder, name, schemaClass}. The factory adds a Root state and compiles.
2. statetree.add_child_state {asset, parentPath:'Root', name:'Idle'} (or add_state for another top-level state/subtree; type = State, Group, Linked, LinkedAsset, Subtree).
3. statetree.add_task {asset, statePath:'Root/Idle', nodeType:'StateTreeDelayTask', name:'IdleWait', properties:[{key:'Duration', value:'2'}]}.
4. statetree.add_transition {asset, statePath:'Root/Idle', trigger:'OnStateCompleted', targetPath:'Root/Patrol'} (without targetPath the link defaults to NextState).
5. Conditions: statetree.add_enter_condition {statePath, nodeType:'StateTreeCompareFloatCondition'} or statetree.add_transition_condition {statePath, transition:0, nodeType}; combine them with statetree.set_condition_operand {node, operand:'Or', indent}.
6. Data flow: statetree.add_parameter {asset, name:'Speed', type:'Float', value:'300'} (root) -> statetree.list_binding_sources {asset, target:'IdleWait'} -> statetree.add_binding {asset, target:'IdleWait', targetPath:'Duration', source:'RootParameters', sourcePath:'Speed'}. Input properties (category Input) must be bound or the compile fails.
7. statetree.compile_asset (fails with E_COMPILE_FAILED and the first errors) or statetree.get_compile_errors for a dry compile that does not touch the asset.
8. statetree.export_asset returns every state, node (with properties), transition, parameter and binding in one reply - use it to review or diff a tree.

Shortcuts: statetree.recipe_patrol {asset, parentPath, name, moveTaskType, waitSeconds} and statetree.recipe_chase {...} build complete sub-behaviors with root parameters (<name>WaitSeconds, <name>Target) already bound. The default moveTaskType (/Script/GameplayStateTreeModule.StateTreeMoveToTask) needs StateTreeAIComponentSchema; with other schemas pass e.g. StateTreeDebugTextTask and bind your own movement later.

Editing

• States: set_state (typed: type, selectionBehavior, tasksCompletion, tag, enabled, linkedSubtree, linkedAsset, requiredEventTag, weight, customTickRate), rename_state (updates links), move_state {newParentPath, index}, duplicate_state {newName} (fresh IDs, copied bindings), remove_state (reports dangling transitions). get/set/list_state_property reach any other scalar reflected field.
• Nodes: get_node (instance data in properties, node settings in nodeProperties), set_node_property {node, property, value, nodeStruct}, rename_node, move_node {index}, remove_node (also drops its bindings).
• Transitions: set_transition changes only the fields you pass (delayDuration:0 disables the delay, enabled:'false' disables it), move_transition {transition, newIndex}, remove_transition.
• Blueprint nodes: statetree.create_node_blueprint {folder, name, kind:'task'|'condition'|'evaluator'} creates the Blueprint class; add variables with the bp kit and pass the asset path as nodeType.
• validate_asset runs the editor fix-ups (link names, parameters, bindings) and structural checks; audit_asset reports the same findings without changing anything.

Gotchas

• Root parameter values cannot be changed or removed from a plugin on 5.8 (the engine keeps that property bag private). add_parameter works for root and state parameters; set_parameter/remove_parameter need statePath (state parameters of Subtree/Linked states).
• Schemas restrict node types and state types; a refused type returns E_INVALID_ARG with the schema name. Single-task schemas store the task in the state's single task slot.
• A node name that matches several nodes (for example after duplicate_state) is ambiguous; use the GUID.
• Blueprint node classes appear in list_node_types only once loaded.
• Utility considerations are listed (kind: consideration) but not authored by this kit.
• Runtime execution (StateTree components in PIE, sending events) is outside this kit.

Ferramentas

Legenda. risco 0 = somente leitura, 1 = operação inofensiva do editor, 2 = altera asset, 3 = apaga/substitui asset, 4 = projeto/config/build, 5 = potencialmente destrutivo (chamadas acima de MaxAutoRisk exigem "_confirm": true). altera = roda numa transação (edit.undo reverte). requer PIE / requer mundo = recusado sem sessão PIE / sem nível aberto. requer plugin = indisponível quando o plugin está desativado. dryRun = aceita o argumento dryRun. smoke = coberto por edit.self_test.

statetree.add_binding (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Binds target node property targetPath to sourcePath of a bindable source; validates both paths and type compatibility. Replaces an existing binding on the same target path.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
target	string	Target node: GUID or unique node name. list_bindings: optional filter.
targetPath	string	Target property path on the node instance data (e.g. Duration).
source	string	Source struct: a GUID or display name from statetree.list_binding_sources (a node name, a context name), or the keyword RootParameters for the tree's root parameters (several structs are named 'Parameters').
sourcePath	string	Source property path (e.g. a root parameter name).

Retorna: tree, bindings, sources, count.

statetree.add_child_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a child state under parentPath.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
parentPath	string	add_child_state: slash-separated parent state path (required). add_state: must stay empty (the state is added at the top level).
name	string	obrigatório. Name of the new state; unique among its siblings, no '/'.
description	string	Optional state description.
type	string	State type: State (default), Group, Linked, LinkedAsset or Subtree. Padrão TEXT("State").
index	integer	Insert position among the siblings; -1 appends. Padrão -1.

Retorna: tree, statePath, createdAsset, notes.

statetree.add_enter_condition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds an enter condition to a state.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path (tasks, enter conditions, transition conditions). Ignored by add_evaluator and add_global_task.
transition	integer	add_transition_condition: index of the transition in the state's list (statetree.list_transitions). Padrão -1.
nodeType	string	obrigatório. Node struct path or name (/Script/StateTreeModule.StateTreeDelayTask, StateTreeDelayTask) or a Blueprint node class path (statetree.list_node_types).
name	string	Optional node name; makes the node addressable by name in the other node tools. Must be unique in the tree.
properties	array of UeaKeyValue	Optional instance data values (property name -> text value) applied after creation.
index	integer	Insert position in the container; -1 appends. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.add_evaluator (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a global evaluator (the schema must allow evaluators).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path (tasks, enter conditions, transition conditions). Ignored by add_evaluator and add_global_task.
transition	integer	add_transition_condition: index of the transition in the state's list (statetree.list_transitions). Padrão -1.
nodeType	string	obrigatório. Node struct path or name (/Script/StateTreeModule.StateTreeDelayTask, StateTreeDelayTask) or a Blueprint node class path (statetree.list_node_types).
name	string	Optional node name; makes the node addressable by name in the other node tools. Must be unique in the tree.
properties	array of UeaKeyValue	Optional instance data values (property name -> text value) applied after creation.
index	integer	Insert position in the container; -1 appends. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.add_global_task (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a global task (runs for the whole tree lifetime).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path (tasks, enter conditions, transition conditions). Ignored by add_evaluator and add_global_task.
transition	integer	add_transition_condition: index of the transition in the state's list (statetree.list_transitions). Padrão -1.
nodeType	string	obrigatório. Node struct path or name (/Script/StateTreeModule.StateTreeDelayTask, StateTreeDelayTask) or a Blueprint node class path (statetree.list_node_types).
name	string	Optional node name; makes the node addressable by name in the other node tools. Must be unique in the tree.
properties	array of UeaKeyValue	Optional instance data values (property name -> text value) applied after creation.
index	integer	Insert position in the container; -1 appends. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.add_parameter (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a typed parameter with an optional initial value: root parameter (UStateTreeEditorData::CreateRootProperties) or, with statePath, a state parameter. Fails with E_CONFLICT when the name exists.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Empty = root (tree) parameters; otherwise the state whose parameters are edited (Subtree/Linked states).
name	string	Parameter name.
type	string	add_parameter: property bag type (Bool, Byte, Int32, Int64, Float, Double, Name, String, Text, Enum, Struct, Object, SoftObject, Class, SoftClass, UInt32, UInt64).
valueType	string	add_parameter: enum/struct/class path for Enum, Struct, Object, SoftObject, Class and SoftClass types.
value	string	Value in text form (add_parameter initial value, set_parameter new value).

Retorna: tree, parameters, count, name.

statetree.add_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a top-level state (a subtree root).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
parentPath	string	add_child_state: slash-separated parent state path (required). add_state: must stay empty (the state is added at the top level).
name	string	obrigatório. Name of the new state; unique among its siblings, no '/'.
description	string	Optional state description.
type	string	State type: State (default), Group, Linked, LinkedAsset or Subtree. Padrão TEXT("State").
index	integer	Insert position among the siblings; -1 appends. Padrão -1.

Retorna: tree, statePath, createdAsset, notes.

statetree.add_task (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a task to a state (the state's single task when the schema allows one task per state).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path (tasks, enter conditions, transition conditions). Ignored by add_evaluator and add_global_task.
transition	integer	add_transition_condition: index of the transition in the state's list (statetree.list_transitions). Padrão -1.
nodeType	string	obrigatório. Node struct path or name (/Script/StateTreeModule.StateTreeDelayTask, StateTreeDelayTask) or a Blueprint node class path (statetree.list_node_types).
name	string	Optional node name; makes the node addressable by name in the other node tools. Must be unique in the tree.
properties	array of UeaKeyValue	Optional instance data values (property name -> text value) applied after creation.
index	integer	Insert position in the container; -1 appends. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.add_transition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a transition (UStateTreeState::AddTransition) and applies the optional priority, event, delay and enabled settings.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path. list_transitions: empty lists every state's transitions.
transition	integer	Transition index in the state's list (set/move/remove). Padrão -1.
trigger	string	Trigger: OnStateCompleted, OnStateSucceeded, OnStateFailed, OnTick, OnEvent, OnDelegate. add: default OnStateCompleted; set: empty keeps it.
type	string	Link type: GotoState, NextState, NextSelectableState, Succeeded, Failed, None. add: default GotoState when targetPath is set, else NextState; set: empty keeps it.
targetPath	string	Target state path for GotoState; empty keeps it on set.
eventTag	string	Required event tag (OnEvent trigger); empty keeps it, 'None' clears it.
priority	string	Priority: Low, Normal, Medium, High, Critical; empty keeps it (add: Normal).
delayDuration	number	Delay in seconds; 0 disables the delay, negative keeps it. Padrão -1.f.
delayRandomVariance	number	Random delay variance in seconds; negative keeps it. Padrão -1.f.
enabled	string	true/false enables/disables the transition; empty keeps it.
newIndex	integer	move_transition: new index. Padrão -1.

Retorna: tree, transitions, count, transitionId.

statetree.add_transition_condition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Adds a condition to a transition (statePath + transition index).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path (tasks, enter conditions, transition conditions). Ignored by add_evaluator and add_global_task.
transition	integer	add_transition_condition: index of the transition in the state's list (statetree.list_transitions). Padrão -1.
nodeType	string	obrigatório. Node struct path or name (/Script/StateTreeModule.StateTreeDelayTask, StateTreeDelayTask) or a Blueprint node class path (statetree.list_node_types).
name	string	Optional node name; makes the node addressable by name in the other node tools. Must be unique in the tree.
properties	array of UeaKeyValue	Optional instance data values (property name -> text value) applied after creation.
index	integer	Insert position in the container; -1 appends. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.audit_asset (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Read-only audit: compile status plus the structural findings of validate_asset, without fix-ups.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, compiled, errorCount, warningCount, messages.

statetree.compile_asset (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Compiles the tree (UStateTreeEditingSubsystem::CompileStateTree) and returns the compiler messages; fails with E_COMPILE_FAILED when the compiler rejects the editor data.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, compiled, errorCount, warningCount, messages.

statetree.create_asset (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Creates a StateTree asset with the given schema; the factory adds a top-level state named Root and compiles it.

Argumento	Tipo	Descrição
folder	string	obrigatório. Destination folder below /Game.
name	string	obrigatório. Bare asset name.
schemaClass	string	obrigatório. Concrete UStateTreeSchema class path or name (see statetree.list_schemas), e.g. /Script/GameplayStateTreeModule.StateTreeComponentSchema (GameplayStateTree plugin).

Retorna: tree, statePath, createdAsset, notes.

statetree.create_node_blueprint (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Creates a Blueprint node class (task, condition or evaluator) usable as nodeType in the add_* node tools.

Argumento	Tipo	Descrição
folder	string	obrigatório. Destination folder below /Game.
name	string	obrigatório. Bare Blueprint asset name.
kind	string	obrigatório. Node kind: task, condition or evaluator (parent UStateTreeTaskBlueprintBase / ConditionBlueprintBase / EvaluatorBlueprintBase).

Retorna: tree, statePath, createdAsset, notes.

statetree.duplicate_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Duplicates a state (with children, nodes and transitions, fresh IDs) next to the original under newName.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated state path.
newName	string	obrigatório. New name (unique among siblings, no '/'). duplicate_state: name of the copy.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.export_asset (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Exports the whole editor data as typed JSON: states, nodes with properties, transitions, parameters and bindings.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, states, nodes, transitions, parameters, bindings.

statetree.get_asset (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Returns the summary of one StateTree asset (schema, compile status, counts, root parameter GUID).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, statePath, createdAsset, notes.

statetree.get_capabilities (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists what the kit can author on this engine and the blocked editor symbols.

Argumento	Tipo	Descrição
folder	string	Content folder to inspect. Padrão TEXT("/Game").
recursive	boolean	Include assets below Folder. Padrão true.
limit	integer	Maximum returned assets, from 1 to 1000. Padrão 100.

Retorna: tree, statePath, createdAsset, notes.

statetree.get_compile_errors (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Dry compile: compiles a transient duplicate and returns the messages without touching the asset.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, compiled, errorCount, warningCount, messages.

statetree.get_node (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Returns one node with its node-struct and instance-data properties as text.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Node GUID or unique node name.

Retorna: tree, nodes, count, notes.

statetree.get_state (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Returns one state with its nodes (tasks, enter conditions, considerations), transitions and state parameters.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Slash-separated state path such as Root/Patrol (names as returned by statetree.list_states). Empty lists every state where the tool allows it.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.get_state_property (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Reads one reflected state property as text.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated state path.
property	string	obrigatório. Reflected UStateTreeState property name (see statetree.list_state_properties).
value	string	Text-export value (set_state_property only).

Retorna: values, count, notes.

statetree.list_assets (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists StateTree assets under a folder with their summaries.

Argumento	Tipo	Descrição
folder	string	Content folder to inspect. Padrão TEXT("/Game").
recursive	boolean	Include assets below Folder. Padrão true.
limit	integer	Maximum returned assets, from 1 to 1000. Padrão 100.

Retorna: trees, count.

statetree.list_binding_sources (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists the structs a target node can bind from (context, root parameters, evaluators, global tasks, parent state nodes) with their properties.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
target	string	Target node: GUID or unique node name. list_bindings: optional filter.
targetPath	string	Target property path on the node instance data (e.g. Duration).
source	string	Source struct: a GUID or display name from statetree.list_binding_sources (a node name, a context name), or the keyword RootParameters for the tree's root parameters (several structs are named 'Parameters').
sourcePath	string	Source property path (e.g. a root parameter name).

Retorna: tree, bindings, sources, count.

statetree.list_bindings (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists editor property bindings; with target, only the bindings whose target is that node.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
target	string	Target node: GUID or unique node name. list_bindings: optional filter.
targetPath	string	Target property path on the node instance data (e.g. Duration).
source	string	Source struct: a GUID or display name from statetree.list_binding_sources (a node name, a context name), or the keyword RootParameters for the tree's root parameters (several structs are named 'Parameters').
sourcePath	string	Source property path (e.g. a root parameter name).

Retorna: tree, bindings, sources, count.

statetree.list_global_nodes (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists global evaluators and global tasks.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, nodes, count, notes.

statetree.list_node_types (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists node types (task/condition/evaluator structs and Blueprint classes); with asset, only those its schema allows.

Argumento	Tipo	Descrição
kind	string	Node kind to list: task, condition, evaluator, or empty for all three.
asset	string	Optional StateTree asset: when set, only types its schema allows are returned.
filter	string	Optional case-insensitive substring filter on the type path.
limit	integer	Maximum returned types, from 1 to 1000. Padrão 300.

Retorna: types, count.

statetree.list_nodes (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists the nodes of one state (tasks, enter conditions, considerations, transition conditions) or of every state.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	State path; empty lists the nodes of every state (global nodes: statetree.list_global_nodes).

Retorna: tree, nodes, count, notes.

statetree.list_parameters (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists parameters: root parameters and every state's parameters, or only statePath's when given.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Empty = root (tree) parameters; otherwise the state whose parameters are edited (Subtree/Linked states).
name	string	Parameter name.
type	string	add_parameter: property bag type (Bool, Byte, Int32, Int64, Float, Double, Name, String, Text, Enum, Struct, Object, SoftObject, Class, SoftClass, UInt32, UInt64).
valueType	string	add_parameter: enum/struct/class path for Enum, Struct, Object, SoftObject, Class and SoftClass types.
value	string	Value in text form (add_parameter initial value, set_parameter new value).

Retorna: tree, parameters, count, name.

statetree.list_schemas (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists concrete, loaded UStateTreeSchema classes usable as statetree.create_asset schemaClass.

Argumento	Tipo	Descrição
folder	string	Content folder to inspect. Padrão TEXT("/Game").
recursive	boolean	Include assets below Folder. Padrão true.
limit	integer	Maximum returned assets, from 1 to 1000. Padrão 100.

Retorna: values, count, notes.

statetree.list_state_properties (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists the reflected UStateTreeState properties (name = C++ type) usable with get/set_state_property.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Slash-separated state path such as Root/Patrol (names as returned by statetree.list_states). Empty lists every state where the tool allows it.

Retorna: values, count, notes.

statetree.list_states (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists every state (hierarchy order) with paths used by the other state tools.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.list_transitions (risco 0, UE 5.8+, requer plugin StateTree, smoke)

Lists the transitions of a state (or of every state when statePath is empty) with trigger, link, priority, delay and condition count.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path. list_transitions: empty lists every state's transitions.
transition	integer	Transition index in the state's list (set/move/remove). Padrão -1.
trigger	string	Trigger: OnStateCompleted, OnStateSucceeded, OnStateFailed, OnTick, OnEvent, OnDelegate. add: default OnStateCompleted; set: empty keeps it.
type	string	Link type: GotoState, NextState, NextSelectableState, Succeeded, Failed, None. add: default GotoState when targetPath is set, else NextState; set: empty keeps it.
targetPath	string	Target state path for GotoState; empty keeps it on set.
eventTag	string	Required event tag (OnEvent trigger); empty keeps it, 'None' clears it.
priority	string	Priority: Low, Normal, Medium, High, Critical; empty keeps it (add: Normal).
delayDuration	number	Delay in seconds; 0 disables the delay, negative keeps it. Padrão -1.f.
delayRandomVariance	number	Random delay variance in seconds; negative keeps it. Padrão -1.f.
enabled	string	true/false enables/disables the transition; empty keeps it.
newIndex	integer	move_transition: new index. Padrão -1.

Retorna: tree, transitions, count, transitionId.

statetree.move_node (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Moves a node to another index inside its container (task order, condition order...).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Node GUID or unique node name.
index	integer	obrigatório. New index inside its container (0-based).

Retorna: tree, nodes, count, notes.

statetree.move_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Moves a state under another parent (or to the top level) at an index.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated path of the state to move.
newParentPath	string	New parent state path; empty moves the state to the top level.
index	integer	Position among the new siblings; -1 appends. Padrão -1.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.move_transition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Moves a transition to newIndex (transitions are evaluated in order).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path. list_transitions: empty lists every state's transitions.
transition	integer	Transition index in the state's list (set/move/remove). Padrão -1.
trigger	string	Trigger: OnStateCompleted, OnStateSucceeded, OnStateFailed, OnTick, OnEvent, OnDelegate. add: default OnStateCompleted; set: empty keeps it.
type	string	Link type: GotoState, NextState, NextSelectableState, Succeeded, Failed, None. add: default GotoState when targetPath is set, else NextState; set: empty keeps it.
targetPath	string	Target state path for GotoState; empty keeps it on set.
eventTag	string	Required event tag (OnEvent trigger); empty keeps it, 'None' clears it.
priority	string	Priority: Low, Normal, Medium, High, Critical; empty keeps it (add: Normal).
delayDuration	number	Delay in seconds; 0 disables the delay, negative keeps it. Padrão -1.f.
delayRandomVariance	number	Random delay variance in seconds; negative keeps it. Padrão -1.f.
enabled	string	true/false enables/disables the transition; empty keeps it.
newIndex	integer	move_transition: new index. Padrão -1.

Retorna: tree, transitions, count, transitionId.

statetree.recipe_chase (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Builds a chase state: gated by an ObjectIsValid enter condition bound to a new root parameter Target (Actor), children Approach (moveTaskType; its TargetActor input is bound to the same parameter when present) and Attack (Delay waitSeconds); failure of the chase state fails its parent (Failed transition).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
parentPath	string	Parent state path that receives the recipe state; empty adds it at the top level.
name	string	obrigatório. Name of the recipe state (unique among its siblings).
moveTaskType	string	Task struct used for the movement step. Default /Script/GameplayStateTreeModule.StateTreeMoveToTask needs an AI schema (StateTreeAIComponentSchema); pass e.g. StateTreeDebugTextTask for other schemas. Padrão TEXT("/Script/GameplayStateTreeModule.StateTreeMoveToTask").
waitSeconds	number	Seconds of the wait/attack Delay task. Padrão 2.f.

Retorna: tree, statePath, createdAsset, notes.

statetree.recipe_patrol (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Builds a patrol state: with children MoveToWaypoint (task Move of moveTaskType) and Wait (Delay task Wait) looping via NextState/GotoState; Wait.Duration is bound to a new root parameter WaitSeconds = waitSeconds.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
parentPath	string	Parent state path that receives the recipe state; empty adds it at the top level.
name	string	obrigatório. Name of the recipe state (unique among its siblings).
moveTaskType	string	Task struct used for the movement step. Default /Script/GameplayStateTreeModule.StateTreeMoveToTask needs an AI schema (StateTreeAIComponentSchema); pass e.g. StateTreeDebugTextTask for other schemas. Padrão TEXT("/Script/GameplayStateTreeModule.StateTreeMoveToTask").
waitSeconds	number	Seconds of the wait/attack Delay task. Padrão 2.f.

Retorna: tree, statePath, createdAsset, notes.

statetree.remove_binding (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Removes the binding(s) of target node property targetPath.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
target	string	Target node: GUID or unique node name. list_bindings: optional filter.
targetPath	string	Target property path on the node instance data (e.g. Duration).
source	string	Source struct: a GUID or display name from statetree.list_binding_sources (a node name, a context name), or the keyword RootParameters for the tree's root parameters (several structs are named 'Parameters').
sourcePath	string	Source property path (e.g. a root parameter name).

Retorna: tree, bindings, sources, count.

statetree.remove_node (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Removes a node (any kind) and the bindings that targeted it.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Node GUID or unique node name.

Retorna: tree, nodes, count, notes.

statetree.remove_parameter (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Removes a state parameter. Root parameters cannot be removed from a plugin on 5.8 (see get_capabilities).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Empty = root (tree) parameters; otherwise the state whose parameters are edited (Subtree/Linked states).
name	string	Parameter name.
type	string	add_parameter: property bag type (Bool, Byte, Int32, Int64, Float, Double, Name, String, Text, Enum, Struct, Object, SoftObject, Class, SoftClass, UInt32, UInt64).
valueType	string	add_parameter: enum/struct/class path for Enum, Struct, Object, SoftObject, Class and SoftClass types.
value	string	Value in text form (add_parameter initial value, set_parameter new value).

Retorna: tree, parameters, count, name.

statetree.remove_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Removes a state with its children; bindings that targeted its nodes are removed and transitions pointing at it are reported.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Slash-separated state path such as Root/Patrol (names as returned by statetree.list_states). Empty lists every state where the tool allows it.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.remove_transition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Removes a transition and its conditions.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path. list_transitions: empty lists every state's transitions.
transition	integer	Transition index in the state's list (set/move/remove). Padrão -1.
trigger	string	Trigger: OnStateCompleted, OnStateSucceeded, OnStateFailed, OnTick, OnEvent, OnDelegate. add: default OnStateCompleted; set: empty keeps it.
type	string	Link type: GotoState, NextState, NextSelectableState, Succeeded, Failed, None. add: default GotoState when targetPath is set, else NextState; set: empty keeps it.
targetPath	string	Target state path for GotoState; empty keeps it on set.
eventTag	string	Required event tag (OnEvent trigger); empty keeps it, 'None' clears it.
priority	string	Priority: Low, Normal, Medium, High, Critical; empty keeps it (add: Normal).
delayDuration	number	Delay in seconds; 0 disables the delay, negative keeps it. Padrão -1.f.
delayRandomVariance	number	Random delay variance in seconds; negative keeps it. Padrão -1.f.
enabled	string	true/false enables/disables the transition; empty keeps it.
newIndex	integer	move_transition: new index. Padrão -1.

Retorna: tree, transitions, count, transitionId.

statetree.rename_node (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Renames a node (FStateTreeEditorNode::SetNodeName).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Node GUID or unique node name.
newName	string	obrigatório. New node name (unique in the tree).

Retorna: tree, nodes, count, notes.

statetree.rename_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Renames a state and updates the transition links that point to it.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated state path.
newName	string	obrigatório. New name (unique among siblings, no '/'). duplicate_state: name of the copy.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.set_condition_operand (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Sets a condition's expression operand (And/Or) and indent.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Condition node GUID or unique name.
operand	string	Operand joining this condition with the previous one: And or Or (empty keeps it).
indent	integer	Expression indent (0-4, parentheses depth); -1 keeps it. Padrão -1.

Retorna: tree, nodes, count, notes.

statetree.set_node_property (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Sets a node instance-data property (or node-struct property with nodeStruct=true) from text.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
node	string	obrigatório. Node GUID or unique node name.
property	string	obrigatório. Property name on the instance data (default) or on the node struct (nodeStruct=true), e.g. Duration or bTaskEnabled.
value	string	Text value (ImportText format: 2.5, true, (X=1,Y=2,Z=3), /Game/Path.Asset).
nodeStruct	boolean	Edit the node struct (e.g. bTaskEnabled, bConsideredForCompletion) instead of its instance data. Padrão false.

Retorna: tree, nodes, count, notes.

statetree.set_parameter (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Sets the value of a state parameter from text. Root parameter values are not writable from a plugin on 5.8 (see get_capabilities).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Empty = root (tree) parameters; otherwise the state whose parameters are edited (Subtree/Linked states).
name	string	Parameter name.
type	string	add_parameter: property bag type (Bool, Byte, Int32, Int64, Float, Double, Name, String, Text, Enum, Struct, Object, SoftObject, Class, SoftClass, UInt32, UInt64).
valueType	string	add_parameter: enum/struct/class path for Enum, Struct, Object, SoftObject, Class and SoftClass types.
value	string	Value in text form (add_parameter initial value, set_parameter new value).

Retorna: tree, parameters, count, name.

statetree.set_state (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Sets typed state settings (type, selection behavior, task completion, tag, enabled, linked subtree/asset, required event, weight, tick rate).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated state path.
description	string	New description; empty keeps it (use set_state_property Description to clear).
type	string	State type: State, Group, Linked, LinkedAsset, Subtree; empty keeps it.
selectionBehavior	string	Child selection: None, TryEnterState, TrySelectChildrenInOrder, TrySelectChildrenAtRandom, TrySelectChildrenWithHighestUtility, TrySelectChildrenAtRandomWeightedByUtility, TryFollowTransitions; empty keeps it.
tasksCompletion	string	Task completion: Any or All; empty keeps it.
tag	string	Gameplay tag (must exist); empty keeps it, 'None' clears it.
enabled	string	true/false enables/disables the state; empty keeps it.
linkedSubtree	string	Linked states: path of the Subtree state to run; empty keeps it.
linkedAsset	string	LinkedAsset states: StateTree asset to run; empty keeps it.
requiredEventTag	string	Required event tag to enter; empty keeps it, 'None' clears it.
weight	number	Utility weight; negative keeps it. Padrão -1.f.
customTickRate	number	Custom tick rate in seconds; 0 disables it, negative keeps it. Padrão -1.f.

Retorna: tree, states, nodes, transitions, parameters, count, notes.

statetree.set_state_property (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Writes one reflected state property from text (scalar settings such as Description, bEnabled, Weight, bCheckPrerequisitesWhenActivatingChildDirectly). Node arrays, transitions, children and IDs are refused: use the typed tools.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	obrigatório. Slash-separated state path.
property	string	obrigatório. Reflected UStateTreeState property name (see statetree.list_state_properties).
value	string	Text-export value (set_state_property only).

Retorna: values, count, notes.

statetree.set_transition (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Edits a transition in place; only the fields that are set change.

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path or unique asset name.
statePath	string	Owning state path. list_transitions: empty lists every state's transitions.
transition	integer	Transition index in the state's list (set/move/remove). Padrão -1.
trigger	string	Trigger: OnStateCompleted, OnStateSucceeded, OnStateFailed, OnTick, OnEvent, OnDelegate. add: default OnStateCompleted; set: empty keeps it.
type	string	Link type: GotoState, NextState, NextSelectableState, Succeeded, Failed, None. add: default GotoState when targetPath is set, else NextState; set: empty keeps it.
targetPath	string	Target state path for GotoState; empty keeps it on set.
eventTag	string	Required event tag (OnEvent trigger); empty keeps it, 'None' clears it.
priority	string	Priority: Low, Normal, Medium, High, Critical; empty keeps it (add: Normal).
delayDuration	number	Delay in seconds; 0 disables the delay, negative keeps it. Padrão -1.f.
delayRandomVariance	number	Random delay variance in seconds; negative keeps it. Padrão -1.f.
enabled	string	true/false enables/disables the transition; empty keeps it.
newIndex	integer	move_transition: new index. Padrão -1.

Retorna: tree, transitions, count, transitionId.

statetree.validate_asset (risco 2, altera, UE 5.8+, requer plugin StateTree, smoke)

Runs the editor validation fix-ups (state links, parameters, bindings) and reports structural problems (missing transition targets, empty leaf states, duplicate sibling names).

Argumento	Tipo	Descrição
asset	string	obrigatório. StateTree asset object path (/Game/AI/ST_Enemy) or unique asset name.

Retorna: tree, compiled, errorCount, warningCount, messages.