44강. 최종 실습 2: 전투 Ability 네 종 완성

?1. 이번 강의에서 해결할 문제

전투 Ability를 각각 작동시키는 것만으로는 완성된 시스템이 아닙니다. 부여 데이터, 입력 Tag, Cost·Cooldown, TargetData, 서버 판정, Cue가 같은 규칙을 사용해야 하며 사망·재Spawn 때 중복되지 않아야 합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 기본 공격·Dash·투사체·회복 Ability의 책임을 분리합니다.
• AbilitySet DataAsset로 부여와 입력 Tag를 데이터화합니다.
• 소유 클라이언트 반응성과 서버 권한 결과를 함께 검증합니다.

◇3. 핵심 개념

GA_BasicAttack은 Montage Event 시점에 서버 Trace를 검증하고 데미지 Effect를 적용합니다. GA_Dash는 이동 표현을 예측하되 충돌·Cost·Cooldown을 서버가 승인합니다. GA_FireProjectile은 클라이언트 조준 TargetData를 서버가 검증하고 권한 투사체를 Spawn합니다. GA_Heal은 자기 대상 Effect로 Health를 회복합니다.

§4. 구현

GASAbilitySet.h

USTRUCT(BlueprintType)
struct FGASAbilityEntry
{
    GENERATED_BODY()

    UPROPERTY(EditDefaultsOnly)
    TSubclassOf<UGameplayAbility> AbilityClass;

    UPROPERTY(EditDefaultsOnly)
    FGameplayTag InputTag;

    UPROPERTY(EditDefaultsOnly, meta=(ClampMin="1"))
    int32 AbilityLevel = 1;
};

UCLASS(BlueprintType)
class GASDEMO_API UGASAbilitySet : public UPrimaryDataAsset
{
    GENERATED_BODY()

public:
    UPROPERTY(EditDefaultsOnly)
    TArray<FGASAbilityEntry> Abilities;
};

서버 부여 시 입력 Tag 연결

FGameplayAbilitySpec Spec(Entry.AbilityClass, Entry.AbilityLevel);
Spec.GetDynamicSpecSourceTags().AddTag(Entry.InputTag);
const FGameplayAbilitySpecHandle GrantedHandle = ASC->GiveAbility(Spec);
OutGrantedHandles.Add(GrantedHandle);

데이터 에셋에는 Input.Attack.Primary, Input.Movement.Dash, Input.Ability.Projectile, Input.Ability.Heal을 배치합니다. 입력 컴포넌트는 Tag pressed/released를 ASC에 전달하고 Ability 클래스 이름을 직접 비교하지 않습니다. UE5 마이너 버전에 따라 Dynamic Spec Tag 접근 API가 달라질 수 있으므로 현재 GameplayAbilities 헤더를 확인합니다.

Ability	예측	서버 확정	지속 상태
BasicAttack	Montage/Cue	Trace·Damage	Cost·Cooldown
Dash	입력 반응/표현	Commit·충돌 규칙	Cooldown
FireProjectile	조준 프리뷰	Target 검증·Spawn·Damage	Cost·Cooldown
Heal	즉시 UI 예고 선택	Heal Effect 적용	Health Attribute

→5. 코드가 동작하는 이유

AbilitySet은 무엇을 부여할지, ASC는 어떤 입력 Tag가 눌렸는지, 각 Ability는 어떻게 실행할지를 분리합니다. 네 Ability 모두 영구 결과를 Effect/Attribute로 남기므로 Cue 유실이나 UI 재생성에도 전투 상태가 보존됩니다.

§6. 실패 사례와 해결

!자주 하는 실수

• 입력 코드에서 Ability 클래스 직접 활성화: Input Tag와 Spec Tag 계약을 사용합니다.
• 클라이언트가 투사체를 권한 Spawn: 서버가 Spawn하고 로컬은 예측 표현만 담당합니다.
• Attack Montage Notify마다 데미지 중복: 한 활성화의 유효 Hit Window와 대상 중복을 관리합니다.
• 부활 때 AbilitySet 재부여: 저장한 SpecHandle과 부여 상태를 확인합니다.

✎7. 직접 실습

✎직접 실습

네 Ability를 DataAsset 한 개로 부여하고 Cost 부족, Cooldown, Stun, Silence, 사망 조건에서 각각 활성화 결과를 시험하세요. Listen Server와 Client에서 실제 데미지·회복·투사체 수가 한 번만 확정되는지 검증합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 입력 Tag를 Ability 클래스 직접 참조보다 선호하는 이유는 무엇인가요?
2. 투사체 Ability에서 클라이언트와 서버가 각각 맡는 책임은 무엇인가요?
3. 네 Ability의 지속 결과가 Cue가 아니라 Effect·Attribute에 남아야 하는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

AbilitySet·입력 Tag·네 Ability·Effect를 하나의 데이터 흐름으로 연결했습니다. 다음 강의에서는 Buff, Slow, Stun, 무적과 Cue·UI를 통합합니다.