Agents & Attitude

1. Enable the plugin

Open Edit → Plugins, type Crimson, tick CrimsonTeams (and CrimsonCommon, its dependency), and restart the editor. For a Blueprint project that's the whole install.

C++ projects: add the module to your build file:

// YourGame.Build.cs
PublicDependencyModuleNames.Add("CrimsonTeams");

2. Make two actors team agents

Add a Crimson Team Agent Component to each actor. For players, prefer the Player State — it survives pawn respawns. Give one actor Team.Red and the other Team.Blue, and mark each hostile to the other.

In Blueprint, set Team Tags and Hostile To Tags in the component's Details panel for static actors, or call the mutators on the server at runtime.

In C++, mutate on the server:

// Server only — team state is authoritative.
if (HasAuthority())
{
    UCrimsonTeamAgentComponent* Team = FindComponentByClass<UCrimsonTeamAgentComponent>();
    Team->JoinTeam(Tag_Team_Red);
    Team->AddHostileTags(FGameplayTagContainer(Tag_Team_Blue));
}

3. Check attitude

Ask the statics whether two actors are friend or foe — it resolves the component on an actor, its pawn, or its player state automatically.

const ETeamAttitude::Type Att = UCrimsonTeamStatics::GetTeamAttitudeBetween(RedActor, BlueActor);
// Att == ETeamAttitude::Hostile  -> enemies

// Quick damage gate (Hostile or Neutral can be damaged; Friendly is blocked):
if (UCrimsonTeamStatics::ShouldCauseDamageToTarget(Instigator, Target))
{
    // apply damage
}