본문 바로가기

GAS #1 - 빌드 설정, AttributeSet, ASC

@exqt2026. 11. 5. 03:27

우선 C++애서 GAS 를 사용하기 위해 Build.cs에 GAS 관련 모듈을을 추가한다.

PublicDependencyModuleNames.AddRange(new string[]
{
	"GameplayAbilities",
	"GameplayTasks",
	"GameplayTags",
});

 

 

사용자 AttributeSet.h 정의 

GAS에서 제일 장황한 부분인데, 좀 더 간단하게 처리하는 방법이 없을까 찾아봤는데 딱히 없는거 같다.

에디터에서 매크로 기능을 지원한다면 하나 만들어 두거나 생성형 AI에 부탁하는 편이 좋을 것 같다.

 

헤더 파일에선 포함하고자 하는 FGameplayAttributeData들을 아래와 같이 선언한다.

  • UPROPERTY에 ReplicatedUsing을 설정하고 해당 Attribute 전용 OnRep 메소드를 생성
  • ATTRIBUTE_ACCESSORS_BASIC 매크로를 사용하여 추가적인 Getter/Setter 정의 (UE 5.6+)
    • Health에 대해 추가 했다면 GetHealthAttribute(), GetHealth(), SetHealth(), InitHealth() 메소드가 생성된다.
class MOBA_API UMOBAAttributeSet : public UAttributeSet
{
	GENERATED_BODY()
public:
	UMOBAAttributeSet();
	virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;

	UPROPERTY(BlueprintReadOnly, ReplicatedUsing = OnRep_Health, Category = "MOBA Attribute Set")
	FGameplayAttributeData Health;
	ATTRIBUTE_ACCESSORS_BASIC(ThisClass, Health)
    
	UPROPERTY(BlueprintReadOnly, ReplicatedUsing = OnRep_MaxHealth, Category = "MOBA Attribute Set")
	FGameplayAttributeData MaxHealth;
	ATTRIBUTE_ACCESSORS_BASIC(ThisClass, MaxHealth)    
    
	UFUNCTION()
	void OnRep_Health(const FGameplayAttributeData& OldValue);
  
	UFUNCTION()
	void OnRep_MaxHealth(const FGameplayAttributeData& OldValue);
}

 

사용자 AttributeSet.cpp 구현

만든 Attribute들을 GetLifetimeReplicatiedProps에서 DOREPLIFETIME_CONDITION_NOTIFY로 복제 받을 수 있도록 한다.

  • COND_None으로 모든 클라이언트에게 조건 없이 복제되도록 하고
  • REPNOTIFY_OnChanged 대신 항상 REPNOTIFY_Always를 사용한다.
    • 일반 DOREPLIFETIME을 사용했다면 OnChanged라 DOREPLIFETIME_CONDITION_NOTIFY를 사용해야 한다
    • OnChanged의 경우 값이 같은 경우 OnRep 호출이 안되는데 GAS에선 내부적으로 필요해서 Always를 사용한다.
  • OnRep 에선 GAMEPLAYATTRIBUTE_REPNOTIFY 를 사용하여 ASC 쪽에 Attribute가 복제되었음을 알린다.
void UMOBAAttributeSet::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
{
	Super::GetLifetimeReplicatedProps(OutLifetimeProps);

	DOREPLIFETIME_CONDITION_NOTIFY(ThisClass, Health, COND_None, REPNOTIFY_Always);
	DOREPLIFETIME_CONDITION_NOTIFY(ThisClass, MaxHealth, COND_None, REPNOTIFY_Always);
	// ...
}

void UMOBAAttributeSet::OnRep_Health(const FGameplayAttributeData& OldValue)
{
	GAMEPLAYATTRIBUTE_REPNOTIFY(ThisClass, Health, OldValue);
}

void UMOBAAttributeSet::OnRep_MaxHealth(const FGameplayAttributeData& OldValue)
{
	GAMEPLAYATTRIBUTE_REPNOTIFY(ThisClass, MaxHealth, OldValue);
}

// ...

 

 

ASC 생성 및 InitAbilityInfo

기본적으로 실제 캐릭터에 ASC를 생성하지만, 캐릭터와 상태(PlayerState) 가 분리 되어야 한다면 (죽어서 Actor가 사라지고 다시 부활해야 하는 경우) ASC를 PlayerState에 넣고 ASC에 Onwer Actor, Avatar Actor를 분리해서 지정 가능하다.

 

PlayerState에 넣는 경우로 진행할 경우 Owner Actor와 Avatar Actor 클래스에 각각 IAbilitySystemInterface의 

virtual UAbilitySystemComponent* GetAbilitySystemComponent() const = 0;

구현하여 실제 ASC가 어디 있는지 반환할 수 있도록 해야 한다.

 

UAbilitySystemComponent* AMOBAPlayerCharacter::GetAbilitySystemComponent() const
{
	AMOBAPlayerState* MOBAPlayerState = Cast<AMOBAPlayerState>(GetPlayerState());
	return MOBAPlayerState->GetAbilitySystemComponent();
}

 

ASC 초기화의 경우

 

서버, 클라이언트 둘 다 ASC를 들고 있어야 되는데 클라이언트 측에서 먼저 초기화 시도 시 PlayerState가 복제되지 않아 문제가 생길 수 있으므로 클라이언트는 OnRep_PlayerState 시점에 확실히 복제된 이후 InitAbilityActorInfo를 진행해야 한다.


Onwer 와 Avatar가 동일하더라도 ASC에서 PlayerController를 사용하기 때문에 이 경우에는 PlayerController가 복제되는 시점에 처리해야 한다.

 

싱글 플레이어 게임이거나 AI 의 경우, 위의 경우가 해당되지 않으므로 BeginPlay에서 한번만 해도 무방하다.

 

ASC가 PlayerState에 있는 경우

void AMOBACharacter::PossessedBy(AController* NewController)
{
    Super::PossessedBy(NewController);

    if (AMOBAPlayerState* PS = GetPlayerState<AMOBAPlayerState>())
    {
        PS->GetAbilitySystemComponent()->InitAbilityActorInfo(PS, this);
    }
}

void AMOBACharacter::OnRep_PlayerState()
{
    Super::OnRep_PlayerState();

    if (AMOBAPlayerState* PS = GetPlayerState<AMOBAPlayerState>())
    {
        PS->GetAbilitySystemComponent()->InitAbilityActorInfo(PS, this);
    }
}

 

ASC가 Character에 있는 경우 경우

void AMOBACharacter::PossessedBy(AController* NewController)
{
	Super::PossessedBy(NewController);
	AbilitySystemComponent->InitAbilityActorInfo(this, this);
}

void AMOBACharacter::OnRep_Controller()
{
	Super::OnRep_Controller();
	AbilitySystemComponent->InitAbilityActorInfo(this, this);
}

 

Attribute 확인

  • 콘솔창에 "showdebug AbilitySystem" 을 입력하여 레벨에 존재하는 Avatar의 Attribute 들의 값을 보거나 소유한 Gameplay Tag들을 확인할 수 있다.
  • PageUp PageDown으로 다른 Avatar들을 순회할 수 있다.

'Unreal > GAS' 카테고리의 다른 글

기본 Ability Task 목록  (0) 2026.11.03
exqt
@exqt :: exqt

gamedev

안녕하세요.

목차