Unreal Engine 5 Documentation has been moved to the Epic Developer Community

In addition to the AI Debugging tools, the Environment Query System has a specialized type of Pawn class called the Environment Query System Testing Pawn ( EQSTestingPawn ) that enables you to check out what your Environment Queries are actually doing. The exact makeup of your Environment Query will define the size and shape of what is created, but it will always be represented as colored spheres. Spheres that are on the color scale from green to red, indicate some level of match for the various tests your Environment Query ran. Blue spheres indicate a failure or a boolean type test that returned false, such as the Trace test.

Working with the EQS Testing Pawn

After enabling EQS and creating an EQS Query you can test the data while in the Editor using the EQS Testing Pawn.

1. In the Content Browser , create a new Blueprint of the EQSTestingPawn class and give it any name.
   

2. Place the EQSTestingPawn in the Level, then in the Details panel, assign the EQS Query Template to test.
   

   
   Click for full image.

Depending upon the content of your query, when you have the EQSTestingPawn selected in the Level, debug spheres will appear in the Level that indicate the value of a match based on your conditions. Below we use the EQSTestingPawn and test a query that yields the best possible position in the Level that provides line of sight to the Player Character. As we move the EQSTestingPawn around, the spheres update in color and value to indicate the new best match based on the position of the Player and EQSTestingPawn.

Evaluating Results

When evaluating the results of a Test using the EQSTestingPawn, the colored spheres and values indicate the level of match an item has at a given location.

• Blue Spheres : These spheres indicate that a Test has failed at that item, so the item is completely un-weighted and culled from the results. This usually occurs when a value is filtered out, such as using a Distance Test and filtering out any Item over (or under) a range. If you don't want a value to be culled completely, you can use the Clamp options in the scoring section. Below, we have a query that is being ran to find line of sight to the Player. We have used a Visibility to cull out items where the AI would not have line of sight to the Player (represented by the blue spheres).

• Green to Red Spheres : Spheres range in color from green to red and indicate the desirability of the Item as the best match for the specified Test. Green is more desirable than red and the number shown is the weighted score of the Item. If previewing only one Debug Step, this value will be the final value from the selected Test. Below, we use a query to find the furthest point away from the player regardless of visibility.

EQS Testing Pawn Properties

With an EQSTestingPawn selected in the Level, the following properties are available inside the Details panel.