[Unreal Engine] GAS Documentation 번역본

이매·2025년 6월 20일

Unreal GAS

목록 보기

7/7

GAS 문서 번역본

해당 문서는 Unreal Engine 5의 멀티플레이어 샘플 프로젝트의 GameplayAbilitySystem 플러그인의 이해를 돕는 문서입니다. 이 문서는 공식 문서가 아니며, 프로젝트 역시 에픽게임즈의 검증을 받지 않았습니다. 따라서 문서 정보의 정확성을 보장하지 않습니다.

이 문서는 GAS의 주요 개념과 클래스들을 설명하고, 경험을 바탕으로 몇 가지 추가 코멘트를 제공하는 것을 목적으로 합니다.

샘플 프로젝트와 문서는 언리얼 엔진 5.3(UE5) 버전입니다. 이전 버전의 언리얼 엔진을 위한 이 문서의 브랜치가 있지만, 더 이상 지원되지 않으며 버그나 오래된 정보가 있을 수 있습니다. 사용 중인 엔진 버전과 일치하는 브랜치를 사용하시기 바랍니다.

GASShooter는 멀티플레이어 FPS/TPS를 위한 GAS의 심화 기술을 보여주는 또 다른 샘플 프로젝트입니다.

또한 언제나 플러그인의 원본 소스 코드를 참고하는 것이 좋습니다.

GameplayAbilitySystem Plugin의 소개

샘플 프로젝트

GAS 프로젝트 세팅 방법

GAS Concepts
4.1 Ability System Component
     4.1.1 Replication Mode
     4.1.2 설정 및 초기화
4.2 Gameplay Tags
     4.2.1 GameplayTag 변경에 응답하기
     4.2.2 플러그인 .ini 파일에서 GameplayTag 불러오기
4.3 Attributes
     4.3.1 Attribute 정의
     4.3.2 BaseValue vs CurrentValue
     4.3.3 Meta Attributes
     4.3.4 Attribute 변경에 응답하기
     4.3.5 Derived Attributes
4.4 Attribute Set
     4.4.1 AttributeSet 정의
     4.4.2 AttributeSet 설계
           4.4.2.1 개별 Attribute를 가진 서브 컴포넌트
           4.4.2.2 런타임에 AttributeSet 추가 및 제거하기
           4.4.2.3 아이템 Attribute (무기 탄약)
                 4.4.2.3.1 아이템에 일반 float 사용
                 4.4.2.3.2 아이템의 AttributeSet
                 4.4.2.3.3 아이템의 ASC
     4.4.3 Attribute 정의
     4.4.4 Attribute 초기화
     4.4.5 PreAttributeChange()
     4.4.6 PostGameplayEffectExecute()
     4.4.7 OnAttributeAggregatorCreated()
4.5 Gameplay Effects
     4.5.1 Gameplay Effect 정의
     4.5.2 Gameplay Effect 적용
     4.5.3 Gameplay Effect 삭제
     4.5.4 Gameplay Effect Modifiers
           4.5.4.1 Multiply 및 Divide Modifiers
           4.5.4.2 Modifier의 GameplayTag
     4.5.5 Gameplay Effect Stacking(중첩)
     4.5.6 Ability 부여
     4.5.7 Gameplay Effect Tags
     4.5.8 면역
     4.5.9 Gameplay Effect Spec
           4.5.9.1 SetByCallers
     4.5.10 Gameplay Effect Context
     4.5.11 Modifier Magnitude Calculation
     4.5.12 Gameplay Effect Execution Calculation
           4.5.12.1 Sending Data to Execution Calculations
                 4.5.12.1.1 SetByCaller
                 4.5.12.1.2 Backing Data Attribute Calculation Modifier
                 4.5.12.1.3 Backing Data Temporary Variable Calculation Modifier
                 4.5.12.1.4 Gameplay Effect Context
     4.5.13 Custom Application Requirement
     4.5.14 Cost Gameplay Effect
     4.5.15 Cooldown Gameplay Effect
           4.5.15.1 Cooldown GameplayEffect의 남은 시간 얻어내기
           4.5.15.2 Cooldown 시작 및 종료 청취(Listening)
           4.5.15.3 Predicting Cooldowns
     4.5.16 Changing Active Gameplay Effect Duration
     4.5.17 런타임에서 GameplayEffect 동적 생성하기
     4.5.18 Gameplay Effect Containers
4.6 Gameplay Abilities
     4.6.1 Gameplay Ability 정의
           4.6.1.1 Replication Policy(리플리케이션 정책)
           4.6.1.2 Server Respects Remote Ability Cancellation
           4.6.1.3 Replicate Input Directly(입력 직접 복제)
     4.6.2 ASC에 입력 바인딩
           4.6.2.1 GameplayAbility를 활성화하지 않고 입력 바인딩
     4.6.3 Ability 부여
     4.6.4 Ability 활성화
           4.6.4.1 패시브 Ability
           4.6.4.2 Activation Failed Tags
     4.6.5 Ability 취소
     4.6.6 활성화된 Ability 얻기
     4.6.7 Instancing Policy
     4.6.8 Net Execution Policy
     4.6.9 Ability Tags
     4.6.10 Gameplay Ability Spec
     4.6.11 Ability에 데이터 전달하기
     4.6.12 Ability Cost and Cooldown
     4.6.13 Ability 레벨업
     4.6.14 Ability Sets
     4.6.15 Ability Batching
     4.6.16 Net Security Policy
4.7 Ability Tasks
     4.7.1 Ability Task 정의
     4.7.2 Custom Ability Tasks
     4.7.3 Ability Tasks 사용
     4.7.4 Root Motion Source Ability Tasks
4.8 Gameplay Cues
     4.8.1 Gameplay Cue 정의
     4.8.2 Triggering Gameplay Cues
     4.8.3 Local Gameplay Cues
     4.8.4 Gameplay Cue Parameters
     4.8.5 Gameplay Cue Manager
     4.8.6 GameplayCue가 발동되지 않도록 방지
     4.8.7 Gameplay Cue Batching(일괄 처리)
           4.8.7.1 수동 RPC
           4.8.7.2 하나의 GE에 여러 개의 GC
     4.8.8 Gameplay Cue Events
     4.8.9 Gameplay Cue Reliability(신뢰성)
4.9 Ability System Globals
     4.9.1 InitGlobalData()
4.10 Prediction
     4.10.1 Prediction Key
     4.10.2 Ability에서 새로운 Prediction Windows 만들기
     4.10.3 액터 스폰 예측
     4.10.4 GAS Prediction 기능의 미래
     4.10.5 Network Prediction Plugin
4.11 Targeting
     4.11.1 Target Data
     4.11.2 Target Actors
     4.11.3 Target Data Filters
     4.11.4 Gameplay Ability World Reticles
     4.11.5 Gameplay Effect Containers Targeting

1. GameplayAbilitySystem Plugin의 소개

Official Documentation 참고,

게임플레이 어빌리티 시스템(Gameplay Ability System) 은 RPG나 MOBA 타이틀에서 볼 수 있는 어빌리티 및 어트리뷰트 유형을 구축하기 위한 고도로 유연한 프레임워크입니다. 게임 내 캐릭터가 사용할 액션이나 패시브 어빌리티, 이러한 액션의 결과로 다양한 어트리뷰트를 높이거나 낮추는 상태 이펙트를 만들 수 있고, '재사용 대기 시간' 타이머나 자원 비용을 구현하여 액션의 사용 빈도를 조절하거나, 어빌리티의 레벨과 레벨에 따른 이펙트를 변경하거나, 파티클 및 사운드 이펙트를 활성화하는 등의 작업이 가능합니다. 게임플레이 어빌리티 시스템을 사용하면 점프처럼 단순한 것부터 최신 RPG나 MOBA 타이틀 내 인기 캐릭터의 기술 모음처럼 복잡한 것까지 다양한 인게임 어빌리티를 설계 및 구현하고 효과적으로 연결할 수 있습니다.

게임플레이어빌리티시스템 플러그인은 Epic Games에서 개발했으며 Unreal Engine에서 사용 가능합니다. 또한 해당 플러그인은 Paragon, Fortnite와 같은 AAA급 상용 게임에서 테스트와 검증을 마쳤습니다.

플러그인은 싱글 및 멀티플레이어 게임에서 바로 사용할 수 있는 다음과 같은 솔루션들을 제공합니다:

조정가능한 자원과 쿨타임을 가진 level-based 캐릭터 능력 혹은 스킬 구현(GameplayAbilities)
액터가 소유한 수치(데이터)Attributes 조작(Attributes)
액터에 상태 효과 적용 (GameplayEffects)
엑터에 GameplayTags 적용 (GameplayTags)
시각 효과 또는 음향 효과 생성 (GameplayCues)
위에 언급된 모든 요소들의 Replication 지원

멀티플레이어 게임에서 GAS는 client-side prediction을 지원합니다:

어빌리티 활성화
애니메이션 몽타주 재생
Attributes 변경
GameplayTags 적용
GameplayCues 스폰
CharacterMovementComponent에 연결된 RootMotionSource를 통한 움직임

GAS는 기본적으로 C++로 개발하는 것을 권장합니다. 하지만 GameplayAbilities와 GameplayEffects는 디자이너가 블루프린트에서 생성할 수도 있습니다.

현재 알려진 GAS 이슈:

GameplayEffect latency reconciliation (can't predict ability cooldowns resulting in players with higher latencies having lower rate of fire for low cooldown abilities compared to players with lower latencies).
Cannot predict the removal of GameplayEffects. We can however predict adding GameplayEffects with the inverse effects, effectively removing them. This is not always appropriate or feasible and still remains an issue.
Lack of boilerplate templates, multiplayer examples, and documentation. Hopefully this helps with that!

어빌리티	입력 바인드	Predicted	C++ / Blueprint	설명
점프	스페이스바	Yes	C++	영웅이 점프합니다.
총	마우스 왼쪽 버튼	No	C++	영웅의 총에서 발사체를 발사합니다. 애니메이션은 예측되지만 발사체는 예측되지 않습니다.
조준경 조준	마우스 오른쪽 버튼	Yes	Blueprint	버튼을 누른 상태에서 영웅은 천천히 걷고 카메라는 확대되어 총으로 더 정확한 조준을 할 수 있습니다.
질주	왼쪽 시프트	Yes	Blueprint	버튼을 누른 상태에서 영웅은 스테미나를 사용하여 더 빠른 속도로 달릴 수 있습니다.
전방 대쉬	Q	Yes	Blueprint	스테미나를 소모하여 전방으로 돌진합니다.
아머 스택(패시브)	패시브	No	Blueprint	매 4초마다 영웅은 최대 4개의 방어력를 획득합니다. 데미지를 받으면 방어력 스택 하나가 제거됩니다.
메테오	R	No	Blueprint	플레이어는 적이 위치한 곳에 메테오를 떨어뜨려 피해를 입히고 기절시킵니다. 타겟팅는 예측되지만 스폰되는 메테오는 예측되지 않습니다.

리플리케이션 모드	사용 시기	설명
`Full`	Single Player	모든 `GameplayEffects`가 모든 클라이언트에 리플리케이트됩니다.
`Mixed`	Multiplayer, Player가 컨트롤하는 `액터`	`GameplayEffects`는 소유 클라이언트에만 리플리케이트됩니다. `GameplayTags`와 `GameplayCues`만 모두에게 리플리케이트됩니다.
`Minimal`	Multiplayer, AI가 컨트롤하는 `액터`	`GameplayEffects`가 아무에게도 리플리케이트되지 않습니다. `GameplayTags`와 `GameplayCues`만 모두에게 리플리케이트됩니다.

Duration 타입	GameplayCue 이벤트	사용 시기
`Instant`	Execute	`Attribute`의 `BaseValue`에 즉각적이고 영구적인 변화를 줄 때 사용합니다. 이 경우 `GameplayTag`는 적용되지 않으며, 한 프레임도 존재하지 않습니다.
`Duration`	Add & Remove	`Attribute`의 `CurrentValue`를 일시적으로 변경하거나 특정 기간 동안 `GameplayTag`를 적용할 때 사용합니다. 해당 기간은 `UGameplayEffect` 클래스 또는 블루프린트에서 정의됩니다.
`Infinite`	Add & Remove	`Attribute`의 `CurrentValue`를 일시적으로 변경하거나 무한으로 `GameplayTag`를 적용할 때 사용합니다. 해당 Effect는 스스로 만료되지 않으며, 반드시 Ability나 `ASC`를 통해 수동으로 제거해야 합니다.

연산	내용
`Add`	`Modifier`에서 지정한 `Attribute`에 결과 값을 더합니다. 빼기를 원할 경우 음수를 사용합니다.
`Multiply`	`Modifier`에서 지정한 `Attribute`에 결과 값을 곱합니다.
`Divide`	`Modifier`에서 지정한 `Attribute`를 결과 값으로 나눕니다.
`Override`	`Modifier`에서 지정한 `Attribute`를 결과 값으로 덮어씁니다.

`Modifier` 타입	내용
`Scalable Float`	`FScalableFloat`는 Data Table의 행(변수)과 열(레벨)을 참조하는 구조체입니다. Scalable Float는 자동으로 지정된 테이블 행의 값을 Ability의 현재 레벨(또는 `GameplayEffectSpec`에서 오버라이드된 레벨)에서 읽습니다. 이 값은 추가적으로 계수(coefficient)를 통해 조정될 수 있습니다. Data Table/Row가 지정되지 않으면 값을 1로 간주하고, 계수를 사용하여 모든 레벨에서 단일 값을 하드 코딩할 수 있습니다.
`Attribute Based`	`Attribute Based` `Modifier`는 `Source` (`GameplayEffectSpec`을 생성한 주체)나 `Target`(`GameplayEffectSpec`을 받은 대상)의 `CurrentValue` 또는 `BaseValue` 를 사용합니다. 이 값은 계수, 전/후 추가 값을 사용해 추가적으로 수정됩니다. `Snapshotting`은 `GameplayEffectSpec`이 생성될 때 백업된 `Attribute` 값을 캡처하며, `Non-Snapshotting`은 `GameplayEffectSpec`이 적용될 때 값을 캡처합니다.
`Custom Calculation Class`	`Custom Calculation Class`는 복잡한 `Modifier`에 가장 큰 유연성을 제공합니다. 이 `Modifier`는 `ModifierMagnitudeCalculation` 클래스를 사용하며, 추가적으로 계수와 전/후 추가 값을 사용해 결과 float 값을 수정할 수 있습니다.
`Set By Caller`	`SetByCaller` `Modifier`는 런타임에 Ability 또는 `GameplayEffectSpec`을 생성한 주체가 외부에서 값을 설정하는 Modifier입니다. 예를 들어, 플레이어가 버튼을 누른 시간에 따라 Ability의 피해량을 설정하려면 `SetByCaller`를 사용할 수 있습니다. `SetByCaller`는 `TMap<FGameplayTag, float>`으로 `GameplayEffectSpec`에 저장됩니다. `Modifier`는 `Aggregator`에 지정된 `GameplayTag`와 연결된 `SetByCaller` 값을 확인하도록 지시합니다. `GameplayTag` 버전만 사용할 수 있으며 `FName` 버전은 비활성화됩니다. `Modifier`가 `SetByCaller`로 설정되었지만 `GameplayEffectSpec`에 올바른 `GameplayTag`와 연결된 `SetByCaller`가 존재하지 않는 경우, 런타임 오류가 발생하고 값이 0으로 반환됩니다. `Divide` 연산의 경우 문제가 발생할 수 있습니다. `SetByCallers`의 사용 방법에 대한 더 많은 정보는 `SetByCaller` 관련 문서를 참조하세요.

스택 유형	설명
Aggregate by Source	각 `Source ASC`마다 타겟에 대한 별도의 스택 인스턴스가 있습니다. 각 Source는 X 만큼의 스택을 적용할 수 있습니다.
Aggregate by Target	타겟에 대해 하나의 스택 인스턴스만 존재합니다. 각 Source는 공유된 스택 한도까지 스택을 적용할 수 있습니다.

제거 정책	설명
Cancel Ability Immediately	`GameplayEffect`가 제거될 때 부여된 Ability는 즉시 취소되고 제거됩니다.
Remove Ability on End	부여된 Ability는 완료될 때까지 유지되며 이후 타겟에서 제거됩니다.
Do Nothing	`GameplayEffect`가 제거되더라도 부여된 Ability는 영향을 받지 않습니다. Ability는 수동으로 제거될 때까지 영구적으로 유지됩니다

카테고리	설명
Gameplay Effect Asset Tags	`GameplayEffect`가 가진 태그입니다. 해당 태그는 별도의 기능을 수행하지 않으며 `GameplayEffect`를 설명하는 용도로만 사용됩니다.
Granted Tags	`GameplayEffect`에 존재하며, 해당 `GameplayEffect`가 적용된 `ASC`에도 전달되는 태그입니다. `GameplayEffect`가 제거되면 `ASC`에서도 태그가 제거됩니다. 이는 `Duration` 및 `Infinite` `GameplayEffect`에만 작동합니다.
Ongoing Tag Requirements	`GameplayEffect`가 적용된 후, 해당 태그들은 `GameplayEffect`가 활성(on) 또는 비활성(off) 상태인지 결정합니다. `GameplayEffect`는 비활성 상태에서도 적용될 수 있습니다. 태그 요구 사항을 충족하지 않아 비활성 상태였던 `GameplayEffect`가 요구 사항을 다시 충족하면, `GameplayEffect`는 활성화되며 그 Modifier를 다시 적용합니다. 이 기능은 `Duration` 및 `Infinite` `GameplayEffect`에서만 작동합니다.
Application Tag Requirements	`GameplayEffect`가 타겟에 적용될 수 있는지 여부를 결정하는 태그입니다. 요구 사항이 충족되지 않으면 `GameplayEffect`는 적용되지 않습니다.
Remove Gameplay Effects with Tags	`GameplayEffect`가 성공적으로 적용되면 타겟의 `Asset Tags`나 `Granted Tags`에 해당 태그를 가진 다른 `GameplayEffect`가 제거됩니다.

Snapshot	Source or Target	`GameplayEffectSpec`의 캡처 시점	`Infinite` 또는 `Duration` `GE`의 `Attribute`가 변경될 경우 자동 업데이트 여부.
Yes	Source	Creation	No
Yes	Target	Application	No
No	Source	Application	Yes
No	Target	Application	Yes

`Instancing Policy`	설명	사용 예시
Instanced Per Actor	각 `ASC`는 활성화 간에 재사용되는 하나의 `GameplayAbility` 인스턴스를 가집니다.	가장 자주 사용되는 `Instancing Policy`입니다. 모든 Ability에 사용할 수 있으며, 활성화 간에 지속성을 제공합니다. 디자이너는 필요시 변수들을 수동으로 리셋해야 합니다.
Instanced Per Execution	`GameplayAbility`가 활성화될 때마다 새로운 인스턴스가 생성됩니다.	변수들이 매번 리셋되므로 해당 `GameplayAbility`는 활성화할 때마다 새로 생성됩니다. 성능은 `Instanced Per Actor`보다 나쁘지만, 변수 리셋이 필요할 때 유용합니다. 샘플 프로젝트에서는 이 방식을 사용하지 않습니다.
Non-Instanced	`GameplayAbility`는 `ClassDefaultObject`에서 작동하며 인스턴스가 생성되지 않습니다.	성능이 가장 좋지만 기능적으로 제한적입니다. `Non-Instanced` `GameplayAbility`는 상태를 저장할 수 없고, 동적 변수를 사용할 수 없으며, `AbilityTask` 델리게이트와 바인딩할 수 없습니다. 주로 MOBA나 RTS에서 자주 사용되는 간단한 Ability(예: 미니언 기본 공격)에 적합합니다. 샘플 프로젝트의 Jump `GameplayAbility`는 `Non-Instanced`입니다.

접두사	에셋 타입
GA_	GameplayAbility
GC_	GameplayCue
GE_	GameplayEffect

`Net Execution Policy`	설명
`Local Only`	`GameplayAbility`는 소유한 클라이언트에서만 실행됩니다. 로컬에서만 시각적 효과를 변경하는 Ability에 유용할 수 있습니다. 싱글 플레이어 게임에서는 `Server Only`를 사용해야 합니다.
`Local Predicted`	`Local Predicted` `GameplayAbility`는 먼저 소유한 클라이언트에서 활성화되고, 그 후 서버에서 실행됩니다. 서버는 클라이언트가 예측한 내용을 수정합니다. 예측에 대한 자세한 내용은 Prediction을 참조해주세요.
`Server Only`	`GameplayAbility`는 오직 서버에서만 실행됩니다. Passive `GameplayAbility`는 보통 `Server Only`입니다. 싱글 플레이어 게임에서는 이 방식을 사용해야 합니다.
`Server Initiated`	`Server Initiated` `GameplayAbility`는 먼저 서버에서 활성화되고, 그 후 소유한 클라이언트에서 실행됩니다. 개인적으로는 이 방법은 많이 사용하지 않았습니다.

Method	설명
Activate `GameplayAbility` by Event	이벤트를 사용하여 데이터 페이로드가 포함된 `GameplayAbility`를 활성화합니다. 이벤트의 페이로드는 로컬 예측(Local Predicted)된 `GameplayAbility`의 경우 클라이언트에서 서버로 복제됩니다. `Optional Object` 또는 `TargetData` 변수는 기존 변수에 맞지 않는 임의의 데이터를 위한 변수로 사용됩니다. 단점은 입력 바인드를 통해 Ability를 활성화할 수 없다는 점입니다. `GameplayAbility`를 이벤트로 활성화하려면, `GameplayAbility`에서 `Trigger`를 설정해야 합니다. `GameplayTag`를 할당하고 `GameplayEvent` 옵션을 선택합니다. 이벤트를 보내려면, 함수 `UAbilitySystemBlueprintLibrary::SendGameplayEventToActor(AActor* Actor, FGameplayTag EventTag, FGameplayEventData Payload)`를 사용합니다.
Use `WaitGameplayEvent` `AbilityTask`	`WaitGameplayEvent` `AbilityTask`를 사용하여 `GameplayAbility`가 활성화된 후 이벤트를 기다리도록 할 수 있습니다. 이벤트 페이로드와 이를 보내는 과정은 `GameplayAbility`를 이벤트로 활성화하는 것과 동일합니다. 단점은 `AbilityTask`에 의해 이벤트가 복제되지 않으므로, `Local Only` 및 `Server Only` `GameplayAbilities`에서만 사용해야 한다는 점입니다. 이벤트 페이로드를 복제하는 자체 `AbilityTask`를 작성할 수 있는 가능성도 있습니다.
Use `TargetData`	커스텀 `TargetData` 구조체는 클라이언트와 서버 간에 임의의 데이터를 전달하는 좋은 방법입니다.
Store Data on the `OwnerActor` or `AvatarActor`	`소유자(OwnerActor)`, `아바타(AvatarActor)`, 또는 참조를 얻을 수 있는 다른 객체에 저장된 리플리케이트된 변수를 사용하십시오. 해당 방법은 가장 유연하며 입력 바인딩으로 활성화된 `GameplayAbility`와 함께 작동합니다. 그러나 해당 방법은 데이터가 사용할 때 리플리케이트를 통해 동기화될 것인지를 보장하지 않습니다. 이를 미리 보장해야 합니다. 즉, 리플리케이트된 변수를 설정한 후 바로 `GameplayAbility`를 활성화하면 패킷 손실로 인해 수신자에서 발생하는 순서를 보장할 수 없습니다.

레벨업 방법	설명
Ungrant and Regrant at the New Level	`ASC`에서 `GameplayAbility`를 제거(Ungrant)한 후, 서버에서 다음 레벨로 다시 부여(Regrant)합니다. 이때 활성화 상태의 `GameplayAbility`는 종료됩니다.
Increase the `GameplayAbilitySpec's` Level	서버에서 해당 `GameplayAbilitySpec`을 찾아 레벨을 증가시키고, 이를 Dirty로 표시하여 소유 클라이언트로 리플리케이트되도록 합니다. 활성화 상태의 `GameplayAbility`는 종료하지 않습니다.

`GameplayTag Container`	설명
`Ability Tags`	`GameplayAbility`가 소유한 `GameplayTag`입니다. 이들은 `GameplayAbility`를 설명하는 데 사용됩니다.
`Cancel Abilities with Tag`	해당 `GameplayAbility`가 활성화될 때, 해당 `Ability Tag`에 포함된 `GameplayTag`를 가진 다른 `GameplayAbility`는 취소됩니다.
`Block Abilities with Tag`	해당 `GameplayAbility`가 활성화되는 동안, 해당 `Ability Tag`에 포함된 `GameplayTag`를 가진 다른 `GameplayAbility`는 활성화될 수 없습니다.
`Activation Owned Tags`	해당 `GameplayAbility`가 활성화되는 동안 소유자에게 주어지는 `GameplayTags`입니다. 단, 이들은 리플리케이되지 않습니다.
`Activation Required Tags`	해당 `GameplayAbility`는 소유자가 모든 해당 `GameplayTag`를 가지고 있어야만 활성화될 수 있습니다.
`Activation Blocked Tags`	해당 `GameplayAbility`는 소유자가 어떤 해당 `GameplayTag`를 가진 경우 활성화될 수 없습니다.
`Source Required Tags`	해당 `GameplayAbility`는 소스가 모든 해당 `GameplayTag`를 가지고 있어야만 활성화될 수 있습니다. `Source`의 `GameplayTag`는 `GameplayAbility`가 이벤트로 트리거될 때만 설정됩니다.
`Source Blocked Tags`	해당 `GameplayAbility`는 소스가 어떤 해당 `GameplayTag`를 가진 경우 활성화될 수 없습니다. `Source`의 `GameplayTag`는 `GameplayAbility`가 이벤트로 트리거될 때만 설정됩니다.
`Target Required Tags`	해당 `GameplayAbility`는 타겟이 모든 해당 `GameplayTag`를 가지고 있어야만 활성화될 수 있습니다. `Target`의 `GameplayTag`는 `GameplayAbility`가 이벤트로 트리거될 때만 설정됩니다.
`Target Blocked Tags`	해당 `GameplayAbility`는 타겟이 어떤 해당 `GameplayTag`를 가진 경우 활성화될 수 없습니다. `Target`의 `GameplayTag`는 `GameplayAbility`가 이벤트로 트리거될 때만 설정됩니다.

`Net Security Policy`	설명
`ClientOrServer`	보안 요구 사항이 없습니다. 클라이언트와 서버 모두 자유롭게 Ability를 실행하고 종료할 수 있습니다.
`ServerOnlyExecution`	클라이언트가 Ability의 실행을 요청하면 서버에서 이를 무시합니다. 클라이언트는 여전히 서버에게 Ability를 취소하거나 종료하도록 요청할 수 있습니다.
`ServerOnlyTermination`	클라이언트가 Ability의 취소나 종료를 요청하면 서버에서 이를 무시합니다. 클라이언트는 여전히 Ability의 실행을 요청할 수 있습니다.
`ServerOnly`	서버가 Ability의 실행과 종료를 모두 제어합니다. 클라이언트가 어떤 요청을 하더라도 무시됩니다.

`GameplayCue` 클래스	이벤트	`GameplayEffect` 타입	설명
`GameplayCueNotify_Static`	`Execute`	`Instant` or `Periodic`	Static `GameplayCueNotify`는 `ClassDefaultObject`에서 작동하며(인스턴스가 없음을 의미) 타격 임팩트와 같은 일회성 효과에 적합합니다.
`GameplayCueNotify_Actor`	`Add` or `Remove`	`Duration` or `Infinite`	Actor `GameplayCueNotify`가 추가되면 새 인스턴스를 스폰합니다. 인스턴스화되어 있기 때문에 제거될 때까지 계속 동작을 할 수 있습니다. backing `Duration` 또는 `Infinite` GameplayEffect가 제거되거나 수동으로 remove를 호출하면 제거되는 사운드 및 파티클 이펙트를 루핑하는 데 좋습니다. 또한 동시에 추가할 수 있는 개수를 관리할 수 있는 옵션도 제공되므로 동일한 효과를 여러 번 적용할 때 사운드나 파티클이 한 번만 시작되도록 할 수 있습니다.

`EGameplayCueEvent`	설명
`OnActive`	`GameplayCue`가 활성화(추가)될 때 호출됩니다.
`WhileActive`	`GameplayCue`가 활성 상태일 때 호출되며, 실제로 바로 적용되지 않았더라도 진행 중인 경우에 호출됩니다(진행 중 조인 등). 이는 `Tick`이 아니며, `GameplayCueNotify_Actor`가 추가되거나 `OnActive`일 때 한 번만 호출됩니다. `Tick()`이 필요하면 `GameplayCueNotify_Actor`의 `Tick()`을 사용해야 합니다. 결국 이것은 `AActor`입니다.
`Removed`	`GameplayCue`가 제거될 때 호출됩니다. 이 이벤트에 응답하는 블루프린트 `GameplayCue` 함수는 `OnRemove`입니다.
`Executed`	`GameplayCue`가 실행될 때 호출됩니다: Instant Effect나 Periodic Tick(). 이 이벤트에 응답하는 블루프린트 `GameplayCue` 함수는 `OnExecute`입니다.

`EGameplayTargetingConfirmation::Type`	타겟이 확인되는 시점
`Instant`	타겟팅은 즉시 발생하며 특별한 로직이나 사용자 입력이 필요하지 않습니다.
`UserConfirmed`	타겟팅은 사용자가 Ability에 바인딩된 Confirm 입력을 통해 또는 `UAbilitySystemComponent::TargetConfirm()`을 호출하여 확인되었을 때 발생합니다. `TargetActor`는 바인딩된 `Cancel` 입력 또는 `UAbilitySystemComponent::TargetCancel()` 호출에 의해 타겟팅을 취소할 수도 있습니다.
`Custom`	GameplayTargeting Ability가 `UGameplayAbility::ConfirmTaskByInstanceName()`을 호출하여 타겟팅 데이터가 준비된 시점을 결정합니다. `TargetActor`는 또한 `UGameplayAbility::CancelTaskByInstanceName()`을 호출하여 타겟팅을 취소할 수 있습니다.
`CustomMulti`	GameplayTargeting Ability가 `UGameplayAbility::ConfirmTaskByInstanceName()`을 호출하여 타겟팅 데이터가 준비된 시점을 결정합니다. `TargetActor`는 또한 `UGameplayAbility::CancelTaskByInstanceName()`을 호출하여 타겟팅을 취소할 수 있습니다. 데이터 생성 시 AbilityTask를 종료하지 않아야 합니다.

Common `TargetActor` Parameters	정의
Debug	`true`일 경우, `TargetActor`가 트레이스를 수행할 때마다 디버그 트레이싱/오버랩 정보를 그려냅니다. Shipping이 아닌 빌드에서만 표시됩니다. 일반적으로 `non-Instant` `TargetActor`는 `Tick()`에서 트레이스를 수행하므로 이 디버그 드로우 호출도 `Tick()`에서 발생합니다.
Filter	[선택] 트레이스/오버랩이 발생할 때 `Actor`를 필터링하는 특수 구조체입니다. 일반적으로 플레이어의 `Pawn`을 제외하거나 특정 클래스만 타겟팅하려는 경우 사용됩니다. 더 고급 사용 사례는 Target Data Filters을 참조하세요.
Reticle Class	[선택] `TargetActor`가 생성할 `AGameplayAbilityWorldReticle`의 서브클래스입니다.
Reticle Parameters	[Optional] Reticle을 설정합니다. Reticles을 참조하세요.
Start Location	트레이싱이 시작될 위치를 설정하는 특수 구조체입니다. 보통 플레이어의 시점, 무기 총구, 또는 `Pawn`의 위치입니다.

[Unreal Engine] GAS Documentation 번역본

Unreal GAS

GAS 문서 번역본

목차

1. GameplayAbilitySystem Plugin의 소개

2. 샘플 프로젝트

3. GAS를 사용하는 프로젝트 설정

4. GAS Concepts

Sections

4.1 Ability System Component

4.1.1 Replication Mode

4.1.2 설정 및 초기화

4.2 Gameplay Tags

4.2.1 GameplayTag 변경에 응답하기

4.2.2 플러그인 .ini 파일에서 GameplayTag 불러오기

4.3 Attributes

4.3.1 Attribute 정의

4.3.2 BaseValue vs CurrentValue

4.3.3 Meta Attributes

4.3.4 Attribute 변경에 응답하기

4.3.5 Derived Attributes

4.4 AttributeSet

4.4.1 AttributeSet 정의

4.4.2 AttributeSet 설계

4.4.2.1 개별 Attribute를 가진 서브 컴포넌트

4.4.2.2 런타임에 AttributeSet 추가 및 제거하기

4.4.2.3 아이템 Attribute (무기 탄약)

4.4.2.3.1 아이템에 일반 float 사용

4.4.2.3.2 아이템의 AttributeSet

4.4.2.3.3 아이템의 ASC

4.4.3 Attribute 정의

4.4.4 Attribute 초기화

4.4.5 PreAttributeChange()

4.4.6 PostGameplayEffectExecute()

4.4.7 OnAttributeAggregatorCreated()

4.5 Gameplay Effects

4.5.1 Gameplay Effect 정의

4.5.2 Gameplay Effect 적용

4.5.3 Gameplay Effect 삭제

4.5.4 Gameplay Effect Modifiers

4.5.4.1 Multiply 및 Divide Modifiers

4.5.4.2 Modifier의 GameplayTag

4.5.5 Gameplay Effect Stacking(중첩)

4.5.6 Ability 부여

4.5.7 Gameplay Effect Tags

4.5.8 면역

4.5.9.1 SetByCallers

4.5.10 Gameplay Effect Context

4.5.11 Modifier Magnitude Calculation

4.5.12 Gameplay Effect Execution Calculation

4.5.12.1 Sending Data to Execution Calculations

4.5.12.1.1 SetByCaller

4.5.12.1.2 Backing Data Attribute Calculation Modifier

4.5.12.1.4 Gameplay Effect Context

4.5.13 Custom Application Requirement

4.5.14 Cost Gameplay Effect

4.5.15 Cooldown Gameplay Effect

4.5.15.1 Cooldown GameplayEffect의 남은 시간 얻어내기

4.5.15.2 Cooldown 시작 및 종료 청취(Listening)

4.5.15.3 Predicting Cooldowns

4.5.16 활성화된 GameplayEffect 지속 시간 변경

4.5.17 런타임에서 GameplayEffect 동적 생성하기

Examples

4.5.18 Gameplay Effect Containers

4.6 Gameplay Ability

4.6.1 Gameplay Ability 정의

4.6.1.1 Replication Policy(리플리케이션 정책)

4.6.1.2 Server Respects Remote Ability Cancellation

4.6.1.3 Replicate Input Directly(입력 직접 복제)

4.6.2 ASC에 입력 바인딩

4.6.2.1 GameplayAbility를 활성화하지 않고 입력 바인딩

4.6.3 Granting Abilities(Ability 부여)

4.6.4 Ability 활성화

4.6.4.1 패시브 Ability

4.6.4.2 Activation Failed Tags

4.6.6 활성화된 Ability 얻기

4.6.7 Instancing Policy

4.6.8 Net Execution Policy

4.6.9 Ability Tags

4.6.10 Gameplay Ability Spec

4.4.2.3.2 아이템의 `AttributeSet`

4.4.2.3.3 아이템의 `ASC`