Environment Query System

Documents the Environment Query System (EQS) and how it can be used to query the environment for data. That data can then be used to provide the AI with data used in the decision-making process on how to proceed.

Choose your operating system:

Windows

macOS

Linux

On this page

The Environment Query System (EQS) is a feature within the Artificial Intelligence system in Unreal Engine 5 (Unreal Engine) that is used to collect data from the environment. Within EQS, you can ask questions about the data collected through a variety of different Tests which produces an Item that best fits the type of question asked. 

An EQS Query can be called from a Behavior Tree and used to make decisions on how to proceed based on the results of your Tests. EQS Queries are primarily made up of Generators (which are used to produce the locations or Actors that will be tested and weighted) and Contexts (which are used as a frame of reference for any Tests or Generators). EQS Queries can be used to instruct AI characters to find the best possible location that will provide a line of sight to a player to attack, the nearest health or ammo pickup, or where the closest cover point (among other possibilities). 

Once you have a general understanding of how Behavior Trees work in Unreal Engine and want to have your AI query the environment, you may want to start with the Environment Query System Quick Start guide which will walk you through an end-to-end example of having the AI find the best possible position to attack from a range against the player. Also refer to the Essentials section for an overview of EQS, a User Guide to working with EQS, and a node reference page that breaks down the available nodes and properties within EQS. 

Starting Out

Essentials