Team Identity and Debugging Reference

GAIS_Cover
YuewuDev

Author

YuewuDev

Created: Oct 12, 2026Updated: Oct 12, 2026

Table of contents

Team Identity and Debugging Reference

This reference covers Team Identity, project policy, Blueprint helpers, and diagnostic boundaries. See Team Identity and Project Policy, Integrate Team Identity and Affiliation, and GameplayDebugger.

UGAIS_TeamAgentComponent

Field/event

Purpose

TeamId

Current team identity, replicated with OnRep support.

bApplyTeamIdToMirrors

Synchronizes TeamId to Owner, Controller, or interface mirrors.

SetTeamId

Changes Team ID on authority.

OnTeamIdChangedEvent

Broadcast when Team ID changes.

OnTeamIdChanged

Overridable change hook.

UGAIS_ProjectPolicy

Method

Purpose

ResolveTeamAgent

Finds the TeamAgent for an Actor.

HasGenericTeamId

Tests whether an Actor has valid team identity.

GetGenericTeamId

Reads Team ID.

SetGenericTeamId

Writes Team ID.

GetGenericTeamQuerySource

Explains the source used for team diagnostics.

Blueprint helpers

UGAIS_BlueprintFunctionLibrary, UGAIS_CommandFunctionLibrary, UGAIS_FormationFunctionLibrary, and UGAIS_TacticalAssignmentFunctionLibrary provide Blueprint queries, data construction, and system-call helpers. Use them to connect project UI, input, or gameplay logic; they do not replace asset configuration, authority validation, or explicit extension points.

Diagnostic entry points

FGAIS_GameplayDebuggerCategory_AI displays Blackboard, Stack, Queue, CommandSystem, Formation, Squad, Team, and other summaries. Debug-only slot-assignment explanations are controlled by GAIS_SQUAD_SLOT_ASSIGNMENT_WITH_DIAGNOSTICS; Shipping and Test builds omit them.

For debugging, inspect the Team ID, query source, validity, and the policy class before debugging CommandDefinition or Tactical Assignment filters. A valid stored TeamAgent value and a valid project-policy result must agree with the project's authority and replication model.