📘TIL- GAS 콤보 시스템, 스태미나 적용

문제

멀티플레이 기반 GAS 구조에서 콤보 공격과 방어 시스템에 스태미나를 연동하는 과정에서 다음과 같은 문제가 발생했다.

• 콤보 공격 시 스태미나 소모가 적용되지 않음
• GameplayEffect 적용 로그는 찍히지만 실제 Stamina 값은 감소하지 않음
• Block / Attack / Regen이 서로 간섭하여 리젠이 비정상 동작
• 스태미나 로직이 여러 클래스에 분산되어 구조가 불명확함

---

분석

---

GameplayEffect 적용 문제 구조

단계	상태	실제 의미
Ability 실행	정상	Ability 로직 문제 아님
GE Apply 로그	정상	Spec 생성 및 적용 성공
Attribute 변화	없음	GE 내부 설정 문제

결론: 로직 문제가 아니라 GE 설정 문제

---

SetByCaller 문제 구조

[코드]        Data.StaminaCost
[GE 에셋]     Data.Stamina.Cost

문제	결과
태그 불일치	SetByCaller 값 = 0
최종 결과	Stamina 변화 없음

GAS에서 가장 흔한 함정

---

GameplayEffect 올바른 구조

항목	설정
Duration Policy	Instant
Attribute	Stamina
Modifier Op	Add
Magnitude	SetByCaller(Data.StaminaCost)

---

책임 분리 문제 (Before / After)

Before (문제 구조)

Character
 ├─ 일부 스태미나 처리
ComboManager
 ├─ 일부 처리
Ability
 ├─ 일부 처리

책임이 분산 → 디버깅 어려움

---

After (개선 구조)

Character
 ├─ Ability 실행 진입점

Ability (GA_Block / GA_Attack)
 ├─ 비용 계산
 ├─ GE 적용

GameplayEffect
 ├─ 실제 수치 변경

AttributeSet
 ├─ Stamina 값 보유

ComboManager
 ├─ 콤보 인덱스 관리

역할 명확화

---

해결

---

전체 시스템 흐름 (다이어그램)

[입력]
   ↓
ComboManager
   ↓ (현재 콤보 단계 제공)
GA_ComboAttack
   ↓
CanActivateAbility
   ↓ (스태미나 체크)
ActivateAbility
   ↓
GameplayEffect (Cost 적용)
   ↓
AttributeSet (Stamina 감소)

---

콤보 스태미나 처리 구조

단계	역할
ComboManager	현재 콤보 index 제공
Ability	StaminaCost 계산
CanActivate	사용 가능 여부 검사
Activate	GE 적용
AttributeSet	실제 값 변경

---

Block / Attack / Regen 구조 비교

기존 방식 (문제)

시스템	방식
Block	Regen 제거
Attack	Regen 영향 없음
Regen	수동 적용

상태 꼬임 발생

---

개선 방식 (Tag 기반)

시스템	방식
Regen	BeginPlay에서 1회 적용
Block	State.Blocking 태그
Attack	State.Attacking 태그
Regen 제어	Tag 조건으로 자동 중지

---

태그 기반 제어 구조

State.Blocking
State.Attacking

---

Regen GE 동작 조건

상태	결과
Blocking	Regen OFF
Attacking	Regen OFF
Idle	Regen ON

---

Block Ability 역할 정리

시점	처리
시작	DefenseBuff 적용
시작	StaminaDrain 적용
종료	Buff 제거
종료	Drain 제거
리젠	건드리지 않음

---

Combo Ability 역할 정리

단계	처리
시작	ComboData 조회
검사	Stamina 체크
실행	Cost GE 적용
실행	Montage 재생
종료	Ability 종료

---

핵심 코드 구조

SpecHandle.Data->SetSetByCallerMagnitude(
    FGameplayTag::RequestGameplayTag(FName("Data.StaminaCost")),
    -MyComboData->StaminaCost
);

---

디버깅 체크리스트

체크 항목	방법
GE 적용 여부	Apply 로그
실제 값 변화	AttributeSet 로그
SetByCaller 값	Tag 출력
GE 설정 확인	에셋 Modifier 확인

---

디버깅 흐름

1. GE 적용 로그 확인
2. AttributeSet 값 변화 로그 확인
3. 값이 안 변하면 → SetByCaller 확인
4. 그래도 안 되면 → GE Modifier 확인

---

핵심 인사이트

• GAS에서 “적용됨”과 “값 변경됨”은 다른 개념이다
• SetByCaller는 Tag 하나 틀리면 전체 시스템이 무효화된다
• 스태미나는 Ability가 아니라 GameplayEffect가 책임져야 한다
• 상태 제어는 코드보다 Tag 기반이 훨씬 안정적이다
• 시스템이 커질수록 책임 분리 구조가 디버깅 난이도를 결정한다

---

오늘의 정리

• GAS 스태미나 시스템은 값을 직접 차감하는 방식이 아니라 GameplayEffect + Tag 기반으로 통합하는 것이 핵심이며,
  각 행동은 비용 계산만 담당하고 실제 적용은 GE가 맡도록 분리함으로써 충돌 없이 확장 가능하고 디버깅이 쉬운 구조로 개선할 수 있었다.