이 문서는 Gameplay Ability System (GAS)을 프로젝트에 적용한 내용을 정리한 문서이다. PTGameAbility를 상속한 개별 클래스는 제외하고, 전체적인 구조와 핵심 기능을 설명했다.

Attack

Skill

• 입력 이벤트 감지 및 Ability 실행

  • 플레이어의 입력이 감지되면 AbilitySpecInputPressed 또는 AbilitySpecInputReleased 가 호출된다.

  • InvokeReplicatedEvent를 사용해 해당 Ability를 실행할 수 있도록 처리했다.

  • GameplayTag를 활용해 특정 Ability를 실행할 수 있도록 설계했다.

  • 주요 코드

    void UPTAbilitySystemComponent::AbilitySpecInputPressed(FGameplayAbilitySpec& Spec)
    {
        Super::AbilitySpecInputPressed(Spec);
    
        if (Spec.IsActive())
            InvokeReplicatedEvent(EAbilityGenericReplicatedEvent::InputPressed, 
                                  Spec.Handle, 
                                  Spec.ActivationInfo.GetActivationPredictionKey());
    }
    
    void UPTAbilitySystemComponent::AbilitySpecInputReleased(FGameplayAbilitySpec& Spec)
    {
        Super::AbilitySpecInputReleased(Spec);
    
        if (Spec.IsActive())
            InvokeReplicatedEvent(EAbilityGenericReplicatedEvent::InputReleased, Spec.Handle, Spec.ActivationInfo.GetActivationPredictionKey());
    }

• 캐릭터 & AI 능력치를 관리

  • TCharacter_AttributeSet → 플레이어의 체력, 스킬 정보 관리

  • PTAI_AttributeSet → AI 몬스터의 체력, 스킬 정보 관리

    클래스명	역할
    PTCharacter_AttributeSet	플레이어의 채력, 스킬 정보 관리
    PTAI_AttributeSet	AI 몬스터의 체력, 스킬 정보 관리
    PostGameplayEffectExecute	능력치가 변경될 때 UI 및 AI 상태 업데이트
    InitAttributeSet	캐릭터/몬스터 데이터 테이블에서 초기 능력치 로드

• 예제 코드 - 체력 변경 시 UI 업데이트

  void UPTCharacter_AttributeSet::PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data)
  {
      Super::PostGameplayEffectExecute(Data);
  
      if (Data.EvaluatedData.Attribute == GetHealthAttribute())
      {
          const FPTGameplayTags& GameplayTags = FPTGameplayTags::Get();
          UGameplayMessageSubsystem& MessageSubsystem = UGameplayMessageSubsystem::Get(this);
  
          float HealthRatio = GetHealth() / GetMaxHealth();
          FUIHPMessage UIHealthMessage;
          UIHealthMessage.HealthAmount = HealthRatio;
  
          MessageSubsystem.BroadcastMessage(GameplayTags.UI_Event_Health, UIHealthMessage);
      }
  }

• 추가 설명

  • PostGameplayEffectExecute는 GAS에서 능력치가 변경될 때 호출되는 함수이다.
  • 이 코드를 통해 플레이어 체력이 변하면 UI에 반영되도록 설계했다.

• Ability 실행 시 캐릭터 정보 가져오기

  • GetPTCharacterFromActorInfo() → 플레이어 캐릭터 가져오기

  • GetPTAICharacterFromActorInfo() → AI 캐릭터 가져오기

  • 예제 코드

    APTCharacter* UPTGameplayAbility::GetPTCharacterFromActorInfo()
    {
        return CurrentActorInfo ? Cast<APTCharacter>(CurrentActorInfo->AvatarActor.Get()) : nullptr;
    }

• Gameplay Ability 실행 시 카메라 모드 변경

  • SetCameraMode로 카메라 모드 적용 → Ability 실행 후 ClearCameraMode로 원래 상태 복귀

  • 예제 코드

    void UPTGameplayAbility::SetCameraMode(TSubclassOf<UPTCameraMode> CameraMode, bool UseFovOffset)
    {
        if (UPTHeroComponent* HeroComponent = GetPTHeroComponentFromActorInfo())
        {
            HeroComponent->SetAbilityCameraMode(CameraMode, CurrentSpecHandle, UseFovOffset);
            ActiveCameraMode = CameraMode;
        }
    }