Targeting

Target detection, selection, and cursor management — scanning, filtering, and selecting entities based on proximity and sensory fields.

The targeting system provides spatial awareness and entity selection for units and other entities. A TargetingHandler component serves as the central processor — it receives target registrations from sensory fields, maintains categorized target lists, and selects the best interact target based on proximity and type filtering. The system supports a cursor overlay for visual feedback and an input reader for triggering interactions.

For usage guides and setup examples, see The Basics: GS_Interaction.

Targeting Handler component in the O3DE Inspector Targeting Interaction Field component in the O3DE Inspector Interact Cursor component in the O3DE Inspector Interact Target component in the O3DE Inspector

 

Contents


Components

ComponentPurpose
GS_TargetingHandlerComponentCentral targeting processor. Receives target registrations, selects best interact target.
GS_TargetingInteractionFieldComponentPhysics trigger volume for proximity-based target detection.
GS_TargetComponentBase target marker. Makes an entity detectable by the targeting system.
GS_InteractTargetComponentSpecialized interact target extending GS_TargetComponent.
GS_CursorComponentCursor display and positioning for targeting feedback.
GS_CursorCanvasComponentUI canvas layer for cursor sprite rendering.
InteractInputReaderComponentInput reader that bridges interact input to trigger actions on the current target.

EBus Summary

Request Buses

BusAddressHandlerKey Methods
GS_TargetingHandlerRequestBusByIdMultipleRegisterTarget, UnregisterTarget, RegisterInteractionRangeTarget, UnregisterInteractionRangeTarget, GetInteractTarget
GS_TargetRequestBusByIdMultipleGetTargetSize, GetTargetOffset, GetTargetColour, GetTargetSprite
GS_CursorRequestBusSingleMultipleRegisterCursorCanvas, HideCursor, SetCursorOffset, SetCursorVisuals, SetCursorPosition
GS_CursorCanvasRequestBusByIdMultipleHideSprite, SetCursorSprite

Notification Buses

BusAddressHandlerKey Events
GS_TargetingHandlerNotificationBusByIdMultipleOnUpdateInteractTarget, OnEnterStandby, OnExitStandby

See Also

For component references:

For related resources:


Get GS_Interaction

GS_Interaction — Explore this gem on the product page and add it to your project.