Udemy Unreal - Gameplay Ability System - Top Down RPG (Section 7)

📖 유데미 GAS 강의 중 기록해두고 싶은 내용을 적어둔 포스트

Section 7 : GameplayEffect Modifier

---

GameplayAttribute 초기화

데이터 테이블 활용하기

AbilitySystemComponent의 AttributeTest 카테고리에서
DefaultStartingData에 데이터 테이블 채우기

AttributeMetaData Row를 사용하는 데이터 테이블을 만들어서 사용하면 된다.

🖐️ RowName은 반드시 {AttributeSet 이름}.{Attribute 이름}의 구조를 지켜야한다.
ex) AuraAttributeSet.Strength

BaseValue만 확실히 채우면 되고 이외의 값은 스택 제외하고는 참고만.
(해당 기능 자체가 프로토타입이라 많이 쓰이지는 않고 후술할 이펙트를 통해 초기화하는 방법을 많이 쓴다고 함)

---

GameplayEffect 활용하기

Attribute 초기화를 위한 이펙트를 만들어서 캐릭터 초기화 시점에 이펙트 적용하기

Primary Attribute는 정해진 값으로 초기화하고, 그 자체로 다른 Attribute에 영향을 받지 않는 값들이기 때문에 Duration Policy : Instant로 1회 초기화해준다.

반면 Derived Attribute는 다른 값에 의해 영향을 받기 때문에 다른 값 변화에 대응이 가능하도록 Duration Policy : Infinite로 설정해준다.

• 이렇게 하면 다른 값 변화에 따른 재계산 처리를 따로 해줄 필요없이 알아서 갱신됨
• Infinite로 계속 GameplayEffect가 살아있는 상태이기때문

---

Modifier

연산자 적용 순서

🖐️ 연산자 우선순위가 적용되는 것이 아니라 순차적으로 계산된다.

---

Calculation Type

Attribute Based

Backing Attribute의 값을 기반으로 계산한다.

🖐️ Coefficient , Pre , Post 의 계산 순서에 주의하기

• Pre를 더한 뒤 Coefficient가 곱해지고 그 값에 Post를 더해준다.

---

Custom Calculation Class (MMC)

👍 Attribute뿐만 아니라 소스나 타겟이 들고 있는 다양한 데이터를 활용해서 계산이 가능하도록 해준다.

UGameplayModMagnitudeCalculation 클래스를 활용한다.

처음 C++ 클래스를 생성하면 아무것도 없는 상태이므로 다음 과정이 필요하다.

1. 생성자 만들기
2. 계산 함수 CalculateBaseMagnitude_Implementation 오버라이드
3. 필요한 Attribute 캡처(FGameplayEffectAttributeCaptureDefinition)
   3-1. 생성자에서 ACCESSOR 매크로 통해 MyAttributeSet에 만들어진 함수로 할당 AttributeToCapture - 어떤 Attribute 캡처할지
   3-2. 해당 Attribute를 이펙트의 Source에서 받아올지, Target에서 받아올지 지정
   3-3. 스냅샷 여부 설정
4. RelevantAttributesToCapture에 캡처할 Attribute 추가하기
5. GetCapturedAttributeMagnitude로 원하는 Attribute의 값을 받아오고
6. 원하는 값으로 조정한 뒤 CalculateBaseMagnitude_Implementation의 결과로 리턴

📘 MMC_MaxHealth.h

UCLASS()
class AURA_API UMMC_MaxHealth : public UGameplayModMagnitudeCalculation
{
	GENERATED_BODY()
public:
	// 1. 생성자 만들기
	UMMC_MaxHealth();
	// 2. 계산 함수 오버라이드
	virtual float CalculateBaseMagnitude_Implementation(const FGameplayEffectSpec& Spec) const override;

private:
	// 3. 캡처를 위한 멤버 추가
	FGameplayEffectAttributeCaptureDefinition VigorDef;
};

📖 MMC_MaxHealth.cpp

UMMC_MaxHealth::UMMC_MaxHealth()
{
	// 3-1. 특정 Attribute 캡처
	VigorDef.AttributeToCapture = UAuraAttributeSet::GetVigorAttribute();
    // 3-2. Attribute Source 지정
	// MaxHealth의 경우 플레이어 캐릭터가 스탯 초기화할 때 사용하고 있으므로 Source == Target
	VigorDef.AttributeSource = EGameplayEffectAttributeCaptureSource::Target;
    // 3-3. 스냅샷 여부 설정
	// Attribute의 기준점을 어느 시기로 할 것인가.
	// True : EffectSpec이 생성되자마자 , False : Effect의 적용 시점에
	VigorDef.bSnapshot = false;
	// 4. 리스트에 Attribute 추가하기
	RelevantAttributesToCapture.Add(VigorDef);
}

float UMMC_MaxHealth::CalculateBaseMagnitude_Implementation(const FGameplayEffectSpec& Spec) const
{

	// Source와 Target의 태그 정보 접근 가능
	const FGameplayTagContainer* SourceTags = Spec.CapturedSourceTags.GetAggregatedTags();
	const FGameplayTagContainer* TargetTags = Spec.CapturedTargetTags.GetAggregatedTags();

	FAggregatorEvaluateParameters EvaluationParameters;
	EvaluationParameters.SourceTags = SourceTags;
	EvaluationParameters.TargetTags = TargetTags;

	// 5. 필요한 Attribute의 현재값 받아오기
	// Vigor는 OutParam
	float Vigor = 0.f;
	GetCapturedAttributeMagnitude(VigorDef,Spec,EvaluationParameters,Vigor);
	// 클램핑 (0보다 낮아지지 않도록)
	Vigor = FMath::Max<float>(Vigor,0.f);

	// Source 오브젝트 받아오기 (이 경우 AuraCharacter의 레벨을 알아내기 위함)
	ICombatInterface* CombatInterface = Cast<ICombatInterface>(Spec.GetContext().GetSourceObject());
	const int32 PlayerLevel = CombatInterface->GetCombatLevel();
	
    // 6. 원하는 값으로 조정한 뒤 리턴
	return 80.f + 2.5f * Vigor + 10.f * PlayerLevel;
}

---

커밋

https://github.com/jongmin7759/Unreal_GAS/commit/41a52805e8ed6f9b0e4d2cd34efe4a68461bf805