Saltar al contenido principal

Kit ai

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

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

Guía​

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.

PrefixAreaWorld
ai.create_test_setup, ai.list_assets, ai.list_*_classesshared fixtures, inventoryassets
ai.bb_*Blackboard assets and keysassets
ai.bt_*Behavior Tree runtime hierarchyassets
ai.eqs_*EQS queries: options, generators, tests, contexts, recipes, export/import, audit, runassets; ai.eqs_run editor or PIE world
ai.perception_*, ai.stimuli_add/get/remove_source, ai.spawn_test_actor, ai.{set,get}_pawn_ai_settingsperception components, senses, presets, stimuli sources, pawn AI settingseditor world (PIE world while PIE runs)
ai.spawn_ai, controller tools, ai.runtime_get_perception, ai.report_*, ai.stimuli_{register,unregister}_sense, teamsAI agents at run timePIE 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)​

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

Herramientas​

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

ai.audit_controllers (riesgo 0, requiere PIE, smoke)​

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

Sin argumentos.

Devuelve: controllers, count, issues, message.

ai.bb_add_key (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name.
typestringobligatorio. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClassstringBase class filter for class and object keys.
enumstringEnum asset path for enum keys, or native enum name for nativeEnum keys.
descriptionstringOptional editor description.
categorystringOptional editor category.
instanceSyncedbooleanSynchronize this key between compatible blackboard instances. Valor predeterminado false.

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

ai.bb_add_keys (riesgo 2, modifica, smoke)​

Adds several keys in one call.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
keysarray of UeaAiBbKeySpecobligatorio. Keys to add.

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

ai.bb_audit_filters (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_create (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game.
namestringobligatorio. Bare asset name.
parentstringOptional parent blackboard asset.

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

ai.bb_delete (riesgo 3, modifica, destructivo, smoke)​

Deletes a blackboard asset (refused while referenced).

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_diff (riesgo 0, smoke)​

Compares two blackboard schemas key by key.

ArgumentoTipoDescripción
blackboardstringobligatorio. Left blackboard.
otherstringobligatorio. Right blackboard.
includeInheritedbooleanCompare the flattened schema including parent keys (false compares local keys only). Valor predeterminado true.

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

ai.bb_duplicate (riesgo 2, modifica, smoke)​

Duplicates a blackboard asset.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
folderstringDestination folder; source folder when empty.
namestringobligatorio. New asset name.

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

ai.bb_export_schema (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_find_key_usages (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_find_references (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringOnly report this key name; empty reports every key reference.
folderstringContent folder searched for behavior trees. Valor predeterminado TEXT("/Game").

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

ai.bb_get (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_get_inherited_keys (riesgo 0, smoke)​

Inherited keys only.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_get_key_filter (riesgo 0, smoke)​

Class or enum filter of one key.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name (local or inherited).

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

ai.bb_get_key_id (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name (local or inherited).

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

ai.bb_get_key_schema (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name (local or inherited).

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

ai.bb_get_key_sync (riesgo 0, smoke)​

Instance synchronization flag of one key.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name (local or inherited).

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

ai.bb_get_local_keys (riesgo 0, smoke)​

Local keys only.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_get_parent_chain (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_import (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Target blackboard asset path or unique name.
keysarray of UeaAiBbKeySpecobligatorio. Key schema to apply (the keys array returned by ai.bb_export_schema). Inherited keys are skipped.
modestringmerge: add missing keys and rewrite same-type keys; replace: also remove local keys not listed and retype listed ones. Valor predeterminado TEXT("merge").

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

ai.bb_list (riesgo 0, smoke)​

Lists blackboard assets in a folder.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

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

ai.bb_list_keys (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_move_key (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Local key name.
indexintegerobligatorio. Destination local-key index, zero based.

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

ai.bb_refresh_schema (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bb_remove_key (riesgo 3, modifica, destructivo, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name.
typestringobligatorio. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClassstringBase class filter for class and object keys.
enumstringEnum asset path for enum keys, or native enum name for nativeEnum keys.
descriptionstringOptional editor description.
categorystringOptional editor category.
instanceSyncedbooleanSynchronize this key between compatible blackboard instances. Valor predeterminado false.

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

ai.bb_rename_key (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Current local key name.
newNamestringobligatorio. New key name.

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

ai.bb_set_bool (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValuebooleanDefault value. Valor predeterminado false.

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

ai.bb_set_class (riesgo 2, modifica, UE 5.5+, smoke)​

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

ArgumentoTipoDescripción
baseClassstringobligatorio. Base class filter, e.g. Actor or /Script/Engine.Pawn.
defaultValuestringDefault class (must derive from baseClass); empty for none.

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

ai.bb_set_enum (riesgo 2, modifica, UE 5.5+, smoke)​

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

ArgumentoTipoDescripción
enumstringobligatorio. Enum type: UserDefinedEnum asset path or native /Script/Module.EnumName.
defaultValuestringDefault enumerator name (short or qualified); empty selects the first enumerator.

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

ai.bb_set_float (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValuenumberDefault value. Valor predeterminado 0.0f.

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

ai.bb_set_int (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValueintegerDefault value. Valor predeterminado 0.

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

ai.bb_set_key (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Key name.
typestringobligatorio. bool, int, float, string, name, vector, rotator, enum, nativeEnum, class, or object.
baseClassstringBase class filter for class and object keys.
enumstringEnum asset path for enum keys, or native enum name for nativeEnum keys.
descriptionstringOptional editor description.
categorystringOptional editor category.
instanceSyncedbooleanSynchronize this key between compatible blackboard instances. Valor predeterminado false.

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

ai.bb_set_key_filter (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Local key name.
baseClassstringNew base class filter (class and object keys), e.g. Pawn or /Script/Engine.Pawn.
enumstringNew enum (enum keys: UserDefinedEnum path or /Script/Module.EnumName; nativeEnum keys: enum name).

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

ai.bb_set_key_sync (riesgo 2, modifica, smoke)​

Changes only the instance synchronization flag of a local key.

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
namestringobligatorio. Local key name.
instanceSyncedbooleanobligatorio. Synchronize the key value between every blackboard component that uses this asset.

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

ai.bb_set_name (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValuestringDefault value (a name).

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

ai.bb_set_object (riesgo 2, modifica, UE 5.5+, smoke)​

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

ArgumentoTipoDescripción
baseClassstringobligatorio. Base class filter, e.g. Actor or /Script/Engine.Pawn.
defaultValuestringDefault object path (an asset that is a baseClass); empty for none.

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

ai.bb_set_parent (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.
parentstringParent blackboard; empty clears the parent.

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

ai.bb_set_rotator (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValue{x,y,z}Default value {x=pitch,y=yaw,z=roll}.
useDefaultbooleanUse defaultValue as the initial value (false leaves the key unset at start). Valor predeterminado true.

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

ai.bb_set_string (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValuestringDefault value.

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

ai.bb_set_vector (riesgo 2, modifica, UE 5.4+, smoke)​

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

ArgumentoTipoDescripción
defaultValue{x,y,z}Default value {x,y,z}.
useDefaultbooleanUse defaultValue as the initial value (false leaves the key unset at start). Valor predeterminado true.

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

ai.bb_validate (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bt_add_blackboard_decorator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardKeystringobligatorio. Key tested by the condition.
keyQuerystringisSet, isNotSet (bool/object/class/vector/rotator keys); equal, notEqual, less, lessOrEqual, greater, greaterOrEqual (int/float/enum); equal, notEqual, contains, notContains (string/name). Valor predeterminado TEXT("isSet").
valuestringCompared value for arithmetic and text queries.
notifyObserverstringWhen observers re-evaluate: resultChange or valueChange. Valor predeterminado TEXT("resultChange").

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

ai.bt_add_composite (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
typestringobligatorio. selector, sequence, simpleParallel, or a UBTCompositeNode class path.
parentstringParent composite (see node reference forms); empty = root.
indexintegerChild index under the parent; -1 appends. Valor predeterminado -1.
namestringRuntime node name (unique in the tree).

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

ai.bt_add_cone_check_decorator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
coneHalfAnglenumberHalf angle of the cone in degrees. Valor predeterminado 45.0f.
coneOriginstringobligatorio. Cone origin key (vector or object).
coneDirectionstringobligatorio. Cone direction key (vector, rotator or object).
observedstringobligatorio. Observed location key (vector or object).

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

ai.bt_add_cooldown_decorator (riesgo 2, modifica, smoke)​

Adds a Cooldown decorator.

ArgumentoTipoDescripción
cooldownTimenumberCooldown in seconds. Valor predeterminado 5.0f.

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

ai.bt_add_default_focus_service (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardKeystringobligatorio. Focus key (object or vector).

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

ai.bt_add_finish_with_result (riesgo 2, modifica, smoke)​

Adds Finish With Result.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite (ID, root path or name); empty = root composite.
indexintegerChild index under the parent; -1 appends. Valor predeterminado -1.
namestringRuntime node name (unique in the tree); empty generates one.

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

ai.bt_add_is_at_location_decorator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardKeystringobligatorio. Location key (vector or object).
acceptableRadiusnumberAcceptable radius in cm. Valor predeterminado 50.0f.

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

ai.bt_add_loop_decorator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
numLoopsintegerNumber of loops (1..255). Valor predeterminado 3.
infinitebooleanLoop forever. Valor predeterminado false.
infiniteLoopTimeoutnumberTimeout of an infinite loop in seconds; negative = none. Valor predeterminado -1.0f.

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

ai.bt_add_make_noise (riesgo 2, modifica, smoke)​

Adds Make Noise.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite (ID, root path or name); empty = root composite.
indexintegerChild index under the parent; -1 appends. Valor predeterminado -1.
namestringRuntime node name (unique in the tree); empty generates one.

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

ai.bt_add_move_to (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
blackboardKeystringobligatorio. Goal key (vector or object key of the tree's blackboard).
acceptableRadiusnumberAcceptable radius in cm. Valor predeterminado 5.0f.
allowStrafebooleanAllow strafing. Valor predeterminado false.
allowPartialPathbooleanAccept a partial path when the goal is unreachable. Valor predeterminado true.
trackMovingGoalbooleanKeep following a moving goal actor. Valor predeterminado true.
observeBlackboardValuebooleanRestart the move when the goal key value changes. Valor predeterminado false.

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

ai.bt_add_play_animation (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
animationstringAnimation asset path; empty leaves it unset.
loopingbooleanLoop the animation. Valor predeterminado false.
nonBlockingbooleanFinish the task immediately instead of waiting for the animation. Valor predeterminado false.

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

ai.bt_add_play_sound (riesgo 2, modifica, smoke)​

Adds Play Sound: sound cue asset.

ArgumentoTipoDescripción
soundstringSound cue asset path; empty leaves it unset.

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

ai.bt_add_rotate_to_face (riesgo 2, modifica, smoke)​

Adds Rotate To Face BB Entry: key and precision.

ArgumentoTipoDescripción
blackboardKeystringobligatorio. Key to face (vector, rotator or object key).
precisionnumberSuccess angle precision in degrees. Valor predeterminado 10.0f.

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

ai.bt_add_run_behavior (riesgo 2, modifica, smoke)​

Adds Run Behavior with a sub-tree asset.

ArgumentoTipoDescripción
subtreestringobligatorio. Sub-tree behavior tree asset (must differ from the edited tree).

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

ai.bt_add_run_behavior_dynamic (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite (ID, root path or name); empty = root composite.
indexintegerChild index under the parent; -1 appends. Valor predeterminado -1.
namestringRuntime node name (unique in the tree); empty generates one.

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

ai.bt_add_run_eqs (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringEQS query asset; empty leaves the query unset.
blackboardKeystringobligatorio. Result key (vector or object key).
runModestringsingleResult, randomBest5Pct, randomBest25Pct or allMatching. Valor predeterminado TEXT("singleResult").

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

ai.bt_add_run_eqs_service (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringEQS query asset; empty leaves the query unset.
blackboardKeystringobligatorio. Result key (vector or object key).
runModestringsingleResult, randomBest5Pct, randomBest25Pct or allMatching. Valor predeterminado TEXT("singleResult").

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

ai.bt_add_runtime_decorator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_add_runtime_service (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_add_runtime_task (riesgo 2, modifica, smoke)​

Adds a task of any native or Blueprint BTTask class.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_add_time_limit_decorator (riesgo 2, modifica, smoke)​

Adds a Time Limit decorator.

ArgumentoTipoDescripción
timeLimitnumberTime limit in seconds. Valor predeterminado 5.0f.

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

ai.bt_add_wait (riesgo 2, modifica, smoke)​

Adds a Wait task.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite; empty = root.
indexintegerChild index under the parent; -1 appends. Valor predeterminado -1.
secondsnumberWait time in seconds. Valor predeterminado 1.0f.
randomDeviationnumberRandom deviation in seconds. Valor predeterminado 0.0f.
namestringRuntime node name.

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

ai.bt_arrange (riesgo 2, modifica, 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).

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
horizontalSpacingintegerHorizontal distance between leaf columns. Valor predeterminado 320.
verticalSpacingintegerVertical distance between tree levels. Valor predeterminado 220.

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

ai.bt_chase_attack_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite; empty = root composite.
indexintegerChild index; -1 appends (put it before patrol branches under a selector). Valor predeterminado -1.
prefixstringName prefix of the created nodes. Valor predeterminado TEXT("Chase").
targetKeystringobligatorio. Target actor key (object key).
attackRangenumberDistance at which the attack starts, in cm. Valor predeterminado 150.0f.
attackTaskstringAttack task class; empty uses a Wait of attackSeconds as a placeholder.
attackSecondsnumberPlaceholder attack duration in seconds. Valor predeterminado 1.0f.
abortModestringAbort mode of the target condition (both lets the branch preempt lower-priority branches). Valor predeterminado TEXT("both").

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

ai.bt_create (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game.
namestringobligatorio. Bare asset name.
blackboardstringOptional blackboard asset.

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

ai.bt_duplicate_node (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_export (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.

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

ai.bt_find_runtime_node (riesgo 0, smoke)​

Finds one node by ID, root path or name.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_get (riesgo 0, smoke)​

Returns the asset and its blackboard.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.

Devuelve: asset, blackboard, message.

ai.bt_get_node (riesgo 0, smoke)​

One node by ID, root path or name.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
nodestringobligatorio. Node reference (ID, root path or name).

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

ai.bt_get_runtime_hierarchy (riesgo 0, smoke)​

Regenerated runtime hierarchy.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_get_runtime_property (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_get_tree (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.

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

ai.bt_import (riesgo 3, modifica, destructivo, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Target Behavior Tree asset (its runtime tree is replaced).
nodesarray of UeaAiBtSpecNodeobligatorio. Nodes as returned by ai.bt_export.
blackboardstringOptional blackboard to assign before key selectors are resolved.

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

ai.bt_investigate_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite; empty = root composite.
indexintegerChild index; -1 appends. Valor predeterminado -1.
prefixstringName prefix of the created nodes. Valor predeterminado TEXT("Investigate").
locationKeystringobligatorio. Location to investigate (vector or object key).
conditionKeystringOptional bool key that must be set (e.g. IsAlert).
acceptableRadiusnumberAcceptable radius of the move in cm. Valor predeterminado 100.0f.
lookSecondsnumberTime spent looking around in seconds. Valor predeterminado 3.0f.

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

ai.bt_list (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.

Devuelve: nodes, count, message.

ai.bt_list_nodes (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.

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

ai.bt_move_node (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_patrol_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite; empty = root composite.
indexintegerChild index; -1 appends. Valor predeterminado -1.
prefixstringName prefix of the created nodes. Valor predeterminado TEXT("Patrol").
locationKeystringobligatorio. Patrol location key (vector or object).
acceptableRadiusnumberAcceptable radius of the move in cm. Valor predeterminado 50.0f.
waitSecondsnumberWait at the point in seconds. Valor predeterminado 2.0f.

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

ai.bt_remove_node (riesgo 3, modifica, destructivo, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_set_abort (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
nodestringobligatorio. Decorator (ID, root path or name).
abortModestringobligatorio. none, self, lowerPriority or both (the parent composite decides which are valid).

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

ai.bt_set_blackboard (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
blackboardstringobligatorio. Blackboard asset path or unique name.

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

ai.bt_set_blackboard_selector (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
nodestringobligatorio. Node (ID, root path or name).
propertystringobligatorio. Key selector property (e.g. BlackboardKey, ConeOrigin, EQSRequest.EQSQueryBlackboardKey).
keystringobligatorio. Key name from the tree's blackboard chain; "None" clears selectors that allow it.

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

ai.bt_set_decorator_logic (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
nodestringobligatorio. Decorated child (ID, root path or name).
expressionstringExpression over the child's decorator names: and(...), or(...), not(x); every decorator exactly once. Empty = all must pass.

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

ai.bt_set_node_property (riesgo 2, modifica, smoke)​

Sets a reflected node property from text.

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
nodestringobligatorio. Node reference (ID, root path or name).
propertystringobligatorio. Reflected property name (dotted paths enter structs).
valuestringobligatorio. Value in Unreal text-export form.

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

ai.bt_set_root (riesgo 3, modifica, destructivo, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_set_runtime_node_name (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_set_runtime_property (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.bt_validate_runtime_hierarchy (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
behaviorTreestringobligatorio. Behavior Tree asset path or unique name.
parentstringParent composite for add or move operations; empty addresses the root composite.
nodestringExisting node (ID, root path or name) for get, remove, move, duplicate, or property operations.
classstringNative or Blueprint BT node class for generic add operations.
namestringName for a new or renamed node (unique in the tree).
propertystringReflected property name.
valuestringText-export value for a reflected property.
indexintegerChild (or decorator/service) position; -1 appends. Valor predeterminado -1.

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

ai.clear_blackboard_value (riesgo 2, modifica, requiere PIE, smoke)​

Clears a Blackboard value.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.
keystringobligatorio. Blackboard key name.
typestringobligatorio. bool, int, float, string, name, vector, rotator, enum, object or class.
valuestringText 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).

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

ai.clear_focus (riesgo 2, modifica, requiere PIE, smoke)​

Clears the focus at priority.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.create_test_setup (riesgo 2, modifica, 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).

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game for the Blackboard and runtime Behavior Tree fixtures.

Devuelve: assets, count, warnings, message.

ai.despawn_ai (riesgo 1, modifica, destructivo, requiere PIE, smoke)​

Destroys an AI controller and its pawn.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.

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

ai.eqs_add_option (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_add_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_audit (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
folderstringContent folder to audit. Valor predeterminado TEXT("/Game").
recursivebooleanInclude subfolders. Valor predeterminado true.

Devuelve: queries, count, withIssues, message.

ai.eqs_audit_options (riesgo 0, smoke)​

Reports options without a generator and options without tests.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_clear_tests (riesgo 3, modifica, destructivo, smoke)​

Removes every test of an option.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_configure_actors_of_class (riesgo 2, modifica, smoke)​

Configures an Actors Of Class generator.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be ActorsOfClass. Valor predeterminado 0.
searchedActorClassstringobligatorio. Actor class to collect (path or unique name).
searchRadiusnumberSearch radius in cm (> 0). Valor predeterminado 2000.f.
onlyInRadiusbooleanOnly generate actors inside the radius. Valor predeterminado true.
searchCenterstringContext at the search centre; empty keeps the current one.

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

ai.eqs_configure_circle (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be OnCircle. Valor predeterminado 0.
radiusnumberCircle radius in cm (> 0). Valor predeterminado 500.f.
numberOfPointsintegerWhen > 0 the points are spaced by count (ByNumberOfPoints); otherwise by spaceBetween. Valor predeterminado 0.
spaceBetweennumberDistance between points in cm when numberOfPoints is 0 (> 0). Valor predeterminado 100.f.
circleCenterstringContext at the circle centre; empty keeps the current one.
arcAnglenumberArc angle in degrees; 0 or 360 generates the full circle. Valor predeterminado 360.f.

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

ai.eqs_configure_cone (riesgo 2, modifica, smoke)​

Configures a Points: Cone generator.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be Cone. Valor predeterminado 0.
coneDegreesnumberCone angle in degrees (0..359). Valor predeterminado 90.f.
rangenumberCone length in cm (> 0). Valor predeterminado 1000.f.
angleStepnumberAngle between generated lines in degrees (> 0). Valor predeterminado 10.f.
alignedPointsDistancenumberDistance between points on each line in cm (> 0). Valor predeterminado 100.f.
centerActorstringContext at the cone apex; empty keeps the current one.

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

ai.eqs_configure_current_location (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be CurrentLocation. Valor predeterminado 0.
queryContextstringobligatorio. Context whose location(s) become the items.

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

ai.eqs_configure_distance_test (riesgo 2, modifica, smoke)​

Configures a Distance test (mode and context).

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Distance. Valor predeterminado 0.
testModestringDistance3D, Distance2D, DistanceZ or DistanceAbsoluteZ. Valor predeterminado TEXT("Distance3D").
distanceTostringContext measured to; empty keeps the current one.

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

ai.eqs_configure_donut (riesgo 2, modifica, smoke)​

Configures a Points: Donut generator.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be Donut. Valor predeterminado 0.
innerRadiusnumberInner radius in cm (>= 0). Valor predeterminado 300.f.
outerRadiusnumberOuter radius in cm (> innerRadius). Valor predeterminado 1000.f.
numberOfRingsintegerNumber of rings (>= 1). Valor predeterminado 3.
pointsPerRingintegerPoints per ring (>= 1). Valor predeterminado 8.
centerstringContext at the donut centre; empty keeps the current one.

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

ai.eqs_configure_dot_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Dot. Valor predeterminado 0.
lineAFromstringLine A start context; empty keeps.
lineATostringLine A end context; empty keeps.
lineBFromstringLine B start context; empty keeps.
lineBTostringLine B end context; empty keeps.
testModestringDot3D or Dot2D. Valor predeterminado TEXT("Dot3D").
absoluteValuebooleanUse the absolute value of the dot product. Valor predeterminado false.

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

ai.eqs_configure_grid (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be a SimpleGrid (or subclass). Valor predeterminado 0.
gridSizenumberHalf extent of the square grid in cm (> 0). Valor predeterminado 1000.f.
spaceBetweennumberDistance between grid points in cm (> 0). Valor predeterminado 100.f.
generateAroundstringContext the grid is centred on; empty keeps the current one.

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

ai.eqs_configure_overlap_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Overlap. Valor predeterminado 0.
shapestringBox, Sphere or Capsule. Valor predeterminado TEXT("Sphere").
extent{x,y,z}Shape extent in cm (sphere uses x as radius; capsule uses x radius, z half height). Valor predeterminado FUeaVec3(50.0, 50.0, 50.0).
channelstringCollision channel (ECC_WorldStatic, ECC_WorldDynamic, ECC_Pawn, ECC_Visibility...); empty keeps the current channel.
onlyBlockingHitsbooleanCount blocking hits only. Valor predeterminado true.
overlapComplexbooleanOverlap complex collision. Valor predeterminado false.
skipOverlapQuerierbooleanIgnore the querier in the overlap. Valor predeterminado true.
expectOverlapbooleanExpected overlap result for the Match filter (false keeps free points). Valor predeterminado false.

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

ai.eqs_configure_pathfinding_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Pathfinding. Valor predeterminado 0.
testModestringPathExist, PathCost or PathLength. Valor predeterminado TEXT("PathExist").
contextstringContext the path goes to or from; empty keeps the current one.
pathFromContextbooleanPath from the context to the item (false: item to context). Valor predeterminado true.
skipUnreachablebooleanDiscard unreachable items for PathCost/PathLength. Valor predeterminado true.

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

ai.eqs_configure_pathing_grid (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must be PathingGrid. Valor predeterminado 0.
pathToItembooleantrue: path from context to items; false: from items to context. Valor predeterminado true.
scanRangeMultipliernumberMultiplier of the navigation scan range (> 0). Valor predeterminado 1.5f.
navigationFilterstringUNavigationQueryFilter subclass; empty keeps the current filter.

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

ai.eqs_configure_project_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Project. Valor predeterminado 0.
traceModestringobligatorio. EEnvQueryTrace value (None, Navigation, NavigationOverLedges, Geometry on 4.27, GeometryByChannel/GeometryByProfile on 5.x).
projectDownnumberDownward projection distance in cm. Valor predeterminado 1024.f.
projectUpnumberUpward projection distance in cm. Valor predeterminado 1024.f.

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

ai.eqs_configure_trace_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; the test must be EnvQueryTest_Trace. Valor predeterminado 0.
contextstringContext traced to or from; empty keeps the current one.
traceFromContextbooleanTrace from the context towards the item (false: from the item). Valor predeterminado true.
itemHeightOffsetnumberItem height offset in cm. Valor predeterminado 0.f.
contextHeightOffsetnumberContext height offset in cm. Valor predeterminado 0.f.
traceShapestringLine, Box, Sphere or Capsule. Valor predeterminado TEXT("Line").
expectHitbooleanExpected trace hit (true: item hidden from context, i.e. cover). Applied as a Match filter. Valor predeterminado true.

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

ai.eqs_cover_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. New /Game package path of the query (must not exist).
radiusnumberGrid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Valor predeterminado 1000.f.
spaceBetweennumberPoint spacing in cm (grid recipes). Valor predeterminado 150.f.
numberOfPointsintegerNumber of points on the circle (points around target). Valor predeterminado 12.
targetContextstringContext to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

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

ai.eqs_create (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_create_context_blueprint (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game.
namestringobligatorio. Blueprint asset name.

Devuelve: blueprint, generatedClass, parentClass, message.

ai.eqs_create_generator_blueprint (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game.
namestringobligatorio. Blueprint asset name.

Devuelve: blueprint, generatedClass, parentClass, message.

ai.eqs_delete (riesgo 3, modifica, destructivo, smoke)​

Deletes the query asset.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_duplicate (riesgo 2, modifica, smoke)​

Duplicates a query asset to newPath.

ArgumentoTipoDescripción
querystringobligatorio. Source EQS query asset path or unique name.
newPathstringobligatorio. Destination /Game package path of the copy (must not exist).

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

ai.eqs_duplicate_option (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index to copy. Valor predeterminado 0.
indexintegerInsert position of the copy; -1 appends. Valor predeterminado -1.

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

ai.eqs_export (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

Devuelve: asset, options, message.

ai.eqs_export_runtime_schema (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_get (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

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

ai.eqs_get_generator (riesgo 0, smoke)​

Returns the generator of an option with its editable properties.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_get_option_count (riesgo 0, smoke)​

Returns the number of options in count.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_get_test (riesgo 0, smoke)​

Returns a test with its editable properties.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_get_test_count (riesgo 0, smoke)​

Returns the number of tests of an option in count.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_import (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. /Game package path of the query to build.
optionsarray of UeaAiEqsOptionSpecobligatorio. Options in execution order (the ai.eqs_export format).
replacebooleanWhen the query exists: true replaces all its options, false fails with E_CONFLICT. Valor predeterminado false.

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

ai.eqs_list (riesgo 0, smoke)​

Lists EQS query assets under a folder.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: queries, count, message.

ai.eqs_list_context_classes (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

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

ai.eqs_list_generator_classes (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

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

ai.eqs_list_test_classes (riesgo 0, smoke)​

Lists concrete test classes.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

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

ai.eqs_move_option (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_move_test (riesgo 2, modifica, smoke)​

Moves test test to position index inside its option.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_nearest_reachable_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. New /Game package path of the query (must not exist).
radiusnumberGrid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Valor predeterminado 1000.f.
spaceBetweennumberPoint spacing in cm (grid recipes). Valor predeterminado 150.f.
numberOfPointsintegerNumber of points on the circle (points around target). Valor predeterminado 12.
targetContextstringContext to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

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

ai.eqs_points_around_target_recipe (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. New /Game package path of the query (must not exist).
radiusnumberGrid half extent (cover, nearest reachable) or circle radius (points around target) in cm. Valor predeterminado 1000.f.
spaceBetweennumberPoint spacing in cm (grid recipes). Valor predeterminado 150.f.
numberOfPointsintegerNumber of points on the circle (points around target). Valor predeterminado 12.
targetContextstringContext to hide from (cover) or to surround (points around target); empty uses EnvQueryContext_Querier.

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

ai.eqs_remove_option (riesgo 3, modifica, destructivo, smoke)​

Removes option option.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_remove_test (riesgo 3, modifica, destructivo, smoke)​

Removes test test from option option.

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_replace_generator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_run (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
querierstringobligatorio. Querier actor (label, name, or class:); contexts such as EnvQueryContext_Querier resolve to it.
runModestringSingleResult, RandomBest5Pct, RandomBest25Pct or AllMatching. Valor predeterminado TEXT("AllMatching").
maxItemsintegerMaximum number of items in the reply (1..1000). Valor predeterminado 50.

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

ai.eqs_set_context (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index; -1 targets the option's generator. Valor predeterminado -1.
propertystringobligatorio. Context property name or dotted path (GenerateAround, CircleCenter, DistanceTo, Context, LineA.LineFrom...).
contextstringobligatorio. UEnvQueryContext subclass (EnvQueryContext_Querier, EnvQueryContext_Item, a Blueprint context...).

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

ai.eqs_set_generator (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_set_projection (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index; its generator must derive from EnvQueryGenerator_ProjectedPoints. Valor predeterminado 0.
traceModestringobligatorio. EEnvQueryTrace value: None, Navigation, NavigationOverLedges, and Geometry (4.27) or GeometryByChannel/GeometryByProfile (5.x).
projectDownnumberDownward projection distance in cm. Valor predeterminado 1024.f.
projectUpnumberUpward projection distance in cm. Valor predeterminado 1024.f.
postProjectionVerticalOffsetnumberVertical offset added after projection in cm. Valor predeterminado 0.f.

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

ai.eqs_set_strip_from_client_builds (riesgo 2, modifica, UE 5.8+, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
stripbooleanDo not cook the query into client builds (server-only AI). Valor predeterminado true.

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

ai.eqs_set_test (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_set_test_filter (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index. Valor predeterminado 0.
filterTypestringobligatorio. Minimum, Maximum or Range for float tests; Match for bool tests.
minnumberLower bound (Minimum, Range). Valor predeterminado 0.f.
maxnumberUpper bound (Maximum, Range). Valor predeterminado 0.f.
matchbooleanExpected value for Match (bool tests such as Trace or Pathfinding PathExist). Valor predeterminado true.
purposestringFilter, Score or FilterAndScore; empty keeps the current purpose.

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

ai.eqs_set_test_scoring (riesgo 2, modifica, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index. Valor predeterminado 0.
purposestringFilter, Score or FilterAndScore.
scoringEquationstringLinear, Square, InverseLinear, SquareRoot or Constant.
scoringFactornumberWeight (> 0); 0 keeps the current value. Valor predeterminado 0.f.
clampMinTypestringNone, SpecifiedValue or FilterThreshold; SpecifiedValue uses scoreClampMin.
clampMaxTypestringNone, SpecifiedValue or FilterThreshold; SpecifiedValue uses scoreClampMax.
scoreClampMinnumberLower clamp value when clampMinType is SpecifiedValue. Valor predeterminado 0.f.
scoreClampMaxnumberUpper clamp value when clampMaxType is SpecifiedValue. Valor predeterminado 0.f.
commentstringDesigner comment; empty keeps the current comment.

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

ai.eqs_validate (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.

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

ai.eqs_validate_option (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.eqs_validate_test (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
querystringobligatorio. EQS query asset path or unique name.
classstringGenerator, test, or context class path.
optionintegerZero-based option index. Valor predeterminado 0.
testintegerZero-based test index within option. Valor predeterminado 0.
indexintegerDestination index for insert/reorder operations; -1 appends (insert) and is invalid for moves. Valor predeterminado -1.
propertystringReflected property name on the option generator or test.
valuestringText-export value for a reflected property.

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

ai.get_blackboard (riesgo 0, requiere PIE, smoke)​

Returns the Blackboard component asset of a controller.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.

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

ai.get_blackboard_key_schema (riesgo 0, requiere PIE, smoke)​

Returns the runtime Blackboard keys as name|type.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_blackboard_values (riesgo 0, requiere PIE, smoke)​

Every Blackboard key with its type and current value.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.

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

ai.get_brain_component (riesgo 0, requiere PIE, smoke)​

Returns the brain component.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_controlled_pawn (riesgo 0, requiere PIE, smoke)​

Returns the possessed pawn.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_controller (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.

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

ai.get_controller_location (riesgo 0, requiere PIE, smoke)​

Returns the pawn location.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_current_move_request (riesgo 0, requiere PIE, smoke)​

Returns the current move request id.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_focal_point (riesgo 0, requiere PIE, smoke)​

Returns the current focal point.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_focus (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_move_status (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_path_following_component (riesgo 0, requiere PIE, smoke)​

Returns the path following component.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.get_pawn_ai_settings (riesgo 0, requiere mundo, smoke)​

Returns AIControllerClass and AutoPossessAI of a level pawn.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.get_team_attitude (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Observer actor (usually an AI controller) in PIE.
targetstringobligatorio. Observed actor in PIE.

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

ai.get_tree_state (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.list_ai_controller_classes (riesgo 0, smoke)​

Sin descripción.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: assets, count, warnings, message.

ai.list_ai_controllers (riesgo 0, requiere PIE, smoke)​

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

Sin argumentos.

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

ai.list_assets (riesgo 0, smoke)​

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

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: assets, count, warnings, message.

ai.list_bt_decorator_classes (riesgo 0, smoke)​

Sin descripción.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: assets, count, warnings, message.

ai.list_bt_service_classes (riesgo 0, smoke)​

Sin descripción.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: assets, count, warnings, message.

ai.list_bt_task_classes (riesgo 0, smoke)​

Sin descripción.

ArgumentoTipoDescripción
folderstringContent folder to search. Valor predeterminado TEXT("/Game").
recursivebooleanSearch subfolders. Valor predeterminado true.

Devuelve: assets, count, warnings, message.

ai.move_to (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.pause_tree (riesgo 2, modifica, requiere PIE, smoke)​

Pauses the controller's brain logic.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.perception_add_component (riesgo 2, modifica, requiere 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.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_add_damage (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default damage config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_hearing (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default hearing config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_prediction (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default prediction config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_sense (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_sight (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default sight config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_team (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default team config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_add_touch (riesgo 2, modifica, requiere mundo, smoke)​

Adds a default touch config.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_animal_preset (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_audit (riesgo 0, requiere 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.

Sin argumentos.

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

ai.perception_configure_hearing (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
hearingRangenumberHearing range in cm (> 0). Valor predeterminado 3000.f.
maxAgenumberSeconds a noise is remembered; 0 = forever. Valor predeterminado 5.f.
affiliationUeaAiPerceptionAffiliationWho is detected.
dominantbooleanMake hearing the dominant sense. Valor predeterminado false.

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

ai.perception_configure_sight (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sightRadiusnumberRadius in cm at which targets are first seen (> 0). Valor predeterminado 3000.f.
loseSightRadiusnumberRadius in cm at which seen targets are lost (>= sightRadius). Valor predeterminado 3500.f.
peripheralVisionAnglenumberHalf angle of the vision cone in degrees (0..180). Valor predeterminado 90.f.
maxAgenumberSeconds a sighting is remembered; 0 = forever. Valor predeterminado 5.f.
autoSuccessRangenumberAuto-success range from the last seen location in cm; negative disables it. Valor predeterminado -1.f.
affiliationUeaAiPerceptionAffiliationWho is detected.
dominantbooleanMake sight the dominant sense. Valor predeterminado false.

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

ai.perception_forget_actor (riesgo 2, modifica, requiere mundo, smoke)​

Forgets one target actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_forget_all (riesgo 2, modifica, requiere mundo, smoke)​

Forgets every perceived actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_get_actor_stimuli (riesgo 0, requiere mundo, smoke)​

Stimuli remembered for one target actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get_config (riesgo 0, requiere mundo, smoke)​

Returns every sense config with its settings.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get_currently_perceived (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get_dominant (riesgo 0, requiere mundo, smoke)​

Returns the dominant sense.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get_known_perceived (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_get_sense (riesgo 0, requiere mundo, smoke)​

Returns one configured sense with every setting.

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sensestringobligatorio. Config class name or path (AISenseConfig_Sight, /Script/AIModule.AISenseConfig_Hearing...).

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

ai.perception_guard_preset (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_is_sense_enabled (riesgo 0, UE 5.4+, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_list_config_properties (riesgo 0, requiere mundo, smoke)​

Lists the property names of a configured sense.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_list_sense_classes (riesgo 0, smoke)​

Lists concrete UAISenseConfig classes.

Sin argumentos.

Devuelve: classes, count.

ai.perception_list_senses (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_remove_component (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.perception_remove_sense (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sensestringobligatorio. Config class name or path (AISenseConfig_Sight, /Script/AIModule.AISenseConfig_Hearing...).

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

ai.perception_request_listener_update (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_set_affiliation (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sensestringobligatorio. Config class name or path (Sight, Hearing, or Touch on 5.x).
affiliationUeaAiPerceptionAffiliationWho is detected.

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

ai.perception_set_dominant (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_set_max_age (riesgo 2, modifica, requiere mundo, smoke)​

Sets how long stimuli of one configured sense are remembered.

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sensestringobligatorio. Config class name or path.
maxAgenumberSeconds a stimulus stays known (>= 0; 0 = forever). Valor predeterminado 5.f.

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

ai.perception_set_sense (riesgo 2, modifica, requiere mundo, smoke)​

Sets one reflected setting of a configured sense from text.

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_set_sense_enabled (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor containing the AI Perception component.
classstringUAISenseConfig subclass for an add operation.
sensestringSense-config class or implementation-sense class to select.
propertystringReflected setting on the selected config.
valuestringText-export value for the setting.
targetstringStimulus target actor for runtime reporting.
strengthnumberLoudness or damage amount for the matching runtime report. Valor predeterminado 1.f.

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

ai.perception_set_starts_enabled (riesgo 2, modifica, requiere mundo, smoke)​

Sets whether one configured sense starts enabled.

ArgumentoTipoDescripción
actorstringobligatorio. Actor with the AIPerception component.
sensestringobligatorio. Config class name or path.
enabledbooleanSense active from the start. Valor predeterminado true.

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

ai.perception_sniper_preset (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.possess (riesgo 2, modifica, requiere PIE, smoke)​

Possesses a pawn (target).

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.remove_test_actor (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.report_damage (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
damagedstringobligatorio. Damaged actor (label); its perception component receives the event.
instigatorstringInstigator actor (label); empty = none.
amountnumberDamage amount (stimulus strength). Valor predeterminado 10.f.
location{x,y,z}Event location in cm; zero uses the instigator (or damaged) actor location.
tagstringOptional stimulus tag.

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

ai.report_noise (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
location{x,y,z}Noise location in cm.
loudnessnumberLoudness multiplier of the listeners' hearing range (> 0). Valor predeterminado 1.f.
instigatorstringActor that made the noise (label); empty = none.
maxRangenumberMaximum range in cm; 0 = listeners' hearing range only. Valor predeterminado 0.f.
tagstringOptional stimulus tag.

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

ai.report_touch (riesgo 2, modifica, UE 5.1+, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
receiverstringobligatorio. Actor that was touched (label); its perception component receives the event.
otherstringobligatorio. Actor that touched it (label).
location{x,y,z}Contact location in cm; zero uses the other actor location.

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

ai.restart_tree (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.resume_tree (riesgo 2, modifica, requiere PIE, smoke)​

Resumes paused brain logic.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.run_tree (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.runtime_get_perception (riesgo 0, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. AI controller or any actor owning an AIPerception component (PIE world).
includeExpiredbooleanInclude actors whose stimuli all expired. Valor predeterminado true.

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

ai.set_blackboard_value (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.
keystringobligatorio. Blackboard key name.
typestringobligatorio. bool, int, float, string, name, vector, rotator, enum, object or class.
valuestringText 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).

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

ai.set_focal_point (riesgo 2, modifica, requiere PIE, smoke)​

Focuses a world location at priority.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.set_focus (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.set_pawn_ai_settings (riesgo 2, modifica, requiere mundo, smoke)​

Sets AIControllerClass and/or AutoPossessAI on a level pawn.

ArgumentoTipoDescripción
actorstringobligatorio. Pawn label or name in the editor world.
controllerClassstringAIController class path or name; empty keeps the current class.
autoPossessAistringDisabled, PlacedInWorld, Spawned or PlacedInWorldOrSpawned; empty keeps the current value.

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

ai.set_team_id (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller label, name, or class: in the PIE world.
teamIdintegerTeam id 0..254; 255 means no team. Valor predeterminado 1.

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

ai.so_add_behavior_definition (riesgo 2, modifica, UE 5.3+, requiere el plugin SmartObjects, smoke)​

Adds a behavior definition instance of behaviorClass to a slot.

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index. Valor predeterminado 0.
behaviorClassstringso_add_behavior_definition: concrete USmartObjectBehaviorDefinition class (see so_list_behavior_definition_classes).
indexintegerso_remove_behavior_definition: index in the slot's behavior definition list. Valor predeterminado 0.

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

ai.so_add_slot (riesgo 2, modifica, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
namestringOptional 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+).
activityTagsarray of stringSlot activity tags (UE 5.3+).

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

ai.so_attach_definition (riesgo 2, modifica, UE 5.6+, requiere el plugin SmartObjects, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label/name in the editor world, or 'class:'. With spawnNew: label of the new actor.
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
spawnNewbooleanSpawn a new empty actor with this label instead of using an existing one. Valor predeterminado false.
location{x,y,z}Location of the new actor (spawnNew only).

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

ai.so_audit_slots (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.

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

ai.so_claim_slot (riesgo 1, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label of the Smart Object in the PIE world.
slotintegerSlot index on that Smart Object. Valor predeterminado 0.
prioritystringClaim priority: Low, BelowNormal, Normal, AboveNormal, High. Valor predeterminado TEXT("Normal").

Devuelve: claim, claims, count.

ai.so_create_definition (riesgo 2, modifica, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
folderstringobligatorio. Content folder under /Game.
namestringobligatorio. Bare asset name.

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

ai.so_duplicate_definition (riesgo 2, modifica, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Source definition asset path or unique asset name.
folderstringobligatorio. Destination folder under /Game.
namestringobligatorio. Bare name of the copy.

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

ai.so_find_slots (riesgo 0, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
location{x,y,z}Query center.
radiusnumberQuery half extent in cm (box). Valor predeterminado 5000.f.
activityTagsarray of stringSlots must match any of these activity tags (empty = no activity requirement).
behaviorClassstringOnly slots offering this behavior definition class.
includeClaimedbooleanInclude slots that are already claimed. Valor predeterminado false.
limitintegerMaximum results (1-500). Valor predeterminado 100.

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

ai.so_get_definition (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.

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

ai.so_get_slot (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index returned by so_list_slots. Valor predeterminado 0.
propertystringReflected slot-definition property name (so_get/set_slot_property).
valuestringText-export value for the slot property (so_set_slot_property).

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

ai.so_get_slot_property (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

Reads one reflected slot property as text.

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index returned by so_list_slots. Valor predeterminado 0.
propertystringReflected slot-definition property name (so_get/set_slot_property).
valuestringText-export value for the slot property (so_set_slot_property).

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

ai.so_list_behavior_definition_classes (riesgo 0, UE 5.3+, requiere el plugin SmartObjects, smoke)​

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

Sin argumentos.

Devuelve: classes, count.

ai.so_list_claims (riesgo 0, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

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

Sin argumentos.

Devuelve: claim, claims, count.

ai.so_list_definitions (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

Lists Smart Object definition assets under a folder.

ArgumentoTipoDescripción
folderstringContent folder to list. Valor predeterminado TEXT("/Game").
recursivebooleanInclude sub-folders. Valor predeterminado true.

Devuelve: definitions, count.

ai.so_list_slot_properties (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index returned by so_list_slots. Valor predeterminado 0.
propertystringReflected slot-definition property name (so_get/set_slot_property).
valuestringText-export value for the slot property (so_set_slot_property).

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

ai.so_list_slots (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

Lists the slots of a definition.

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.

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

ai.so_list_world_objects (riesgo 0, UE 5.6+, requiere el plugin SmartObjects, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringOptional actor label filter (exact).

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

ai.so_release_slot (riesgo 1, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

PIE: releases a claim (MarkSlotAsFree).

ArgumentoTipoDescripción
claimstringobligatorio. Claim id returned by so_claim_slot ('#').
behaviorClassstringso_use_slot: behavior definition class to use (must be on the slot or the definition).

Devuelve: claim, claims, count.

ai.so_remove_behavior_definition (riesgo 2, modifica, UE 5.3+, requiere el plugin SmartObjects, smoke)​

Removes a behavior definition from a slot by index.

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index. Valor predeterminado 0.
behaviorClassstringso_add_behavior_definition: concrete USmartObjectBehaviorDefinition class (see so_list_behavior_definition_classes).
indexintegerso_remove_behavior_definition: index in the slot's behavior definition list. Valor predeterminado 0.

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

ai.so_set_definition_tags (riesgo 2, modifica, UE 5.3+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
activityTagsarray of stringReplace the definition activity tags with these.
setActivityTagsbooleanApply activityTags. Valor predeterminado false.
userTagFilterAnyTagsarray of stringUser tag filter: users need any of these tags (empty clears the filter).
setUserTagFilterbooleanApply userTagFilterAnyTags. Valor predeterminado false.

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

ai.so_set_slot (riesgo 2, modifica, UE 5.3+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerobligatorio. Slot index.
namestringNew slot name; empty keeps it.
offset{x,y,z}New offset in cm (applied when setOffset is true).
setOffsetbooleanApply offset. Valor predeterminado false.
rotation{x,y,z}New rotation pitch/yaw/roll (applied when setRotation is true).
setRotationbooleanApply rotation. Valor predeterminado false.
enabledstringtrue/false enables/disables the slot; empty keeps it.
activityTagsarray of stringReplace the activity tags with these (empty array with setActivityTags=true clears them).
setActivityTagsbooleanApply activityTags. Valor predeterminado false.
runtimeTagsarray of stringReplace the initial runtime tags with these.
setRuntimeTagsbooleanApply runtimeTags. Valor predeterminado false.
userTagFilterAnyTagsarray of stringUser tag filter: users need any of these tags (empty with setUserTagFilter=true clears the filter).
setUserTagFilterbooleanApply userTagFilterAnyTags. Valor predeterminado false.

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

ai.so_set_slot_property (riesgo 2, modifica, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.
slotintegerSlot index returned by so_list_slots. Valor predeterminado 0.
propertystringReflected slot-definition property name (so_get/set_slot_property).
valuestringText-export value for the slot property (so_set_slot_property).

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

ai.so_spawn_runtime_object (riesgo 1, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
labelstringobligatorio. Label of the new actor (must be unused).
definitionstringDefinition asset; leave empty with transientDefinition=true.
transientDefinitionbooleanBuild a transient definition (slotCount slots, one behaviorClass definition each) instead of using an asset. Valor predeterminado false.
slotCountintegerSlots of the transient definition (1-16). Valor predeterminado 1.
behaviorClassstringBehavior definition class of the transient slots (concrete USmartObjectBehaviorDefinition subclass).
location{x,y,z}Spawn location.

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

ai.so_use_slot (riesgo 1, UE 5.6+, requiere el plugin SmartObjects, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
claimstringobligatorio. Claim id returned by so_claim_slot ('#').
behaviorClassstringso_use_slot: behavior definition class to use (must be on the slot or the definition).

Devuelve: claim, claims, count.

ai.so_validate (riesgo 0, UE 5.0+, requiere el plugin SmartObjects, smoke)​

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

ArgumentoTipoDescripción
definitionstringobligatorio. Smart Object definition asset path or unique asset name.

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

ai.spawn_ai (riesgo 1, requiere 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.

ArgumentoTipoDescripción
labelstringPawn label in the PIE world. Valor predeterminado TEXT("AiTestPawn").
controllerLabelstringController label; empty uses label + "Controller".
location{x,y,z}Spawn location in centimetres.
pawnClassstringPawn class path or name; empty spawns a Character.
controllerClassstringAIController class path or name; empty spawns a plain AAIController.
behaviorTreestringBehavior Tree asset to run right away (optional).
testTreebooleanBuild the transient test Blackboard + Behavior Tree (/Engine/Transient.BT_AiSmokeRuntime) without running it. Valor predeterminado false.
perceptionbooleanGive the controller an AIPerception component with sight, hearing and damage senses. Valor predeterminado false.
stimuliSourcebooleanGive the pawn a stimuli source registered for sight and hearing. Valor predeterminado false.

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

ai.spawn_test_actor (riesgo 2, modifica, requiere 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.

ArgumentoTipoDescripción
labelstringobligatorio. Actor label; must not already be used by another actor.
location{x,y,z}Spawn location in centimetres.
pawnClassstringPawn class path or name; empty spawns a plain Pawn.
perceptionbooleanAdd an AIPerceptionComponent. Valor predeterminado true.
stimuliSourcebooleanAdd an AIPerceptionStimuliSourceComponent. Valor predeterminado false.

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

ai.stimuli_add_source (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor that should be perceivable.
sensesarray of stringAISense classes to register for (AISense_Sight, /Script/AIModule.AISense_Hearing...).
autoRegisterbooleanRegister automatically when play begins. Valor predeterminado true.

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

ai.stimuli_get_source (riesgo 0, requiere mundo, smoke)​

Returns the stimuli source component of an actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.stimuli_register_sense (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with an AIPerceptionStimuliSource component (PIE world).
sensestringobligatorio. AISense class (AISense_Sight, /Script/AIModule.AISense_Hearing...).

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

ai.stimuli_remove_source (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, name, or class: in the editor world (PIE world while PIE runs).

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

ai.stimuli_unregister_sense (riesgo 2, modifica, requiere PIE, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor with an AIPerceptionStimuliSource component (PIE world).
sensestringobligatorio. AISense class (AISense_Sight, /Script/AIModule.AISense_Hearing...).

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

ai.stop_movement (riesgo 2, modifica, requiere PIE, smoke)​

Stops the current move.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.stop_tree (riesgo 2, modifica, requiere PIE, smoke)​

Stops the controller's brain logic.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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

ai.unpossess (riesgo 2, modifica, requiere PIE, smoke)​

Unpossesses the current pawn.

ArgumentoTipoDescripción
controllerstringobligatorio. AI controller actor path, label, or unique name.
targetstringPawn, target actor, or behavior tree reference as required by the action.
location{x,y,z}World-space destination for movement.
acceptanceRadiusnumberAcceptance radius in centimeters; negative uses the engine default. Valor predeterminado -1.f.
keystringBlackboard key for the typed value action.
typestringbool, int, float, string, name, vector, rotator, object, class, or enum.
valuestringText value for scalar and name types.
prioritystringFocus priority for focus tools: Default, Move or Gameplay. Valor predeterminado TEXT("Gameplay").

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