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

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

Section 6 : GameplayTags

---

GameplayTags

추가하기

1. 프로젝트 세팅에서 직접 추가

2. 데이터 테이블 활용하기

RowType : GameplayTagTableRow 로 DT 만들고
프로젝트 세팅의 테이블 리스트에 추가하기

3. .ini 파일에서 직접 추가

---

GameplayEffect와 결합하기

Components에서 추가 가능

Tags This Effect Has (Asset Tags)

이펙트 자체를 설명하는 태그 개념

---

Grant Tags To Target Actor

이펙트 타겟에게 태그를 달아준다.
이펙트 효과가 끝나면 해당 태그도 타겟에게서 사라진다.

• 따라서 Instant Effect에서는 의미 없는 컴포넌트 (바로 사라지니까)
  
  

스택 개념
태그도 이펙트처럼 스택이 가능하다.
하지만 이펙트의 스택 상태에 따라 태그의 스택도 달라진다.

• 이펙트가 스택 가능한 경우
  : 태그는 1회만 스택된다.
  ex - 스택 가능한 회복 이펙트를 4번 받았더라도 태그 스택은 1회,
  스택 가능한 1개의 이펙트 태그를 추가하는 것으로 본다.

• 이펙트가 스택되지 않는 경우
  : 태그가 계속 스택된다.
  ex - StackingType None 이펙트를 4번 받았으면 태그 스택도 4회 쌓인다.

이외에도 `Block Abilities with Tags`등 태그에 관련된 여러 컴포넌트가 있음.

---

GameplayEffect Delegate 활용

이펙트가 적용될 때 불러오는 OnGameplayEffectAppliedDelegateToSelf 델리게이트를 통해 EffectSpec에 접근하고 GetAll~Tags()를 통해 해당 이펙트에 결합된 태그 정보를 받아올 수 있다.

예제의 경우 MVC를 구조를 유지하기위해 ASC에서 함수 바인딩 및 브로드캐스팅 처리

void UAuraAbilitySystemComponent::AbilityActorInfoSet()
 {
    // 델리게이트 바인딩
 	OnGameplayEffectAppliedDelegateToSelf.AddUObject(this,&UAuraAbilitySystemComponent::EffectApplied);
 }
 
 void UAuraAbilitySystemComponent::EffectApplied(UAbilitySystemComponent* AbilitySystemComponent,
                                                 const FGameplayEffectSpec& EffectSpec, FActiveGameplayEffectHandle ActiveEffectHandle)
 {
 	FGameplayTagContainer TagContainer;
 	EffectSpec.GetAllAssetTags(TagContainer);
 	// 컨트롤러에서 바인딩한 델리게이트를 브로드캐스트
 	EffectAssetTags.Broadcast(TagContainer);
 	
 }

FGameplayTagContainer

• 태그를 담기에 최적화된 컨테이너 (TArray대신 이 컨테이너 사용 권장)

EffectAssetTags 델리게이트

// BP에서 바인딩하지 않고 WidgetController에 바인딩할 것이므로 Dynamic X
DECLARE_MULTICAST_DELEGATE_OneParam(FEffectAssetTags, const FGameplayTagContainer& /*AssetTags*/);

WidgetController에서 람다 함수 바인딩

// Effect Delegate 바인딩
	Cast<UAuraAbilitySystemComponent>(AbilitySystemComponent)->EffectAssetTags.AddLambda(  // 람다 함수 [capture](param){body}
		[this](const FGameplayTagContainer& AssetTags)
		{
			for (FGameplayTag Tag : AssetTags)
			{
				// 태그가 메시지인 경우에만 메시지 델리게이트를 사용하도록 필터링
				FGameplayTag MessageTag = FGameplayTag::RequestGameplayTag("Message");
				if (Tag.MatchesTag(MessageTag))
				{
					// [] 안에 this 멤버 넣어주지 않으면 람다 함수 내에서는 정보가 없어서 멤버 함수 호출을 못함.
                    // []를 통해 외부 변수를 캡쳐해서 사용한다.
                    const FUIWidgetRow* Row = GetDataTableRowByTag<FUIWidgetRow>(MessageWidgetDataTable,Tag);
                    MessageWidgetRowDelegate.Broadcast(*Row);
				}
			}
		}
	);

---

DataTable 정보로 UI 메시지 띄우기

DataTable

FUIWidgetRow를 RowType으로 사용하는 DataTable을 만들고 엔진에서 값을 넣어준다.

// DataTable에 사용할 구조체 (TableRowBase 상속)
 USTRUCT(BlueprintType)
 struct FUIWidgetRow : public FTableRowBase
 {
 	GENERATED_BODY()
 
 	UPROPERTY(EditAnywhere, BlueprintReadOnly)
 	FGameplayTag MessageTag = FGameplayTag();
 	
 	UPROPERTY(EditAnywhere, BlueprintReadOnly)
 	FText MessageText = FText();
 
 	UPROPERTY(EditAnywhere, BlueprintReadOnly)
 	TSubclassOf<UAuraUserWidget> MessageWidget;
 
 	UPROPERTY(EditAnywhere, BlueprintReadOnly)
 	UTexture2D* Image = nullptr;
 };

컨트롤러 헤더에 멤버와 메소드 추가

 {
 	...
 	// 컨트롤러를 통해 DT에 있는 정보 접근할 수 있도록 변수 추가
 	UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Widget Data")
 	TObjectPtr<UDataTable> MessageWidgetDataTable;
 	...
 
 	// 태그로 임의의 테이블 로우 반환하도록 템플릿 함수 만들기
 	template<typename T>
 	T* GetDataTableRowByTag(UDataTable* DataTable, const FGameplayTag& Tag);
 }

 template <typename T>
 T* UOverlayWidgetController::GetDataTableRowByTag(UDataTable* DataTable, const FGameplayTag& Tag)
 {
 	// 행 이름을 태그 이름과 일치하게 만들었기 때문에 이렇게 찾을 수 있음
 	return DataTable->FindRow<T>(Tag.GetTagName(),TEXT("")/*미사용*/);
 }

MessageWidgetDataTable은 엔진에서 추가

람다 함수가 호출되면

const FUIWidgetRow* Row = GetDataTableRowByTag<FUIWidgetRow>(MessageWidgetDataTable,Tag);
MessageWidgetRowDelegate.Broadcast(*Row);

바인딩했던 OverlayWidget(View)에서 메시지 위젯 생성 및 표시

---

Attribute 클램핑

PreAttributeChange()

CurrentValue에만 영향을 준다.
BaseValue까지 바꾸려면 PostGameplayEffectExecute()에서 확실히 Set으로 클램핑하기

PreAttributeChange에서만 클램핑한 경우 생길 수 있는 오류
(겉으로 보기에 MaxHealth인 100을 넘지 않았지만 BaseValue는 이미 초과되어있어 다른 연산을 할 때 오류가 생김)

PostGameplayEffectExecute()

PreAttributeChange()에서는 모디파이어 적용 전에 호출되는 값만 변경되므로
BaseValue 클램핑이 제대로 되어있지 않기때문에 게임플레이 이펙트 적용 이후 다시 값을 클램핑해줄 필요가 있다.
나중에 BaseValue 연산할 때 겉으로 보기에만 최댓값 유지 중이고
실제 Value가 그 이상이라면 실제 Value부터 값을 깎기때문에 이펙트 적용이 제대로 되지 않고 있는 것처럼 보일 수 있다.

if (Data.EvaluatedData.Attribute == GetHealthAttribute())
{
	SetHealth(FMath::Clamp(GetHealth(),0.f,GetMaxHealth()));
}
if (Data.EvaluatedData.Attribute == GetManaAttribute())
{
	SetMana(FMath::Clamp(GetMana(),0.f,GetMaxMana()));
}

---

GhostGlobe

프로그레스바가 자연스럽게 줄어드는 것처럼 보이기 위해 추가 게이지를 덧대는 효과.

반투명한 프로그레스바를 하나 더 만들고 원래 게이지가 변화할 때 딜레이를 주고 추가 게이지가 변화하도록 설정.

Tick과 Interpolation, TargetPercent 활용

GhostGlobeSet에서는 Delay 이후 GhostPercentTarget이 Set되도록 하고있음

GhostGlobe 초기화를 위해 GhostInitialized 변수로 분기 나누기
(초기화를 따로 안 해주면 GhostGlobe가 ProgressBar와 다른 상태로 시작하고 보간하는 모습이 보여지게됨)

---

커밋

https://github.com/jongmin7759/Unreal_GAS/commit/fde64d9d202e1d45ba24b8c6085e4e4ff7846719
https://github.com/jongmin7759/Unreal_GAS/commit/3d539fa0da30163b2c3e22e5ba2760811dd325b9