Kit ai

257 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

The ai kit authors Blackboards, Behavior Trees, EQS queries, AI Perception, State Trees and Smart Objects, and drives AI agents during PIE. Asset tools take a content path (/Game/AI/EQ_Cover) or a unique asset name; actor tools take an actor label, name, or class:<Class> for the only actor of a class. Distances are centimetres, angles degrees, ages seconds.

Prefix	Area	World
ai.create_test_setup, ai.list_assets, ai.list_*_classes	shared fixtures, inventory	assets
ai.bb_*	Blackboard assets and keys	assets
ai.bt_*	Behavior Tree runtime hierarchy	assets
ai.eqs_*	EQS queries: options, generators, tests, contexts, recipes, export/import, audit, run	assets; ai.eqs_run editor or PIE world
ai.perception_*, ai.stimuli_add/get/remove_source, ai.spawn_test_actor, ai.{set,get}_pawn_ai_settings	perception components, senses, presets, stimuli sources, pawn AI settings	editor world (PIE world while PIE runs)
ai.spawn_ai, controller tools, ai.runtime_get_perception, ai.report_*, ai.stimuli_{register,unregister}_sense, teams	AI agents at run time	PIE only
ai.so_*	Smart Objects (UE 5.0+, SmartObjects plugin)	assets / PIE

State Tree authoring moved to the separate statetree kit (UE 5.8+, StateTree plugin) — see Docs/guides/statetree.md. ai.bt_* still owns Behavior Trees and ai.so_* still owns Smart Objects.

Start here

• ai.create_test_setup {folder} creates (or reuses) BB_AiSmoke (keys TargetActor, PatrolIndex, HomeLocation, IsAlert), BT_AiSmoke (RootSelector linked to the Blackboard) and EQ_AiSmoke (grid around the querier scored by distance): a complete, runnable set to experiment with.
• ai.list_assets {folder} lists Blackboards, Behavior Trees and EQS queries.
• Class pickers: ai.list_ai_controller_classes, ai.list_bt_{task,decorator,service}_classes, ai.eqs_list_{generator,test,context}_classes, ai.perception_list_sense_classes.

Blackboards and Behavior Trees

• Node references: node/parent accept a node ID (nodes[].id), a path (root/1/0, root/1@d0 decorator, root@s0 service) or the node name; empty parent = root. Every edit returns the rebuilt hierarchy plus graphSync.
• Editor graph: 5.3+ rebuilds the graph after each edit (rebuilt); 4.27–5.2 clear it (cleared) and the editor regenerates it on open — the stock editor then picks the first loaded blackboard, so run ai.bt_set_blackboard again. ai.bt_arrange (5.3+) lays out the graph.
• Recipe, enemy AI in 6 calls: ai.bb_create → ai.bb_add_keys → ai.bt_create {blackboard} → ai.bt_chase_attack_recipe {targetKey:'TargetActor', index:0} → ai.bt_investigate_recipe {locationKey, conditionKey:'IsAlert'} → ai.bt_patrol_recipe {locationKey:'HomeLocation'}, then ai.bt_validate_runtime_hierarchy.
• Conditions and flow: typed decorators take abortMode (none/self/lowerPriority/both; sequences cannot abort lower priority) and inverse. Combine with ai.bt_set_decorator_logic {expression:'and(A,not(B))'}, which must use every decorator of the child exactly once; adding or removing a decorator clears the logic.
• Keys: ai.bt_set_blackboard_selector {property:'BlackboardKey', key} rejects key types the node does not accept; ai.bb_find_references shows which nodes use a key before a rename/remove.
• Blackboard defaults: ai.bb_set_<type> needs 5.4+ (enum/class/object 5.5+); use ai.bb_add_key/ai.bb_set_key on older engines. ai.bb_export_schema → ai.bb_import {mode:'merge'|'replace'} copies a schema; ai.bb_diff compares two blackboards.
• Round trip: ai.bt_export → ai.bt_import (replaces the whole tree; the node id is the node name).

EQS

EQS tools edit the runtime UEnvQuery containers (options -> generator + tests). The EQS editor graph is not regenerated: close the asset editor while editing and reopen it afterwards. Every edit returns structure (options with generator class, item type, contexts, and tests with purpose, filter type, scoring equation and factor) plus option / test indices, so a second ai.eqs_get is rarely needed.

Build a query in 3 calls (recipes)

Recipe	Result
ai.eqs_cover_recipe {query, radius, spaceBetween, targetContext?}	grid around the querier; test 0 Trace filter "hidden from target"; test 1 Distance score (near querier)
ai.eqs_nearest_reachable_recipe {query, radius, spaceBetween}	grid; test 0 Pathfinding PathExist filter; test 1 Distance score (needs a navmesh when run)
ai.eqs_points_around_target_recipe {query, radius, numberOfPoints, targetContext?}	circle around the target; test 0 Distance score (near querier)

targetContext is a UEnvQueryContext class (Blueprint contexts included); empty uses EnvQueryContext_Querier. Create a Blueprint context for "the player" or "the current enemy" with ai.eqs_create_context_blueprint {folder, name} and implement its Provide* function with the bp kit; the reply's generatedClass is what you pass as a context.

Edit by hand

1. ai.eqs_create {query:'/Game/AI/EQ_Flank'}.
2. ai.eqs_add_option {query, class:'/Script/AIModule.EnvQueryGenerator_SimpleGrid'} (options run in order until one yields items; reorder with ai.eqs_move_option, copy with ai.eqs_duplicate_option, swap the generator with ai.eqs_replace_generator).
3. Configure the generator with a typed tool: ai.eqs_configure_grid, _circle, _donut, _cone, _actors_of_class, _pathing_grid, _current_location; projection of point generators with ai.eqs_set_projection {traceMode, projectDown, projectUp}.
4. ai.eqs_add_test {option, class} then a typed tool: ai.eqs_configure_distance_test, _trace_test, _dot_test, _pathfinding_test, _overlap_test, _project_test.
5. Purpose and scoring: ai.eqs_set_test_scoring {purpose, scoringEquation, scoringFactor, clampMinType, scoreClampMin...}; filtering: ai.eqs_set_test_filter {filterType, min, max} (float tests: Minimum/Maximum/Range) or {filterType:'Match', match} (bool tests such as Trace, Overlap, Pathfinding PathExist). A mismatched filter type is refused with the right choice.
6. Contexts anywhere: ai.eqs_set_context {option, test (-1 = generator), property, context} (GenerateAround, CircleCenter, DistanceTo, Context, LineA.LineFrom...).
7. Anything else: ai.eqs_set_generator / ai.eqs_set_test {property, value} in engine text form; dotted paths reach data-provider values (GridSize.DefaultValue, ScoringFactor.DefaultValue). ai.eqs_get_generator / ai.eqs_get_test list the editable properties.

Enum-valued arguments are validated against the engine enum; the error lists the valid names. Engine differences surface there: traceMode is Geometry on 4.27 and GeometryByChannel/GeometryByProfile on 5.x.

Run, check, move

• ai.eqs_run {query, querier, runMode, maxItems} runs synchronously in the editor world (the PIE world while PIE runs) and returns status, optionIndex, itemType, totalItems and the scored items (best first: score, location, actor label for actor items). querier is any actor; class:WorldSettings is a neutral querier at the origin. A Failed status with zero items is a result, not an error (e.g. all points dropped by navmesh projection when the level has no navmesh: set ai.eqs_set_projection {traceMode:'None'} to test without one).
• ai.eqs_validate (one query) and ai.eqs_audit {folder} (every query) report options without a generator or tests, zero scoring factors, tests that do not support the generator item type and empty contexts.
• ai.eqs_export {query} returns options as generator/test classes plus non-default properties; ai.eqs_import {query, options, replace} rebuilds that format (new path, or replace:true on an existing query). Use it to copy a query between projects or to template variations.
• ai.eqs_duplicate {query, newPath}, ai.eqs_delete (not undoable).
• UE 5.8+: ai.eqs_set_strip_from_client_builds {strip} for server-only queries.

Perception

Perception tools work on level actors in the editor world, or on the PIE world while PIE runs. An AAIController only uses its own perception component: put the component on the controller (Blueprint or ai.perception_add_component on a controller actor), not on the pawn; ai.perception_audit flags components on other actors.

1. ai.perception_add_component {actor} (returns the existing one with created:false; on an AIController it becomes the controller's perception component). For experiments ai.spawn_test_actor {label, perception:true, stimuliSource:true} spawns a tagged pawn.
2. Apply a preset or configure senses:
   • ai.perception_guard_preset (sight 2000/2500, 60 degrees, hearing 1500, damage; sight dominant)
   • ai.perception_sniper_preset (sight 6000/6500, 15 degrees, long memory, damage)
   • ai.perception_animal_preset (hearing 3000 dominant, wide short sight for every affiliation, touch)
   • typed: ai.perception_configure_sight {sightRadius, loseSightRadius, peripheralVisionAngle, maxAge, autoSuccessRange, affiliation:{enemies,neutrals,friendlies}, dominant}, ai.perception_configure_hearing {hearingRange, maxAge, affiliation, dominant}
   • per sense: ai.perception_set_max_age, ai.perception_set_affiliation, ai.perception_set_starts_enabled, generic ai.perception_set_sense {sense, property, value}. Presets and configure tools create the sense when missing and update it otherwise.
3. ai.perception_set_dominant {sense:'/Script/AIModule.AISense_Sight'}; ai.perception_remove_sense {sense:'AISenseConfig_Touch'}; inspect with ai.perception_get (typed senseConfigs with every setting) or ai.perception_get_sense.
4. Make targets perceivable: ai.stimuli_add_source {actor, senses:['AISense_Sight','AISense_Hearing'], autoRegister}; ai.stimuli_get_source; ai.stimuli_remove_source. Pawns are registered for sight automatically by the engine's default settings; other actors need a stimuli source.
5. Pawn possession settings: ai.set_pawn_ai_settings {actor, controllerClass, autoPossessAi} (Disabled, PlacedInWorld, Spawned, PlacedInWorldOrSpawned), ai.get_pawn_ai_settings.

sense arguments name the config class (AISenseConfig_Sight) for config tools and the implementation class (AISense_Sight) for dominance, enablement and stimuli tools. Affiliation uses team ids: actors without a team are neutral (see ai.set_team_id).

Smart Objects

ai.so_* needs the SmartObjects plugin. Definitions: so_create_definition → so_add_slot {name, offset, rotation, activityTags} → so_add_behavior_definition {slot, behaviorClass} (classes from so_list_behavior_definition_classes; they come from GameplayBehaviorSmartObjects, GameplayInteractions or MassGameplay) → so_validate. Edit with so_set_slot (only the fields you flag change), so_set_definition_tags, so_set_slot_property; copy with so_duplicate_definition. Slots cannot be removed from a plugin: disable them with so_set_slot {enabled:'false'}. Definition-level default behaviors are read-only. Level: so_attach_definition {actor, definition} (or spawnNew:true) adds a Smart Object component in the editor world; so_list_world_objects shows registration and slot states. PIE: so_spawn_runtime_object (optionally with a transient definition) → so_find_slots {location, radius, activityTags, behaviorClass} → so_claim_slot {actor, slot} returns claim '<actor>#<slot>' → so_use_slot {claim, behaviorClass} → so_release_slot. so_list_claims shows this session's claims; claims die with the PIE session. Gates: definition tools 5.0 (typed slot fields 5.3), world/PIE tools 5.6.

See Docs/guides/statetree.md for State Tree authoring (statetree.*, separate kit, UE 5.8+).

PIE runtime

Every tool here requires PIE (play.start). Controllers accept the actor label, name or class:<Class>; replies carry state, a typed snapshot (pawn, brain running/paused, current and root tree, active node, Blackboard, move status, focus, perception senses).

1. ai.spawn_ai {label, controllerLabel, location, testTree, perception, stimuliSource, behaviorTree?} spawns a Character (or pawnClass) possessed by an AIController (or controllerClass). testTree builds /Engine/Transient.BT_AiSmokeRuntime (Selector + Wait, keys TargetActor/PatrolIndex/HomeLocation/IsAlert); perception gives the controller sight, hearing and damage (every affiliation); stimuliSource registers the pawn for sight and hearing. The reply returns pawn, pawnLabel, controller, controllerLabel. Remove it with ai.despawn_ai.
2. Brain: ai.run_tree {controller, target:'<tree>'}, ai.pause_tree, ai.resume_tree, ai.restart_tree (restarts the running logic from the root), ai.stop_tree, ai.get_tree_state.
3. Blackboard: ai.get_blackboard_values (every key with type and value); ai.set_blackboard_value {key, type, value | vector} with type bool, int, float, string, name, vector, rotator (vector = pitch/yaw/roll), enum (numeric), object (actor label) or class; the key type must match. ai.clear_blackboard_value.
4. Movement and focus: ai.move_to {location | target, acceptanceRadius} returns requestResult (Failed without a navmesh) and moveRequestId; ai.get_move_status, ai.stop_movement; ai.set_focus {target, priority}, ai.set_focal_point, ai.clear_focus, ai.get_focus.
5. Possession: ai.unpossess, ai.possess {target} (refused when another controller owns the pawn).
6. Perception at run time: ai.runtime_get_perception {actor} returns every perceived actor with hostile/friendly flags (friendly on UE 5.4+) and its stimuli (sense, age, strength, locations, tag, sensed, expired). Drive it with ai.report_noise {location, loudness, instigator, maxRange, tag}, ai.report_damage {damaged, instigator, amount} and, on UE 5.1+, ai.report_touch {receiver, other}; live stimuli registration with ai.stimuli_register_sense / ai.stimuli_unregister_sense.
7. Teams: ai.set_team_id {controller, teamId} (255 = no team) and ai.get_team_attitude {actor, target} (Friendly/Neutral/Hostile as perception sees it).
8. Audits: ai.get_controller, ai.audit_controllers (no pawn, no brain, logic stopped, tree without Blackboard, pawns that expect an AI controller but have none).

Gotchas

• EQS and Behavior Tree tools edit runtime data; their editor graphs are not regenerated. Reopen the asset editor only after you are done.
• ai.eqs_run uses the query as saved in memory; each EQS edit invalidates the EQS manager's cached instance. On UE 4.27 the engine resets only the editor world cache, so re-running an edited query inside the same PIE session may use the old copy: restart PIE.
• Perception edits on a running PIE component are applied through ConfigureSense and a listener update; removing the dominant sense leaves it dominant (a warning says so).
• ai.perception_remove_component and ai.stimuli_remove_source only remove components added to the actor instance; components from the actor class must be removed in its Blueprint.
• ai.perception_is_sense_enabled needs UE 5.0+, ai.report_touch UE 5.1+, ai.eqs_set_strip_from_client_builds UE 5.8.
• Smart Object tools are hidden unless the SmartObjects plugin is enabled; State Tree tools unless the StateTree plugin is enabled (UE 5.1+).

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.

ai.audit_controllers (risco 0, requer PIE, smoke)

Snapshots of every AI controller plus findings (no pawn, no brain, logic stopped, tree without Blackboard, pawn without controller).

Sem argumentos.

Retorna: controllers, count, issues, message.

ai.bb_add_key (risco 2, altera, smoke)

Adds a local key of any type (generic form; see the typed ai.bb_set_ tools for defaults).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name.
type	string	obrigatório. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClass	string	Base class filter for class and object keys.
enum	string	Enum asset path for enum keys, or native enum name for nativeEnum keys.
description	string	Optional editor description.
category	string	Optional editor category.
instanceSynced	boolean	Synchronize this key between compatible blackboard instances. Padrão false.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_add_keys (risco 2, altera, smoke)

Adds several keys in one call.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
keys	array of UeaAiBbKeySpec	obrigatório. Keys to add.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_audit_filters (risco 0, smoke)

Reports object/class keys without a meaningful base class filter.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_create (risco 2, altera, smoke)

Creates a blackboard asset (optional parent). Returns the key schema.

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game.
name	string	obrigatório. Bare asset name.
parent	string	Optional parent blackboard asset.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_delete (risco 3, altera, destrutivo, smoke)

Deletes a blackboard asset (refused while referenced).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_diff (risco 0, smoke)

Compares two blackboard schemas key by key.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Left blackboard.
other	string	obrigatório. Right blackboard.
includeInherited	boolean	Compare the flattened schema including parent keys (false compares local keys only). Padrão true.

Retorna: asset, other, entries, count, identical, message.

ai.bb_duplicate (risco 2, altera, smoke)

Duplicates a blackboard asset.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
folder	string	Destination folder; source folder when empty.
name	string	obrigatório. New asset name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_export_schema (risco 0, smoke)

Exports the key schema (keys with type, filters, defaults) in the form accepted by ai.bb_import and ai.bb_add_keys.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_find_key_usages (risco 0, smoke)

Lists behavior trees under /Game whose blackboard is this asset.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_find_references (risco 0, smoke)

Finds behavior tree nodes whose key selectors reference keys of this blackboard (trees using it or a child blackboard).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	Only report this key name; empty reports every key reference.
folder	string	Content folder searched for behavior trees. Padrão TEXT("/Game").

Retorna: asset, references, trees, count, message.

ai.bb_get (risco 0, smoke)

Returns a blackboard with its full key schema (inherited keys first).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_inherited_keys (risco 0, smoke)

Inherited keys only.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_key_filter (risco 0, smoke)

Class or enum filter of one key.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name (local or inherited).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_key_id (risco 0, smoke)

Runtime key ID of a key (index in the parent-first key list).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name (local or inherited).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_key_schema (risco 0, smoke)

Typed schema of one key (type, filters, default, key ID, defining asset).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name (local or inherited).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_key_sync (risco 0, smoke)

Instance synchronization flag of one key.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name (local or inherited).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_local_keys (risco 0, smoke)

Local keys only.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_get_parent_chain (risco 0, smoke)

Parent chain, nearest first (also in parentChain of every reply).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_import (risco 2, altera, smoke)

Applies an exported key schema (merge or replace). Returns the resulting schema; diagnostics list skipped inherited keys.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Target blackboard asset path or unique name.
keys	array of UeaAiBbKeySpec	obrigatório. Key schema to apply (the keys array returned by ai.bb_export_schema). Inherited keys are skipped.
mode	string	merge: add missing keys and rewrite same-type keys; replace: also remove local keys not listed and retype listed ones. Padrão TEXT("merge").

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_list (risco 0, smoke)

Lists blackboard assets in a folder.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_list_keys (risco 0, smoke)

Lists every key, inherited keys first, with key IDs.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_move_key (risco 2, altera, smoke)

Moves a local key to another local index (key IDs change).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Local key name.
index	integer	obrigatório. Destination local-key index, zero based.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_refresh_schema (risco 2, altera, smoke)

Runs the engine refresh (parent keys, key IDs, persistent keys) like the blackboard editor does.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_remove_key (risco 3, altera, destrutivo, smoke)

Removes a local key. Inherited keys must be removed on the parent that defines them.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name.
type	string	obrigatório. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClass	string	Base class filter for class and object keys.
enum	string	Enum asset path for enum keys, or native enum name for nativeEnum keys.
description	string	Optional editor description.
category	string	Optional editor category.
instanceSynced	boolean	Synchronize this key between compatible blackboard instances. Padrão false.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_rename_key (risco 2, altera, smoke)

Renames a local key (behavior tree selectors that use the old name must be updated; see ai.bb_find_references).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Current local key name.
newName	string	obrigatório. New key name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_bool (risco 2, altera, UE 5.4+, smoke)

Creates or updates a bool key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	boolean	Default value. Padrão false.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_class (risco 2, altera, UE 5.5+, smoke)

Creates or updates a class key: base class filter and default class (5.5+).

Argumento	Tipo	Descrição
baseClass	string	obrigatório. Base class filter, e.g. Actor or /Script/Engine.Pawn.
defaultValue	string	Default class (must derive from baseClass); empty for none.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_enum (risco 2, altera, UE 5.5+, smoke)

Creates or updates an enum key: enum type and default enumerator (5.5+).

Argumento	Tipo	Descrição
enum	string	obrigatório. Enum type: UserDefinedEnum asset path or native /Script/Module.EnumName.
defaultValue	string	Default enumerator name (short or qualified); empty selects the first enumerator.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_float (risco 2, altera, UE 5.4+, smoke)

Creates or updates a float key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	number	Default value. Padrão 0.0f.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_int (risco 2, altera, UE 5.4+, smoke)

Creates or updates an int key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	integer	Default value. Padrão 0.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_key (risco 2, altera, smoke)

Rewrites a local key definition (type, filters, description, category, instanceSynced).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Key name.
type	string	obrigatório. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClass	string	Base class filter for class and object keys.
enum	string	Enum asset path for enum keys, or native enum name for nativeEnum keys.
description	string	Optional editor description.
category	string	Optional editor category.
instanceSynced	boolean	Synchronize this key between compatible blackboard instances. Padrão false.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_key_filter (risco 2, altera, smoke)

Changes only the class filter (class/object keys) or enum (enum/nativeEnum keys) of a local key.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Local key name.
baseClass	string	New base class filter (class and object keys), e.g. Pawn or /Script/Engine.Pawn.
enum	string	New enum (enum keys: UserDefinedEnum path or /Script/Module.EnumName; nativeEnum keys: enum name).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_key_sync (risco 2, altera, smoke)

Changes only the instance synchronization flag of a local key.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
name	string	obrigatório. Local key name.
instanceSynced	boolean	obrigatório. Synchronize the key value between every blackboard component that uses this asset.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_name (risco 2, altera, UE 5.4+, smoke)

Creates or updates a name key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	string	Default value (a name).

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_object (risco 2, altera, UE 5.5+, smoke)

Creates or updates an object key: base class filter and default object (5.5+).

Argumento	Tipo	Descrição
baseClass	string	obrigatório. Base class filter, e.g. Actor or /Script/Engine.Pawn.
defaultValue	string	Default object path (an asset that is a baseClass); empty for none.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_parent (risco 2, altera, smoke)

Sets or clears the parent blackboard (cycles and duplicate key names are rejected).

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.
parent	string	Parent blackboard; empty clears the parent.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_rotator (risco 2, altera, UE 5.4+, smoke)

Creates or updates a rotator key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	{x,y,z}	Default value {x=pitch,y=yaw,z=roll}.
useDefault	boolean	Use defaultValue as the initial value (false leaves the key unset at start). Padrão true.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_string (risco 2, altera, UE 5.4+, smoke)

Creates or updates a string key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	string	Default value.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_set_vector (risco 2, altera, UE 5.4+, smoke)

Creates or updates a vector key with its default value (5.4+).

Argumento	Tipo	Descrição
defaultValue	{x,y,z}	Default value {x,y,z}.
useDefault	boolean	Use defaultValue as the initial value (false leaves the key unset at start). Padrão true.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bb_validate (risco 0, smoke)

Structural validation: parent cycles, null key types, duplicate and shadowed names, unfiltered object keys.

Argumento	Tipo	Descrição
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, parent, parentChain, keys, key, count, warnings, message.

ai.bt_add_blackboard_decorator (risco 2, altera, smoke)

Adds a Blackboard condition: key, query, value, observer mode, abort mode.

Argumento	Tipo	Descrição
blackboardKey	string	obrigatório. Key tested by the condition.
keyQuery	string	isSet, isNotSet (bool/object/class/vector/rotator keys); equal, notEqual, less, lessOrEqual, greater, greaterOrEqual (int/float/enum); equal, notEqual, contains, notContains (string/name). Padrão TEXT("isSet").
value	string	Compared value for arithmetic and text queries.
notifyObserver	string	When observers re-evaluate: resultChange or valueChange. Padrão TEXT("resultChange").

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_composite (risco 2, altera, smoke)

Adds a composite (selector, sequence, simpleParallel or a composite class) under a parent at an index.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
type	string	obrigatório. selector, sequence, simpleParallel, or a UBTCompositeNode class path.
parent	string	Parent composite (see node reference forms); empty = root.
index	integer	Child index under the parent; -1 appends. Padrão -1.
name	string	Runtime node name (unique in the tree).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_cone_check_decorator (risco 2, altera, smoke)

Adds a Cone Check decorator (origin, direction, observed keys, half angle).

Argumento	Tipo	Descrição
coneHalfAngle	number	Half angle of the cone in degrees. Padrão 45.0f.
coneOrigin	string	obrigatório. Cone origin key (vector or object).
coneDirection	string	obrigatório. Cone direction key (vector, rotator or object).
observed	string	obrigatório. Observed location key (vector or object).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_cooldown_decorator (risco 2, altera, smoke)

Adds a Cooldown decorator.

Argumento	Tipo	Descrição
cooldownTime	number	Cooldown in seconds. Padrão 5.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_default_focus_service (risco 2, altera, smoke)

Adds the Default Focus service (focus key, interval).

Argumento	Tipo	Descrição
blackboardKey	string	obrigatório. Focus key (object or vector).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_finish_with_result (risco 2, altera, smoke)

Adds Finish With Result.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite (ID, root path or name); empty = root composite.
index	integer	Child index under the parent; -1 appends. Padrão -1.
name	string	Runtime node name (unique in the tree); empty generates one.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_is_at_location_decorator (risco 2, altera, smoke)

Adds an Is At Location decorator (key, radius, inverse).

Argumento	Tipo	Descrição
blackboardKey	string	obrigatório. Location key (vector or object).
acceptableRadius	number	Acceptable radius in cm. Padrão 50.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_loop_decorator (risco 2, altera, smoke)

Adds a Loop decorator (count or infinite with timeout).

Argumento	Tipo	Descrição
numLoops	integer	Number of loops (1..255). Padrão 3.
infinite	boolean	Loop forever. Padrão false.
infiniteLoopTimeout	number	Timeout of an infinite loop in seconds; negative = none. Padrão -1.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_make_noise (risco 2, altera, smoke)

Adds Make Noise.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite (ID, root path or name); empty = root composite.
index	integer	Child index under the parent; -1 appends. Padrão -1.
name	string	Runtime node name (unique in the tree); empty generates one.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_move_to (risco 2, altera, smoke)

Adds Move To: goal key, acceptable radius, strafe/partial path/tracking/observe options.

Argumento	Tipo	Descrição
blackboardKey	string	obrigatório. Goal key (vector or object key of the tree's blackboard).
acceptableRadius	number	Acceptable radius in cm. Padrão 5.0f.
allowStrafe	boolean	Allow strafing. Padrão false.
allowPartialPath	boolean	Accept a partial path when the goal is unreachable. Padrão true.
trackMovingGoal	boolean	Keep following a moving goal actor. Padrão true.
observeBlackboardValue	boolean	Restart the move when the goal key value changes. Padrão false.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_play_animation (risco 2, altera, smoke)

Adds Play Animation: animation asset, looping, non-blocking.

Argumento	Tipo	Descrição
animation	string	Animation asset path; empty leaves it unset.
looping	boolean	Loop the animation. Padrão false.
nonBlocking	boolean	Finish the task immediately instead of waiting for the animation. Padrão false.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_play_sound (risco 2, altera, smoke)

Adds Play Sound: sound cue asset.

Argumento	Tipo	Descrição
sound	string	Sound cue asset path; empty leaves it unset.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_rotate_to_face (risco 2, altera, smoke)

Adds Rotate To Face BB Entry: key and precision.

Argumento	Tipo	Descrição
blackboardKey	string	obrigatório. Key to face (vector, rotator or object key).
precision	number	Success angle precision in degrees. Padrão 10.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_run_behavior (risco 2, altera, smoke)

Adds Run Behavior with a sub-tree asset.

Argumento	Tipo	Descrição
subtree	string	obrigatório. Sub-tree behavior tree asset (must differ from the edited tree).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_run_behavior_dynamic (risco 2, altera, smoke)

Adds Run Behavior Dynamic (sub-tree injected at runtime by gameplay tag).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite (ID, root path or name); empty = root composite.
index	integer	Child index under the parent; -1 appends. Padrão -1.
name	string	Runtime node name (unique in the tree); empty generates one.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_run_eqs (risco 2, altera, smoke)

Adds Run EQS Query: query, run mode and result key.

Argumento	Tipo	Descrição
query	string	EQS query asset; empty leaves the query unset.
blackboardKey	string	obrigatório. Result key (vector or object key).
runMode	string	singleResult, randomBest5Pct, randomBest25Pct or allMatching. Padrão TEXT("singleResult").

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_run_eqs_service (risco 2, altera, smoke)

Adds the Run EQS service (query, run mode, result key, interval).

Argumento	Tipo	Descrição
query	string	EQS query asset; empty leaves the query unset.
blackboardKey	string	obrigatório. Result key (vector or object key).
runMode	string	singleResult, randomBest5Pct, randomBest25Pct or allMatching. Padrão TEXT("singleResult").

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_runtime_decorator (risco 2, altera, smoke)

Adds a decorator of any class to a child (node) at index.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_runtime_service (risco 2, altera, smoke)

Adds a service of any class to a composite (parent) at index.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_runtime_task (risco 2, altera, smoke)

Adds a task of any native or Blueprint BTTask class.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_time_limit_decorator (risco 2, altera, smoke)

Adds a Time Limit decorator.

Argumento	Tipo	Descrição
timeLimit	number	Time limit in seconds. Padrão 5.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_add_wait (risco 2, altera, smoke)

Adds a Wait task.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite; empty = root.
index	integer	Child index under the parent; -1 appends. Padrão -1.
seconds	number	Wait time in seconds. Padrão 1.0f.
randomDeviation	number	Random deviation in seconds. Padrão 0.0f.
name	string	Runtime node name.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_arrange (risco 2, altera, UE 5.3+, smoke)

Lays out the editor graph as a tidy tree (5.3+; older engines regenerate the graph layout when the asset is opened).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
horizontalSpacing	integer	Horizontal distance between leaf columns. Padrão 320.
verticalSpacing	integer	Vertical distance between tree levels. Padrão 220.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_chase_attack_recipe (risco 2, altera, smoke)

Chase/attack branch: Sequence [Blackboard targetKey is set, abort] { Move To target within range, Rotate To Face, attack task }.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite; empty = root composite.
index	integer	Child index; -1 appends (put it before patrol branches under a selector). Padrão -1.
prefix	string	Name prefix of the created nodes. Padrão TEXT("Chase").
targetKey	string	obrigatório. Target actor key (object key).
attackRange	number	Distance at which the attack starts, in cm. Padrão 150.0f.
attackTask	string	Attack task class; empty uses a Wait of attackSeconds as a placeholder.
attackSeconds	number	Placeholder attack duration in seconds. Padrão 1.0f.
abortMode	string	Abort mode of the target condition (both lets the branch preempt lower-priority branches). Padrão TEXT("both").

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_create (risco 2, altera, smoke)

Creates a Behavior Tree with a root selector (optional blackboard).

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game.
name	string	obrigatório. Bare asset name.
blackboard	string	Optional blackboard asset.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_duplicate_node (risco 2, altera, smoke)

Deep-copies a child subtree (with decorators and services), a decorator or a service to a parent at an index.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_export (risco 0, smoke)

Exports the tree as portable nodes (class, parent, edited properties, decorator logic).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.

Retorna: asset, blackboard, nodes, count, notes, message.

ai.bt_find_runtime_node (risco 0, smoke)

Finds one node by ID, root path or name.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_get (risco 0, smoke)

Returns the asset and its blackboard.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.

Retorna: asset, blackboard, message.

ai.bt_get_node (risco 0, smoke)

One node by ID, root path or name.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
node	string	obrigatório. Node reference (ID, root path or name).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_get_runtime_hierarchy (risco 0, smoke)

Regenerated runtime hierarchy.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_get_runtime_property (risco 0, smoke)

Reads a reflected node property as text (returned in node).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_get_tree (risco 0, smoke)

Hierarchy with node IDs, paths, keys, decorator logic and abort modes.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_import (risco 3, altera, destrutivo, smoke)

Replaces the runtime tree with exported nodes (validated before anything changes).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Target Behavior Tree asset (its runtime tree is replaced).
nodes	array of UeaAiBtSpecNode	obrigatório. Nodes as returned by ai.bt_export.
blackboard	string	Optional blackboard to assign before key selectors are resolved.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_investigate_recipe (risco 2, altera, smoke)

Investigate branch: Sequence [conditionKey is set] { Move To locationKey, Wait lookSeconds }.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite; empty = root composite.
index	integer	Child index; -1 appends. Padrão -1.
prefix	string	Name prefix of the created nodes. Padrão TEXT("Investigate").
locationKey	string	obrigatório. Location to investigate (vector or object key).
conditionKey	string	Optional bool key that must be set (e.g. IsAlert).
acceptableRadius	number	Acceptable radius of the move in cm. Padrão 100.0f.
lookSeconds	number	Time spent looking around in seconds. Padrão 3.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_list (risco 0, smoke)

Lists Behavior Tree assets under /Game (the behaviorTree argument is validated but not used as a filter).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.

Retorna: nodes, count, message.

ai.bt_list_nodes (risco 0, smoke)

Flat node list (same content as bt_get_tree, nodes only).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_move_node (risco 2, altera, smoke)

Moves a child under another composite, a decorator to another child, or a service to another composite, at an explicit index.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_patrol_recipe (risco 2, altera, smoke)

Patrol branch: Sequence { Move To locationKey, Wait }.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite; empty = root composite.
index	integer	Child index; -1 appends. Padrão -1.
prefix	string	Name prefix of the created nodes. Padrão TEXT("Patrol").
locationKey	string	obrigatório. Patrol location key (vector or object).
acceptableRadius	number	Acceptable radius of the move in cm. Padrão 50.0f.
waitSeconds	number	Wait at the point in seconds. Padrão 2.0f.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_remove_node (risco 3, altera, destrutivo, smoke)

Removes a node (child subtree, decorator or service). Decorator logic of the affected child is cleared.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_abort (risco 2, altera, smoke)

Sets a decorator's flow abort mode; rejects modes the parent composite cannot perform.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
node	string	obrigatório. Decorator (ID, root path or name).
abortMode	string	obrigatório. none, self, lowerPriority or both (the parent composite decides which are valid).

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_blackboard (risco 2, altera, smoke)

Assigns the blackboard; key selectors are re-resolved against it.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
blackboard	string	obrigatório. Blackboard asset path or unique name.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_blackboard_selector (risco 2, altera, smoke)

Points a key selector property of a node at a blackboard key (validated against the selector's allowed key types).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
node	string	obrigatório. Node (ID, root path or name).
property	string	obrigatório. Key selector property (e.g. BlackboardKey, ConeOrigin, EQSRequest.EQSQueryBlackboardKey).
key	string	obrigatório. Key name from the tree's blackboard chain; "None" clears selectors that allow it.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_decorator_logic (risco 2, altera, smoke)

Sets the decorator logic of a child from an and/or/not expression over its decorators.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
node	string	obrigatório. Decorated child (ID, root path or name).
expression	string	Expression over the child's decorator names: and(...), or(...), not(x); every decorator exactly once. Empty = all must pass.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_node_property (risco 2, altera, smoke)

Sets a reflected node property from text.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
node	string	obrigatório. Node reference (ID, root path or name).
property	string	obrigatório. Reflected property name (dotted paths enter structs).
value	string	obrigatório. Value in Unreal text-export form.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_root (risco 3, altera, destrutivo, smoke)

Promotes a composite to root; nodes outside its subtree are discarded (listed in notes).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_runtime_node_name (risco 2, altera, smoke)

Renames a node object (its ID changes with the name).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_set_runtime_property (risco 2, altera, smoke)

Sets a reflected node property from text (property + value).

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.bt_validate_runtime_hierarchy (risco 0, smoke)

Validates root, empty composites, parallel layout, key selectors against the blackboard, decorator logic and abort modes.

Argumento	Tipo	Descrição
behaviorTree	string	obrigatório. Behavior Tree asset path or unique name.
parent	string	Parent composite for add or move operations; empty addresses the root composite.
node	string	Existing node (ID, root path or name) for get, remove, move, duplicate, or property operations.
class	string	Native or Blueprint BT node class for generic add operations.
name	string	Name for a new or renamed node (unique in the tree).
property	string	Reflected property name.
value	string	Text-export value for a reflected property.
index	integer	Child (or decorator/service) position; -1 appends. Padrão -1.

Retorna: asset, blackboard, tree, nodes, node, nodeId, created, graphSync, notes, message.

ai.clear_blackboard_value (risco 2, altera, requer PIE, smoke)

Clears a Blackboard value.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.
key	string	obrigatório. Blackboard key name.
type	string	obrigatório. bool, int, float, string, name, vector, rotator, enum, object or class.
value	string	Text value for bool/int/float/string/name/enum (enum takes the numeric value), actor label for object, class path for class.
vector	{x,y,z}	Vector value (vector) or pitch/yaw/roll (rotator).

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.clear_focus (risco 2, altera, requer PIE, smoke)

Clears the focus at priority.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.create_test_setup (risco 2, altera, smoke)

Creates (or reuses) the shared fixtures in folder: BB_AiSmoke (TargetActor object, PatrolIndex int, HomeLocation vector, IsAlert bool), BT_AiSmoke (RootSelector, linked to BB_AiSmoke) and EQ_AiSmoke (grid around the querier scored by distance).

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game for the Blackboard and runtime Behavior Tree fixtures.

Retorna: assets, count, warnings, message.

ai.despawn_ai (risco 1, altera, destrutivo, requer PIE, smoke)

Destroys an AI controller and its pawn.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.eqs_add_option (risco 2, altera, smoke)

Adds an option with a new generator of class; index inserts (-1 appends). Returns the new option index.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_add_test (risco 2, altera, smoke)

Adds a test of class to an option; index inserts (-1 appends). Returns the new test index.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_audit (risco 0, smoke)

Audits every query in a folder (no options, option without generator or tests, context-less tests, zero scoring factors).

Argumento	Tipo	Descrição
folder	string	Content folder to audit. Padrão TEXT("/Game").
recursive	boolean	Include subfolders. Padrão true.

Retorna: queries, count, withIssues, message.

ai.eqs_audit_options (risco 0, smoke)

Reports options without a generator and options without tests.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_clear_tests (risco 3, altera, destrutivo, smoke)

Removes every test of an option.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_actors_of_class (risco 2, altera, smoke)

Configures an Actors Of Class generator.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be ActorsOfClass. Padrão 0.
searchedActorClass	string	obrigatório. Actor class to collect (path or unique name).
searchRadius	number	Search radius in cm (> 0). Padrão 2000.f.
onlyInRadius	boolean	Only generate actors inside the radius. Padrão true.
searchCenter	string	Context at the search centre; empty keeps the current one.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_circle (risco 2, altera, smoke)

Configures a Points: Circle generator (radius, spacing by distance or count, centre, arc).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be OnCircle. Padrão 0.
radius	number	Circle radius in cm (> 0). Padrão 500.f.
numberOfPoints	integer	When > 0 the points are spaced by count (ByNumberOfPoints); otherwise by spaceBetween. Padrão 0.
spaceBetween	number	Distance between points in cm when numberOfPoints is 0 (> 0). Padrão 100.f.
circleCenter	string	Context at the circle centre; empty keeps the current one.
arcAngle	number	Arc angle in degrees; 0 or 360 generates the full circle. Padrão 360.f.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_cone (risco 2, altera, smoke)

Configures a Points: Cone generator.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be Cone. Padrão 0.
coneDegrees	number	Cone angle in degrees (0..359). Padrão 90.f.
range	number	Cone length in cm (> 0). Padrão 1000.f.
angleStep	number	Angle between generated lines in degrees (> 0). Padrão 10.f.
alignedPointsDistance	number	Distance between points on each line in cm (> 0). Padrão 100.f.
centerActor	string	Context at the cone apex; empty keeps the current one.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_current_location (risco 2, altera, smoke)

Configures a Current Location generator (the context whose location becomes the item).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be CurrentLocation. Padrão 0.
queryContext	string	obrigatório. Context whose location(s) become the items.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_distance_test (risco 2, altera, smoke)

Configures a Distance test (mode and context).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Distance. Padrão 0.
testMode	string	Distance3D, Distance2D, DistanceZ or DistanceAbsoluteZ. Padrão TEXT("Distance3D").
distanceTo	string	Context measured to; empty keeps the current one.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_donut (risco 2, altera, smoke)

Configures a Points: Donut generator.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be Donut. Padrão 0.
innerRadius	number	Inner radius in cm (>= 0). Padrão 300.f.
outerRadius	number	Outer radius in cm (> innerRadius). Padrão 1000.f.
numberOfRings	integer	Number of rings (>= 1). Padrão 3.
pointsPerRing	integer	Points per ring (>= 1). Padrão 8.
center	string	Context at the donut centre; empty keeps the current one.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_dot_test (risco 2, altera, smoke)

Configures a Dot test (two directions from contexts, 3D or 2D, absolute value).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Dot. Padrão 0.
lineAFrom	string	Line A start context; empty keeps.
lineATo	string	Line A end context; empty keeps.
lineBFrom	string	Line B start context; empty keeps.
lineBTo	string	Line B end context; empty keeps.
testMode	string	Dot3D or Dot2D. Padrão TEXT("Dot3D").
absoluteValue	boolean	Use the absolute value of the dot product. Padrão false.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_grid (risco 2, altera, smoke)

Configures a Points: Grid generator (SimpleGrid or PathingGrid).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be a SimpleGrid (or subclass). Padrão 0.
gridSize	number	Half extent of the square grid in cm (> 0). Padrão 1000.f.
spaceBetween	number	Distance between grid points in cm (> 0). Padrão 100.f.
generateAround	string	Context the grid is centred on; empty keeps the current one.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_overlap_test (risco 2, altera, smoke)

Configures an Overlap test (shape, extent, channel, expected overlap).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Overlap. Padrão 0.
shape	string	Box, Sphere or Capsule. Padrão TEXT("Sphere").
extent	{x,y,z}	Shape extent in cm (sphere uses x as radius; capsule uses x radius, z half height). Padrão FUeaVec3(50.0, 50.0, 50.0).
channel	string	Collision channel (ECC_WorldStatic, ECC_WorldDynamic, ECC_Pawn, ECC_Visibility...); empty keeps the current channel.
onlyBlockingHits	boolean	Count blocking hits only. Padrão true.
overlapComplex	boolean	Overlap complex collision. Padrão false.
skipOverlapQuerier	boolean	Ignore the querier in the overlap. Padrão true.
expectOverlap	boolean	Expected overlap result for the Match filter (false keeps free points). Padrão false.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_pathfinding_test (risco 2, altera, smoke)

Configures a Pathfinding test (PathExist/PathCost/PathLength, context, direction).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Pathfinding. Padrão 0.
testMode	string	PathExist, PathCost or PathLength. Padrão TEXT("PathExist").
context	string	Context the path goes to or from; empty keeps the current one.
pathFromContext	boolean	Path from the context to the item (false: item to context). Padrão true.
skipUnreachable	boolean	Discard unreachable items for PathCost/PathLength. Padrão true.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_pathing_grid (risco 2, altera, smoke)

Configures the pathing part of a Points: Pathing Grid generator (grid size via ai.eqs_configure_grid).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must be PathingGrid. Padrão 0.
pathToItem	boolean	true: path from context to items; false: from items to context. Padrão true.
scanRangeMultiplier	number	Multiplier of the navigation scan range (> 0). Padrão 1.5f.
navigationFilter	string	UNavigationQueryFilter subclass; empty keeps the current filter.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_project_test (risco 2, altera, smoke)

Configures a Project test (navmesh/geometry projection that items must pass).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Project. Padrão 0.
traceMode	string	obrigatório. EEnvQueryTrace value (None, Navigation, NavigationOverLedges, Geometry on 4.27, GeometryByChannel/GeometryByProfile on 5.x).
projectDown	number	Downward projection distance in cm. Padrão 1024.f.
projectUp	number	Upward projection distance in cm. Padrão 1024.f.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_configure_trace_test (risco 2, altera, smoke)

Configures a Trace test (context, direction, offsets, shape, expected hit).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; the test must be EnvQueryTest_Trace. Padrão 0.
context	string	Context traced to or from; empty keeps the current one.
traceFromContext	boolean	Trace from the context towards the item (false: from the item). Padrão true.
itemHeightOffset	number	Item height offset in cm. Padrão 0.f.
contextHeightOffset	number	Context height offset in cm. Padrão 0.f.
traceShape	string	Line, Box, Sphere or Capsule. Padrão TEXT("Line").
expectHit	boolean	Expected trace hit (true: item hidden from context, i.e. cover). Applied as a Match filter. Padrão true.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_cover_recipe (risco 2, altera, smoke)

Recipe: cover points. Grid around the querier, Trace test that keeps points hidden from targetContext, Distance test that prefers points near the querier.

Argumento	Tipo	Descrição
query	string	obrigatório. New /Game package path of the query (must not exist).
radius	number	Grid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Padrão 1000.f.
spaceBetween	number	Point spacing in cm (grid recipes). Padrão 150.f.
numberOfPoints	integer	Number of points on the circle (points around target). Padrão 12.
targetContext	string	Context to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_create (risco 2, altera, smoke)

Creates an empty EQS query asset at a /Game package path.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_create_context_blueprint (risco 2, altera, smoke)

Creates a Blueprint EQS context (parent EnvQueryContext_BlueprintBase); override ProvideSingleActor/Location in the bp kit.

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game.
name	string	obrigatório. Blueprint asset name.

Retorna: blueprint, generatedClass, parentClass, message.

ai.eqs_create_generator_blueprint (risco 2, altera, smoke)

Creates a Blueprint EQS generator (parent EnvQueryGenerator_BlueprintBase); implement DoItemGeneration in the bp kit.

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game.
name	string	obrigatório. Blueprint asset name.

Retorna: blueprint, generatedClass, parentClass, message.

ai.eqs_delete (risco 3, altera, destrutivo, smoke)

Deletes the query asset.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_duplicate (risco 2, altera, smoke)

Duplicates a query asset to newPath.

Argumento	Tipo	Descrição
query	string	obrigatório. Source EQS query asset path or unique name.
newPath	string	obrigatório. Destination /Game package path of the copy (must not exist).

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_duplicate_option (risco 2, altera, smoke)

Duplicates an option (generator and tests) inside the same query.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index to copy. Padrão 0.
index	integer	Insert position of the copy; -1 appends. Padrão -1.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_export (risco 0, smoke)

Exports a query as generator/test classes plus their non-default properties (re-importable with ai.eqs_import).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, options, message.

ai.eqs_export_runtime_schema (risco 0, smoke)

Returns the runtime structure (options, generators, tests, contexts) of a query.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_get (risco 0, smoke)

Returns a query with its full option/generator/test structure.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, name, optionCount, stripFromClientBuilds, options, structure, issues, message.

ai.eqs_get_generator (risco 0, smoke)

Returns the generator of an option with its editable properties.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_get_option_count (risco 0, smoke)

Returns the number of options in count.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_get_test (risco 0, smoke)

Returns a test with its editable properties.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_get_test_count (risco 0, smoke)

Returns the number of tests of an option in count.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_import (risco 2, altera, smoke)

Builds a query from the ai.eqs_export format (generator/test classes plus non-default properties).

Argumento	Tipo	Descrição
query	string	obrigatório. /Game package path of the query to build.
options	array of UeaAiEqsOptionSpec	obrigatório. Options in execution order (the ai.eqs_export format).
replace	boolean	When the query exists: true replaces all its options, false fails with E_CONFLICT. Padrão false.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_list (risco 0, smoke)

Lists EQS query assets under a folder.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: queries, count, message.

ai.eqs_list_context_classes (risco 0, smoke)

Lists concrete context classes (Querier, Item, loaded Blueprint contexts).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_list_generator_classes (risco 0, smoke)

Lists concrete generator classes (native and loaded Blueprint generators).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_list_test_classes (risco 0, smoke)

Lists concrete test classes.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_move_option (risco 2, altera, smoke)

Moves option option to position index (options run in order until one yields items).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_move_test (risco 2, altera, smoke)

Moves test test to position index inside its option.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_nearest_reachable_recipe (risco 2, altera, smoke)

Recipe: nearest reachable point. Grid around the querier, Pathfinding PathExist filter, Distance test that prefers near points.

Argumento	Tipo	Descrição
query	string	obrigatório. New /Game package path of the query (must not exist).
radius	number	Grid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Padrão 1000.f.
spaceBetween	number	Point spacing in cm (grid recipes). Padrão 150.f.
numberOfPoints	integer	Number of points on the circle (points around target). Padrão 12.
targetContext	string	Context to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_points_around_target_recipe (risco 2, altera, smoke)

Recipe: points around a target. Circle of numberOfPoints points of radius around targetContext, Distance test that prefers points near the querier.

Argumento	Tipo	Descrição
query	string	obrigatório. New /Game package path of the query (must not exist).
radius	number	Grid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Padrão 1000.f.
spaceBetween	number	Point spacing in cm (grid recipes). Padrão 150.f.
numberOfPoints	integer	Number of points on the circle (points around target). Padrão 12.
targetContext	string	Context to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_remove_option (risco 3, altera, destrutivo, smoke)

Removes option option.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_remove_test (risco 3, altera, destrutivo, smoke)

Removes test test from option option.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_replace_generator (risco 2, altera, smoke)

Replaces the generator of an option with a new generator of class (tests are kept).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_run (risco 0, requer mundo, smoke)

Runs a query synchronously in the editor world (PIE world while PIE runs) and returns scored items, best first.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
querier	string	obrigatório. Querier actor (label, name, or class:); contexts such as EnvQueryContext_Querier resolve to it.
runMode	string	SingleResult, RandomBest5Pct, RandomBest25Pct or AllMatching. Padrão TEXT("AllMatching").
maxItems	integer	Maximum number of items in the reply (1..1000). Padrão 50.

Retorna: asset, querier, world, status, optionIndex, itemType, totalItems, items, message.

ai.eqs_set_context (risco 2, altera, smoke)

Sets a context property (TSubclassOf) on the generator (test = -1) or on a test.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index; -1 targets the option's generator. Padrão -1.
property	string	obrigatório. Context property name or dotted path (GenerateAround, CircleCenter, DistanceTo, Context, LineA.LineFrom...).
context	string	obrigatório. UEnvQueryContext subclass (EnvQueryContext_Querier, EnvQueryContext_Item, a Blueprint context...).

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_generator (risco 2, altera, smoke)

Sets one reflected generator property from text (property may be a dotted path such as GridSize.DefaultValue).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_projection (risco 2, altera, smoke)

Sets the navmesh/geometry projection (ProjectionData) of a points generator.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index; its generator must derive from EnvQueryGenerator_ProjectedPoints. Padrão 0.
traceMode	string	obrigatório. EEnvQueryTrace value: None, Navigation, NavigationOverLedges, and Geometry (4.27) or GeometryByChannel/GeometryByProfile (5.x).
projectDown	number	Downward projection distance in cm. Padrão 1024.f.
projectUp	number	Upward projection distance in cm. Padrão 1024.f.
postProjectionVerticalOffset	number	Vertical offset added after projection in cm. Padrão 0.f.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_strip_from_client_builds (risco 2, altera, UE 5.8+, smoke)

Sets bStripFromClientBuilds (server-only query). UE 5.8+.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
strip	boolean	Do not cook the query into client builds (server-only AI). Padrão true.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_test (risco 2, altera, smoke)

Sets one reflected test property from text (dotted paths allowed, e.g. ScoringFactor.DefaultValue).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_test_filter (risco 2, altera, smoke)

Sets filter type and bounds (or the expected bool for Match) of a test.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index. Padrão 0.
filterType	string	obrigatório. Minimum, Maximum or Range for float tests; Match for bool tests.
min	number	Lower bound (Minimum, Range). Padrão 0.f.
max	number	Upper bound (Maximum, Range). Padrão 0.f.
match	boolean	Expected value for Match (bool tests such as Trace or Pathfinding PathExist). Padrão true.
purpose	string	Filter, Score or FilterAndScore; empty keeps the current purpose.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_set_test_scoring (risco 2, altera, smoke)

Sets purpose, scoring equation, factor and clamping of a test.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index. Padrão 0.
purpose	string	Filter, Score or FilterAndScore.
scoringEquation	string	Linear, Square, InverseLinear, SquareRoot or Constant.
scoringFactor	number	Weight (> 0); 0 keeps the current value. Padrão 0.f.
clampMinType	string	None, SpecifiedValue or FilterThreshold; SpecifiedValue uses scoreClampMin.
clampMaxType	string	None, SpecifiedValue or FilterThreshold; SpecifiedValue uses scoreClampMax.
scoreClampMin	number	Lower clamp value when clampMinType is SpecifiedValue. Padrão 0.f.
scoreClampMax	number	Upper clamp value when clampMaxType is SpecifiedValue. Padrão 0.f.
comment	string	Designer comment; empty keeps the current comment.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_validate (risco 0, smoke)

Validates a query: options without generator, options without tests, tests without purpose-relevant settings. Issues are returned, never raised.

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.

Retorna: asset, name, optionCount, stripFromClientBuilds, options, structure, issues, message.

ai.eqs_validate_option (risco 0, smoke)

Validates one option (generator present, item type, tests).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.eqs_validate_test (risco 0, smoke)

Validates one test (class, filter/score settings).

Argumento	Tipo	Descrição
query	string	obrigatório. EQS query asset path or unique name.
class	string	Generator, test, or context class path.
option	integer	Zero-based option index. Padrão 0.
test	integer	Zero-based test index within option. Padrão 0.
index	integer	Destination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Padrão -1.
property	string	Reflected property name on the option generator or test.
value	string	Text-export value for a reflected property.

Retorna: asset, options, option, test, count, structure, properties, notes, message.

ai.get_blackboard (risco 0, requer PIE, smoke)

Returns the Blackboard component asset of a controller.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_blackboard_key_schema (risco 0, requer PIE, smoke)

Returns the runtime Blackboard keys as name|type.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_blackboard_values (risco 0, requer PIE, smoke)

Every Blackboard key with its type and current value.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.

Retorna: controller, blackboard, keys, count, message.

ai.get_brain_component (risco 0, requer PIE, smoke)

Returns the brain component.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_controlled_pawn (risco 0, requer PIE, smoke)

Returns the possessed pawn.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_controller (risco 0, requer PIE, smoke)

Typed snapshot of one controller (pawn, brain, tree, active node, blackboard, move status, focus, perception).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_controller_location (risco 0, requer PIE, smoke)

Returns the pawn location.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_current_move_request (risco 0, requer PIE, smoke)

Returns the current move request id.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_focal_point (risco 0, requer PIE, smoke)

Returns the current focal point.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_focus (risco 0, requer PIE, smoke)

Returns the focus actor (or focal point) at priority.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_move_status (risco 0, requer PIE, smoke)

Returns the path following status (Idle, Waiting, Paused, Moving).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_path_following_component (risco 0, requer PIE, smoke)

Returns the path following component.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.get_pawn_ai_settings (risco 0, requer mundo, smoke)

Returns AIControllerClass and AutoPossessAI of a level pawn.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, controllerClass, autoPossessAi, message.

ai.get_team_attitude (risco 0, requer PIE, smoke)

Attitude of actor towards target (Friendly, Neutral, Hostile) as the perception system sees it.

Argumento	Tipo	Descrição
actor	string	obrigatório. Observer actor (usually an AI controller) in PIE.
target	string	obrigatório. Observed actor in PIE.

Retorna: actor, teamId, target, targetTeamId, attitude, message.

ai.get_tree_state (risco 0, requer PIE, smoke)

Returns the brain state (running, paused, current/root tree, active node).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.list_ai_controller_classes (risco 0, smoke)

Sem descrição.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: assets, count, warnings, message.

ai.list_ai_controllers (risco 0, requer PIE, smoke)

Lists AI controller paths in the PIE world (typed snapshots: ai.audit_controllers).

Sem argumentos.

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.list_assets (risco 0, smoke)

Lists Blackboard, Behavior Tree and EQS query assets under a folder.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: assets, count, warnings, message.

ai.list_bt_decorator_classes (risco 0, smoke)

Sem descrição.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: assets, count, warnings, message.

ai.list_bt_service_classes (risco 0, smoke)

Sem descrição.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: assets, count, warnings, message.

ai.list_bt_task_classes (risco 0, smoke)

Sem descrição.

Argumento	Tipo	Descrição
folder	string	Content folder to search. Padrão TEXT("/Game").
recursive	boolean	Search subfolders. Padrão true.

Retorna: assets, count, warnings, message.

ai.move_to (risco 2, altera, requer PIE, smoke)

Moves to an actor (target) or a location; returns the request result and id. Needs a navmesh for path moves.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.pause_tree (risco 2, altera, requer PIE, smoke)

Pauses the controller's brain logic.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.perception_add_component (risco 2, altera, requer mundo, smoke)

Adds an AIPerception component to a level actor (returns the existing one with created=false). On an AIController it also becomes the controller's perception component.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_damage (risco 2, altera, requer mundo, smoke)

Adds a default damage config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_hearing (risco 2, altera, requer mundo, smoke)

Adds a default hearing config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_prediction (risco 2, altera, requer mundo, smoke)

Adds a default prediction config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_sense (risco 2, altera, requer mundo, smoke)

Adds (or replaces) a sense config of class with default settings.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_sight (risco 2, altera, requer mundo, smoke)

Adds a default sight config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_team (risco 2, altera, requer mundo, smoke)

Adds a default team config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_add_touch (risco 2, altera, requer mundo, smoke)

Adds a default touch config.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_animal_preset (risco 2, altera, requer mundo, smoke)

Preset: animal. Hearing 3000 cm dominant, wide short sight 1000/1200 cm 110 degrees for every affiliation, touch.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_audit (risco 0, requer mundo, smoke)

Audits every AIPerception component in the world (no senses, dominant sense not configured, lose-sight radius below sight radius, component not on an AIController) and lists stimuli sources.

Sem argumentos.

Retorna: world, components, stimuliSources, withIssues, message.

ai.perception_configure_hearing (risco 2, altera, requer mundo, smoke)

Creates or updates the hearing sense: range, max age, affiliation, optional dominance.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
hearingRange	number	Hearing range in cm (> 0). Padrão 3000.f.
maxAge	number	Seconds a noise is remembered; 0 = forever. Padrão 5.f.
affiliation	UeaAiPerceptionAffiliation	Who is detected.
dominant	boolean	Make hearing the dominant sense. Padrão false.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_configure_sight (risco 2, altera, requer mundo, smoke)

Creates or updates the sight sense: radii, vision angle, max age, auto-success range, affiliation, optional dominance.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sightRadius	number	Radius in cm at which targets are first seen (> 0). Padrão 3000.f.
loseSightRadius	number	Radius in cm at which seen targets are lost (>= sightRadius). Padrão 3500.f.
peripheralVisionAngle	number	Half angle of the vision cone in degrees (0..180). Padrão 90.f.
maxAge	number	Seconds a sighting is remembered; 0 = forever. Padrão 5.f.
autoSuccessRange	number	Auto-success range from the last seen location in cm; negative disables it. Padrão -1.f.
affiliation	UeaAiPerceptionAffiliation	Who is detected.
dominant	boolean	Make sight the dominant sense. Padrão false.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_forget_actor (risco 2, altera, requer mundo, smoke)

Forgets one target actor.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_forget_all (risco 2, altera, requer mundo, smoke)

Forgets every perceived actor.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get (risco 0, requer mundo, smoke)

Returns the perception component of an actor with its typed sense configs.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_actor_stimuli (risco 0, requer mundo, smoke)

Stimuli remembered for one target actor.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_config (risco 0, requer mundo, smoke)

Returns every sense config with its settings.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_currently_perceived (risco 0, requer mundo, smoke)

Actors currently perceived (optionally by one sense) in senses.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_dominant (risco 0, requer mundo, smoke)

Returns the dominant sense.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_known_perceived (risco 0, requer mundo, smoke)

Actors ever perceived and still remembered (optionally by one sense) in senses.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_get_sense (risco 0, requer mundo, smoke)

Returns one configured sense with every setting.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sense	string	obrigatório. Config class name or path (AISenseConfig_Sight, /Script/AIModule.AISenseConfig_Hearing...).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_guard_preset (risco 2, altera, requer mundo, smoke)

Preset: guard. Sight 2000/2500 cm, 60 degrees, hearing 1500 cm, damage; sight dominant.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_is_sense_enabled (risco 0, UE 5.4+, requer mundo, smoke)

Whether a sense (implementation class) is enabled. UE 5.0+.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_list_config_properties (risco 0, requer mundo, smoke)

Lists the property names of a configured sense.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_list_sense_classes (risco 0, smoke)

Lists concrete UAISenseConfig classes.

Sem argumentos.

Retorna: classes, count.

ai.perception_list_senses (risco 0, requer mundo, smoke)

Lists the configured sense config classes of an actor's perception component.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_remove_component (risco 3, altera, destrutivo, requer mundo, smoke)

Removes an AIPerception component that was added to the actor instance (class components are refused).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_remove_sense (risco 3, altera, destrutivo, requer mundo, smoke)

Removes one sense config (it is disabled first so a running listener stops using it).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sense	string	obrigatório. Config class name or path (AISenseConfig_Sight, /Script/AIModule.AISenseConfig_Hearing...).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_request_listener_update (risco 2, altera, requer mundo, smoke)

Asks the perception system to refresh the component's listener.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_affiliation (risco 2, altera, requer mundo, smoke)

Sets detection by affiliation (enemies/neutrals/friendlies) of one configured sense.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sense	string	obrigatório. Config class name or path (Sight, Hearing, or Touch on 5.x).
affiliation	UeaAiPerceptionAffiliation	Who is detected.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_dominant (risco 2, altera, requer mundo, smoke)

Sets the dominant sense (implementation class, e.g. /Script/AIModule.AISense_Sight).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_max_age (risco 2, altera, requer mundo, smoke)

Sets how long stimuli of one configured sense are remembered.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sense	string	obrigatório. Config class name or path.
maxAge	number	Seconds a stimulus stays known (>= 0; 0 = forever). Padrão 5.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_sense (risco 2, altera, requer mundo, smoke)

Sets one reflected setting of a configured sense from text.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_sense_enabled (risco 2, altera, requer mundo, smoke)

Enables or disables a sense (implementation class) at run time.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor containing the AI Perception component.
class	string	UAISenseConfig subclass for an add operation.
sense	string	Sense-config class or implementation-sense class to select.
property	string	Reflected setting on the selected config.
value	string	Text-export value for the setting.
target	string	Stimulus target actor for runtime reporting.
strength	number	Loudness or damage amount for the matching runtime report. Padrão 1.f.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_set_starts_enabled (risco 2, altera, requer mundo, smoke)

Sets whether one configured sense starts enabled.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with the AIPerception component.
sense	string	obrigatório. Config class name or path.
enabled	boolean	Sense active from the start. Padrão true.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.perception_sniper_preset (risco 2, altera, requer mundo, smoke)

Preset: sniper. Long narrow sight 6000/6500 cm, 15 degrees, long memory, damage; sight dominant.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.possess (risco 2, altera, requer PIE, smoke)

Possesses a pawn (target).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.remove_test_actor (risco 3, altera, destrutivo, requer mundo, smoke)

Destroys an actor created by ai.spawn_test_actor (actors without the UeaAiTest tag are refused).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.report_damage (risco 2, altera, requer PIE, smoke)

Reports a damage event to the damage sense (UAISense_Damage::ReportDamageEvent).

Argumento	Tipo	Descrição
damaged	string	obrigatório. Damaged actor (label); its perception component receives the event.
instigator	string	Instigator actor (label); empty = none.
amount	number	Damage amount (stimulus strength). Padrão 10.f.
location	{x,y,z}	Event location in cm; zero uses the instigator (or damaged) actor location.
tag	string	Optional stimulus tag.

Retorna: sense, location, instigator, listeners, message.

ai.report_noise (risco 2, altera, requer PIE, smoke)

Reports a noise event to the hearing sense (UAISense_Hearing::ReportNoiseEvent).

Argumento	Tipo	Descrição
location	{x,y,z}	Noise location in cm.
loudness	number	Loudness multiplier of the listeners' hearing range (> 0). Padrão 1.f.
instigator	string	Actor that made the noise (label); empty = none.
maxRange	number	Maximum range in cm; 0 = listeners' hearing range only. Padrão 0.f.
tag	string	Optional stimulus tag.

Retorna: sense, location, instigator, listeners, message.

ai.report_touch (risco 2, altera, UE 5.1+, requer PIE, smoke)

Reports a touch event to the touch sense (UAISense_Touch::ReportTouchEvent). UE 5.1+.

Argumento	Tipo	Descrição
receiver	string	obrigatório. Actor that was touched (label); its perception component receives the event.
other	string	obrigatório. Actor that touched it (label).
location	{x,y,z}	Contact location in cm; zero uses the other actor location.

Retorna: sense, location, instigator, listeners, message.

ai.restart_tree (risco 2, altera, requer PIE, smoke)

Restarts the controller's brain logic from the root (UBrainComponent::RestartLogic).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.resume_tree (risco 2, altera, requer PIE, smoke)

Resumes paused brain logic.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.run_tree (risco 2, altera, requer PIE, smoke)

Runs a Behavior Tree (target) on a controller; the tree's Blackboard is initialised.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.runtime_get_perception (risco 0, requer PIE, smoke)

Typed perception snapshot of a controller (or any actor with an AIPerception component): senses and every perceived actor with its stimuli.

Argumento	Tipo	Descrição
actor	string	obrigatório. AI controller or any actor owning an AIPerception component (PIE world).
includeExpired	boolean	Include actors whose stimuli all expired. Padrão true.

Retorna: actor, component, dominantSense, senseConfigs, perceived, count, message.

ai.set_blackboard_value (risco 2, altera, requer PIE, smoke)

Sets a typed Blackboard value (bool, int, float, string, name, vector, rotator, enum, object, class).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.
key	string	obrigatório. Blackboard key name.
type	string	obrigatório. bool, int, float, string, name, vector, rotator, enum, object or class.
value	string	Text value for bool/int/float/string/name/enum (enum takes the numeric value), actor label for object, class path for class.
vector	{x,y,z}	Vector value (vector) or pitch/yaw/roll (rotator).

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.set_focal_point (risco 2, altera, requer PIE, smoke)

Focuses a world location at priority.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.set_focus (risco 2, altera, requer PIE, smoke)

Focuses an actor (target) at priority (Default, Move, Gameplay).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.set_pawn_ai_settings (risco 2, altera, requer mundo, smoke)

Sets AIControllerClass and/or AutoPossessAI on a level pawn.

Argumento	Tipo	Descrição
actor	string	obrigatório. Pawn label or name in the editor world.
controllerClass	string	AIController class path or name; empty keeps the current class.
autoPossessAi	string	Disabled, PlacedInWorld, Spawned or PlacedInWorldOrSpawned; empty keeps the current value.

Retorna: actor, actorLabel, controllerClass, autoPossessAi, message.

ai.set_team_id (risco 2, altera, requer PIE, smoke)

Sets the generic team id of an AI controller (sight/hearing affiliation filters use it).

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller label, name, or class: in the PIE world.
teamId	integer	Team id 0..254; 255 means no team. Padrão 1.

Retorna: actor, teamId, target, targetTeamId, attitude, message.

ai.so_add_behavior_definition (risco 2, altera, UE 5.3+, requer plugin SmartObjects, smoke)

Adds a behavior definition instance of behaviorClass to a slot.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index. Padrão 0.
behaviorClass	string	so_add_behavior_definition: concrete USmartObjectBehaviorDefinition class (see so_list_behavior_definition_classes).
index	integer	so_remove_behavior_definition: index in the slot's behavior definition list. Padrão 0.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_add_slot (risco 2, altera, UE 5.0+, requer plugin SmartObjects, smoke)

Adds a slot; name, offset, rotation and activity tags are applied on UE 5.3+. Returns the typed definition.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
name	string	Optional slot name (UE 5.3+).
offset	{x,y,z}	Slot offset from the owner in cm (UE 5.3+).
rotation	{x,y,z}	Slot rotation pitch/yaw/roll in degrees (UE 5.3+).
activityTags	array of string	Slot activity tags (UE 5.3+).

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_attach_definition (risco 2, altera, UE 5.6+, requer plugin SmartObjects, requer mundo, smoke)

Adds a Smart Object component with the definition to an editor-world actor (or to a new actor with spawnNew).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label/name in the editor world, or 'class:'. With spawnNew: label of the new actor.
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
spawnNew	boolean	Spawn a new empty actor with this label instead of using an existing one. Padrão false.
location	{x,y,z}	Location of the new actor (spawnNew only).

Retorna: world, objects, results, count, changedActors.

ai.so_audit_slots (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Audits the slots: missing behavior definitions, disabled slots, duplicate names, overlapping offsets.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_claim_slot (risco 1, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE: claims a slot (MarkSlotAsClaimed) and returns the claim id '#'.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label of the Smart Object in the PIE world.
slot	integer	Slot index on that Smart Object. Padrão 0.
priority	string	Claim priority: Low, BelowNormal, Normal, AboveNormal, High. Padrão TEXT("Normal").

Retorna: claim, claims, count.

ai.so_create_definition (risco 2, altera, UE 5.0+, requer plugin SmartObjects, smoke)

Creates an empty Smart Object definition asset (add slots with ai.so_add_slot).

Argumento	Tipo	Descrição
folder	string	obrigatório. Content folder under /Game.
name	string	obrigatório. Bare asset name.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_duplicate_definition (risco 2, altera, UE 5.0+, requer plugin SmartObjects, smoke)

Duplicates a definition asset (slots, behaviors, tags) into a new asset.

Argumento	Tipo	Descrição
definition	string	obrigatório. Source definition asset path or unique asset name.
folder	string	obrigatório. Destination folder under /Game.
name	string	obrigatório. Bare name of the copy.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_find_slots (risco 0, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE: finds Smart Object slots in a box around location (USmartObjectSubsystem::FindSmartObjects) filtered by activity tags / behavior class.

Argumento	Tipo	Descrição
location	{x,y,z}	Query center.
radius	number	Query half extent in cm (box). Padrão 5000.f.
activityTags	array of string	Slots must match any of these activity tags (empty = no activity requirement).
behaviorClass	string	Only slots offering this behavior definition class.
includeClaimed	boolean	Include slots that are already claimed. Padrão false.
limit	integer	Maximum results (1-500). Padrão 100.

Retorna: world, objects, results, count, changedActors.

ai.so_get_definition (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Returns a definition with its typed slots (UE 5.3+ fields), activity tags and user tag filter.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_get_slot (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Returns one slot (typed on UE 5.3+, text export in message).

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index returned by so_list_slots. Padrão 0.
property	string	Reflected slot-definition property name (so_get/set_slot_property).
value	string	Text-export value for the slot property (so_set_slot_property).

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_get_slot_property (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Reads one reflected slot property as text.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index returned by so_list_slots. Padrão 0.
property	string	Reflected slot-definition property name (so_get/set_slot_property).
value	string	Text-export value for the slot property (so_set_slot_property).

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_list_behavior_definition_classes (risco 0, UE 5.3+, requer plugin SmartObjects, smoke)

Lists concrete loaded USmartObjectBehaviorDefinition classes (behavior definitions come from gameplay plugins such as GameplayBehaviorSmartObjects, GameplayInteractions or MassGameplay).

Sem argumentos.

Retorna: classes, count.

ai.so_list_claims (risco 0, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE: lists the claims made through this kit with their current slot state.

Sem argumentos.

Retorna: claim, claims, count.

ai.so_list_definitions (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Lists Smart Object definition assets under a folder.

Argumento	Tipo	Descrição
folder	string	Content folder to list. Padrão TEXT("/Game").
recursive	boolean	Include sub-folders. Padrão true.

Retorna: definitions, count.

ai.so_list_slot_properties (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Lists the reflected slot property names (one per line in message).

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index returned by so_list_slots. Padrão 0.
property	string	Reflected slot-definition property name (so_get/set_slot_property).
value	string	Text-export value for the slot property (so_set_slot_property).

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_list_slots (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Lists the slots of a definition.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_list_world_objects (risco 0, UE 5.6+, requer plugin SmartObjects, requer mundo, smoke)

Lists Smart Object components of the PIE world (or the editor world) with registration, handle and runtime slot states.

Argumento	Tipo	Descrição
actor	string	Optional actor label filter (exact).

Retorna: world, objects, results, count, changedActors.

ai.so_release_slot (risco 1, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE: releases a claim (MarkSlotAsFree).

Argumento	Tipo	Descrição
claim	string	obrigatório. Claim id returned by so_claim_slot ('#').
behaviorClass	string	so_use_slot: behavior definition class to use (must be on the slot or the definition).

Retorna: claim, claims, count.

ai.so_remove_behavior_definition (risco 2, altera, UE 5.3+, requer plugin SmartObjects, smoke)

Removes a behavior definition from a slot by index.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index. Padrão 0.
behaviorClass	string	so_add_behavior_definition: concrete USmartObjectBehaviorDefinition class (see so_list_behavior_definition_classes).
index	integer	so_remove_behavior_definition: index in the slot's behavior definition list. Padrão 0.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_set_definition_tags (risco 2, altera, UE 5.3+, requer plugin SmartObjects, smoke)

Sets the definition-level activity tags and user tag filter.

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
activityTags	array of string	Replace the definition activity tags with these.
setActivityTags	boolean	Apply activityTags. Padrão false.
userTagFilterAnyTags	array of string	User tag filter: users need any of these tags (empty clears the filter).
setUserTagFilter	boolean	Apply userTagFilterAnyTags. Padrão false.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_set_slot (risco 2, altera, UE 5.3+, requer plugin SmartObjects, smoke)

Edits a slot with typed fields (name, offset, rotation, enabled, activity/runtime tags, user tag filter).

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	obrigatório. Slot index.
name	string	New slot name; empty keeps it.
offset	{x,y,z}	New offset in cm (applied when setOffset is true).
setOffset	boolean	Apply offset. Padrão false.
rotation	{x,y,z}	New rotation pitch/yaw/roll (applied when setRotation is true).
setRotation	boolean	Apply rotation. Padrão false.
enabled	string	true/false enables/disables the slot; empty keeps it.
activityTags	array of string	Replace the activity tags with these (empty array with setActivityTags=true clears them).
setActivityTags	boolean	Apply activityTags. Padrão false.
runtimeTags	array of string	Replace the initial runtime tags with these.
setRuntimeTags	boolean	Apply runtimeTags. Padrão false.
userTagFilterAnyTags	array of string	User tag filter: users need any of these tags (empty with setUserTagFilter=true clears the filter).
setUserTagFilter	boolean	Apply userTagFilterAnyTags. Padrão false.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_set_slot_property (risco 2, altera, UE 5.0+, requer plugin SmartObjects, smoke)

Writes a reflected slot property from text (for fields without a typed setter).

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.
slot	integer	Slot index returned by so_list_slots. Padrão 0.
property	string	Reflected slot-definition property name (so_get/set_slot_property).
value	string	Text-export value for the slot property (so_set_slot_property).

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.so_spawn_runtime_object (risco 1, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE fixture: spawns an actor with a Smart Object component (definition asset, or a transient definition with slotCount slots of behaviorClass).

Argumento	Tipo	Descrição
label	string	obrigatório. Label of the new actor (must be unused).
definition	string	Definition asset; leave empty with transientDefinition=true.
transientDefinition	boolean	Build a transient definition (slotCount slots, one behaviorClass definition each) instead of using an asset. Padrão false.
slotCount	integer	Slots of the transient definition (1-16). Padrão 1.
behaviorClass	string	Behavior definition class of the transient slots (concrete USmartObjectBehaviorDefinition subclass).
location	{x,y,z}	Spawn location.

Retorna: world, objects, results, count, changedActors.

ai.so_use_slot (risco 1, UE 5.6+, requer plugin SmartObjects, requer PIE, smoke)

PIE: starts using a claimed slot (MarkSlotAsOccupied) with a behavior definition class and returns the behavior definition.

Argumento	Tipo	Descrição
claim	string	obrigatório. Claim id returned by so_claim_slot ('#').
behaviorClass	string	so_use_slot: behavior definition class to use (must be on the slot or the definition).

Retorna: claim, claims, count.

ai.so_validate (risco 0, UE 5.0+, requer plugin SmartObjects, smoke)

Runs USmartObjectDefinition::Validate and returns the result (messages on UE 5.2+).

Argumento	Tipo	Descrição
definition	string	obrigatório. Smart Object definition asset path or unique asset name.

Retorna: definition, slotCount, message, slots, activityTags, userTagFilter, valid, messages.

ai.spawn_ai (risco 1, requer PIE, smoke)

Spawns an AI pawn (default Character) possessed by an AIController in the PIE world. With testTree it also builds a transient Blackboard (TargetActor, PatrolIndex, HomeLocation, IsAlert) and a Selector+Wait tree at /Engine/Transient.BT_AiSmokeRuntime; perception gives the controller sight/hearing/damage; stimuliSource makes the pawn perceivable.

Argumento	Tipo	Descrição
label	string	Pawn label in the PIE world. Padrão TEXT("AiTestPawn").
controllerLabel	string	Controller label; empty uses label + "Controller".
location	{x,y,z}	Spawn location in centimetres.
pawnClass	string	Pawn class path or name; empty spawns a Character.
controllerClass	string	AIController class path or name; empty spawns a plain AAIController.
behaviorTree	string	Behavior Tree asset to run right away (optional).
testTree	boolean	Build the transient test Blackboard + Behavior Tree (/Engine/Transient.BT_AiSmokeRuntime) without running it. Padrão false.
perception	boolean	Give the controller an AIPerception component with sight, hearing and damage senses. Padrão false.
stimuliSource	boolean	Give the pawn a stimuli source registered for sight and hearing. Padrão false.

Retorna: pawn, pawnLabel, controller, controllerLabel, testTree, values, count, state, message.

ai.spawn_test_actor (risco 2, altera, requer mundo, smoke)

Spawns a labelled Pawn (tagged UeaAiTest) in the editor world, or the PIE world while PIE runs, optionally with AIPerception and stimuli-source components; a fixture for perception experiments.

Argumento	Tipo	Descrição
label	string	obrigatório. Actor label; must not already be used by another actor.
location	{x,y,z}	Spawn location in centimetres.
pawnClass	string	Pawn class path or name; empty spawns a plain Pawn.
perception	boolean	Add an AIPerceptionComponent. Padrão true.
stimuliSource	boolean	Add an AIPerceptionStimuliSourceComponent. Padrão false.

Retorna: actor, actorLabel, component, dominantSense, senses, senseConfigs, count, created, warnings, message.

ai.stimuli_add_source (risco 2, altera, requer mundo, smoke)

Adds (or updates) an AIPerceptionStimuliSource component: the senses it is a source for and auto registration. Empty senses keep the current list.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor that should be perceivable.
senses	array of string	AISense classes to register for (AISense_Sight, /Script/AIModule.AISense_Hearing...).
autoRegister	boolean	Register automatically when play begins. Padrão true.

Retorna: actor, actorLabel, component, autoRegister, senses, created, message.

ai.stimuli_get_source (risco 0, requer mundo, smoke)

Returns the stimuli source component of an actor.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, autoRegister, senses, created, message.

ai.stimuli_register_sense (risco 2, altera, requer PIE, smoke)

Registers an actor's stimuli source for one sense now (live registration).

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with an AIPerceptionStimuliSource component (PIE world).
sense	string	obrigatório. AISense class (AISense_Sight, /Script/AIModule.AISense_Hearing...).

Retorna: actor, actorLabel, component, autoRegister, senses, created, message.

ai.stimuli_remove_source (risco 3, altera, destrutivo, requer mundo, smoke)

Unregisters and removes a stimuli source component that was added to the actor instance.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor label, name, or class: in the editor world (PIE world while PIE runs).

Retorna: actor, actorLabel, component, autoRegister, senses, created, message.

ai.stimuli_unregister_sense (risco 2, altera, requer PIE, smoke)

Unregisters an actor's stimuli source from one sense now.

Argumento	Tipo	Descrição
actor	string	obrigatório. Actor with an AIPerceptionStimuliSource component (PIE world).
sense	string	obrigatório. AISense class (AISense_Sight, /Script/AIModule.AISense_Hearing...).

Retorna: actor, actorLabel, component, autoRegister, senses, created, message.

ai.stop_movement (risco 2, altera, requer PIE, smoke)

Stops the current move.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.stop_tree (risco 2, altera, requer PIE, smoke)

Stops the controller's brain logic.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.

ai.unpossess (risco 2, altera, requer PIE, smoke)

Unpossesses the current pawn.

Argumento	Tipo	Descrição
controller	string	obrigatório. AI controller actor path, label, or unique name.
target	string	Pawn, target actor, or behavior tree reference as required by the action.
location	{x,y,z}	World-space destination for movement.
acceptanceRadius	number	Acceptance radius in centimeters; negative uses the engine default. Padrão -1.f.
key	string	Blackboard key for the typed value action.
type	string	bool, int, float, string, name, vector, rotator, object, class, or enum.
value	string	Text value for scalar and name types.
priority	string	Focus priority for focus tools: Default, Move or Gameplay. Padrão TEXT("Gameplay").

Retorna: controller, blackboard, values, count, state, requestResult, moveRequestId, message.