✍️Today I Learned

📅 2025-09-10

• GAS: GameplayTag / GameplayCue

GAS: GameplayTag / GameplayCue

GameplayTag

문자열 기반의 계층적 라벨 시스템

특징
1. 계층 구조: 트리 형태 (ex HUD.Slot.Reticle, HUD.Slot.Equipment)
2. 상속 검색: 상위태그로 하위태그 검색
3. 컨테이너 기반 : 여러 태그 동시에 보유 가능
4. 에디터 통합 : 자동완성, 검증, 관리 도구 제공

태그 매칭 종류
1. Exact Match
하위 매치는 찾지 않음
2. Partial Match
부분 일치 검색. 상위 태그로 하위 태그를 검색
3. Container Match
컨테이너 일치. 여러 태그를 동시에 검색

내부 구조

struct FGameplayTag
{
    FName TagName;  // 해시 기반 빠른 비교
};

struct FGameplayTagContainer
{
    TArray<FGameplayTag> GameplayTags;
    TArray<FGameplayTag> ParentTags;  // 미리 계산된 부모 태그들
};

ParentTags.Add("Status");
ParentTags.Add("Status.Debuff");
ParentTags.Add("Status.Debuff.Frozen");

1. 부모 태그를 미리 저장해서 검색 속도를 높임
2. FName: 문자열을 숫자로 변환해서 저장 -> 대역폭도 작아지고 속도가 빠름
3. 태그로 GAS 조건 적용

GameplayCue

게임의 로직과 연출을 분리하고 태그로 연결
GA 실행 시 태그로 큐 실행. 같은 태그를 갖는 큐는 동시 실행된다.

타입

1. Execute 실행형
   즉시 실행 (OnExecute)
   자동 정리
2. Add Cue 추가형
   수동 제거할 때까지 지속 (OnActive->WhileActive)
   버프/디버프 상태 표시
3. Remove Cure 제거형
   Add된 Cue 정리 (OnRemove)
   종료 연출 추가 가능

WhileActive에서 false를 리턴하면 OnRemove 이벤트가 발생하여 큐 종료할 수 있다.

동적연출
큐 실행시 파라미터로 데이터를 전달하여 동적연출 가능

네트워크 동기화
Local Cue: 로컬 전용 (ExecuteGameplayCueLocal)
Replicated Cue: 네트워크 복제 (ExecuteGameplayCue)

클래스 계층
1. static
액터를 생성하지않음. 가벼움. OnExecute만 가능
2. actor
복잡한 연출. 액터 생성. 상태 유지 가능

---

💡 느낀 점 (What I Felt)

---

출처: 스파르타코딩 내일배움캠프