✍️Today I Learned

 📅 2025-11-20

• 언리얼 GAS: 클라이언트에서 실행되지 않는 패시브 어빌리티 문제 해결

---

언리얼 GAS: 클라이언트에서 실행되지 않는 패시브 어빌리티 문제 해결

1. 🎯 내가 하려던 것 (Goal)

• 목표: 언리얼 엔진의 Gameplay Ability System (GAS)을 사용하여 리슨 서버 멀티플레이 환경에서 상태 유지형 패시브 어빌리티를 구현하고, 클라이언트의 특정 입력(예: 숫자키 1)이 있을 때 이 어빌리티가 이벤트를 받아 특정 동작을 수행하도록 만들고자 했다.
• 구현 방식:
  1. 어빌리티 부여 시, 능력이 종료되지 않고 활성화 상태를 유지.
  2. 활성화된 능력 내에서 Wait Gameplay Event 노드를 사용하여 특정 태그를 기다림.
  3. 클라이언트가 키를 누르면 SendGameplayEventToActor를 호출하여 이벤트를 보냄.

2. 🤯 직면한 문제 (Problem)

• 현상: 어빌리티가 호스트(서버 겸 클라이언트)에서는 정상적으로 동작했으나, 일반 클라이언트에서는 어빌리티가 활성화되지 않거나, 활성화되더라도 키 입력에 따른 후속 동작이 실행되지 않음.

• 오류 코드:

  UGA_Hotkey::UGA_Hotkey() {
      // ...
      NetExecutionPolicy = EGameplayAbilityNetExecutionPolicy::LocalOnly; // 문제의 원인 1
  }
  
  void UGA_Hotkey::OnGiveAbility(...) {
      // ...
      if (ActorInfo->IsLocallyControlled() && !Spec.IsActive()) { // 문제의 원인 2
         // ... TryActivateAbility 호출
      }
  }

3. 💡 문제의 원인 및 해결 방법 (Cause & Solution)

1. 초기 활성화 권한 문제

능력의 NetExecutionPolicy가 LocalOnly로 설정되어 있어 서버의 권한이 있는 상태에서 활성화되지 않음. 또한 OnGiveAbility에서 IsLocallyControlled() 조건만 확인하여, 클라이언트의 로컬 복사본에서만 활성화가 시도되어 서버에는 상태가 복제되지 않음.

해결: 서버 권한으로 초기 활성화

1. NetExecutionPolicy를 EGameplayAbilityNetExecutionPolicy::ServerOnly로 변경하여 어빌리티의 실행 권한을 서버로 위임.
2. OnGiveAbility에서 ActorInfo->IsNetAuthority() (서버)일 때만 TryActivateAbility를 호출하여 능력이 서버에서 권한 있게 활성화되도록 수정.

2. 이벤트 전송 문제

능력이 ServerOnly로 서버에서 활성화되어 Wait Gameplay Event 노드가 서버에서만 실행됨. 그런데 클라이언트에서 호출된 SendGameplayEventToActor는 로컬 함수 호출일 뿐, 네트워크를 통해 서버에 전달되지 않아 서버의 대기 중인 능력이 이벤트를 받지 못함.

해결: Server RPC를 통한 이벤트 전달

1. 클라이언트의 키 입력 처리 부분에서 SendGameplayEventToActor를 직접 호출하는 대신, 서버로 전송되는 Server RPC 함수를 호출.
2. 서버 RPC 함수 안에서 UAbilitySystemComponent::HandleGameplayEvent 또는 SendGameplayEventToActor를 호출하여 서버의 능력에게 이벤트를 전달.

---

💡 느낀 점 (What I Felt)

멀티플레이 환경에서 Gameplay Ability System (GAS)을 사용할 때는, 단순히 코드를 작성하는 것 이상으로 "이 코드가 지금 서버에서 실행되는가, 클라이언트에서 실행되는가?"에 대한 네트워크 권한(Authority) 이해가 가장 중요하다는 것을 다시 한번 깨달았다. 특히 패시브 어빌리티라도 서버에서 권한을 가지고 활성화해야 하며, 클라이언트 입력이 서버의 상태를 변경할 때는 반드시 Server RPC를 사용해 안전하게 권한을 넘겨야 예상치 못한 싱크(Sync) 문제를 방지할 수 있다. LocalOnly 정책은 신중하게 사용해야겠다.