class

FEnvQueryTask

The behaviour-tree face of an environment query: the native task "RunEQSQuery" (assetRef = the .eqs, key = the blackboard vector that receives the winning point; "EQSTarget" is read as the query's Target when set). Success with the point written, Failure when the query has no survivor or the asset cannot be loaded. The asset is cached per node.

Module
AINavigation
Header
#include "AINavigation/EnvQueryTask.h"
Namespace
Mowo

MakeAsync is the RunEQS node: it submits to the world's EnvQuerySystem and stays Running until the time-sliced query answers, cancelling it on abort. A world with no EnvQuerySystem runs the query synchronously instead.

Public functions

ReturnsNameDescription
BT::NodePtrMake
BT::NodePtrMakeAsync
voidRegisterBehaviorTreeTask
voidPumpServiceOne service tick: collect the answer of the query in flight (writing the winner to resultKey) and submit the next one.
boolBuildAgentRequestFills request for the agent the tree drives, reading the target from targetKey (a vector or an actor).

Function details

Make

C++
static BT::NodePtr Make(const std::string& assetPath, FName resultKey, FName targetKey)

MakeAsync

C++
static BT::NodePtr MakeAsync(const std::string& assetPath, FName resultKey, FName targetKey)

RegisterBehaviorTreeTask

C++
static void RegisterBehaviorTreeTask()

PumpService

C++
static void PumpService(BTContext& ctx, FEnvQueryServiceState& state, FName resultKey)

One service tick: collect the answer of the query in flight (writing the winner to resultKey) and submit the next one.

BuildAgentRequest

C++
static bool BuildAgentRequest(BTContext& ctx, FName targetKey, uint32_t seed, World*& outWorld, FEnvQueryRequest& request)

Fills request for the agent the tree drives, reading the target from targetKey (a vector or an actor). False when the agent cannot be found.

Generated from AINavigation/EnvQueryTask.h via ainavigation.json · Oct 27, 2026Version 1.0.0