AI Tactical Point System - Lumberyard User Guide

AI Tactical Point System

This topic references tools and features that are legacy. If you want to use legacy tools in Lumberyard Editor, disable the CryEntity Removal gem using the Project Configurator or the command line. To learn more about legacy features, see the Lumberyard Legacy Reference.

The Tactical Point System (TPS) provides the AI system with a powerful method of querying an AI agent's environment for places of interest. It includes the GetHidespot functionality and expands on the "hide" goalop.

TPS is a structured query language over sets of points in the AI's world. Using TPS, AI agents can ask intelligent questions about their environment and find relevant types of points, including hidespots, attack points, and navigation waypoints. The TPS language is simple, powerful, and designed to be very readable.

For example, this query requests all points that match the following criteria:

  • Generate locations within 7 meters of my current location where I can hide from my attention target.

  • Only accept places with excellent cover that I can get to before my attention target can.

  • Prefer locations that are closest to me.

hidespots_from_attentionTarget_around_puppet = 7 coverSuperior = true, canReachBefore_the_attentionTarget = true distance_from_puppet = -1

TPS uses a highly efficient method to rank points, keeping expensive operations like raycasts and pathfinding to an absolute minimum. Queries are optimized automatically.