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

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

Section 2 : GAS에 대한 기본 설명과 셋업

---

AbilitySystemInterface

{프로젝트명}.bulid.cs

• 인터페이스 사용하기 위해서 모듈 등록 필요 : "GameplayAbilities"

PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" , "EnhancedInput", "GameplayAbilities" });

• 인터페이스 구현을 통해 여러 환경에서 ASC(AbilitySystemComponent)에 접근할 수 있도록한다.
  - GetAbilitySystemComponent() 사용 (순수가상함수로 정의되어있음)

UAbilitySystemComponent* AAuraCharacterBase::GetAbilitySystemComponent() const
{
	return AbilitySystemComponent;
}

---

서버

데디케이트 서버 : 플레이어 X, 렌더링 X
리슨 서버 : 플레이어가 직접 호스팅, 호스트는 지연시간 X

데이터 유효성은 서버가 기준점이 된다.

• 서버와 클라이언트 정보가 다르다면 서버가 덮어씌움
• 게임모드도 서버가 관리하며 클라는 접근 X

모든 컨트롤러에 대한 권한은 서버가 가지며 클라는 각자가 소유한 컨트롤러만 관리한다

플레이어 스테이트 정보는 클라이언트에도 모두 존재한다.

HUD,Widget은 클라이언트에만 존재하면 된다.

• 화면에 표시될 정보는 굳이 서버가 관리할 필요없이 각자의 클라이언트에서 표현되면 됨

Replication은 서버 -> 클라 단방향이다.

---

ASC(Ability System Component)

생성과 할당

캐릭터의 멤버인 경우

직접 생성 후 할당하면 된다.

AAuraEnemy::AAuraEnemy()
{
	AbilitySystemComponent = CreateDefaultSubobject<UAuraAbilitySystemComponent>("AbilitySystemComponent");
    // 리플리케이션 사용
	AbilitySystemComponent->SetIsReplicated(true); 
    // AI여서 Minial 모드로 사용
	AbilitySystemComponent->SetReplicationMode(EGameplayEffectReplicationMode::Minimal); 
}

플레이어 스테이트의 멤버인 경우

스테이트에서 생성 후 캐릭터에 할당한다.

AAuraPlayerState::AAuraPlayerState()
{
	AbilitySystemComponent = CreateDefaultSubobject<UAuraAbilitySystemComponent>("AbilitySystemComponent");
    // 리플리케이션 사용
	AbilitySystemComponent->SetIsReplicated(true);
    // 플레이어에서 쓸 거라 Mixed 모드 사용
	AbilitySystemComponent->SetReplicationMode(EGameplayEffectReplicationMode::Mixed);
}

---

InitAbilityActorInfo

ASC는 2개의 Actor 정보를 사용한다.

1. OwnerActor

2. AvatarActor : Owner가 캐릭터가 아닌 경우 캐릭터에 접근하기 용이함

Player Controlled Character 예시처럼 PlayerState가 ASC를 들고있는 경우
ASC의 OwnerActor는 PlayerState가 되고 AvatarActor는 Character가 된다.

---

함수 호출 시점

액터가 모두 생성된 이후 ASC에 AbliltyActorInfo를 할당해야하므로 Possession이 일어난 이후를 기준으로 한다.

1. 플레이어 캐릭터

1-1. Pawn이 ASC를 들고있는 경우

• 서버 : PossessedBy()
• 클라 : AcknowledgePossession()

1-2. PlayerState가 ASC를 들고있는 경우

• 서버 : PossessedBy()
• 클라 : OnRep_PlayerState() : RepNotify 사용

-> 1-2의 경우 ASC가 PlayerState에 들어있기 때문에 PlayerState가 Valid한지도 체크해야하기 때문에 RepNotify로 확인하는 것
-> PlayerState가 리플리케이션되는 시점에는 플레이어 컨트롤러가 Possess된 이후이므로 안전하다.

void AAuraCharacter::PossessedBy(AController* NewController)
{
	Super::PossessedBy(NewController);
	// 서버 전용
	//if (HasAuthority()) 체크 안 해도 되는 게 이미 Server에서만 호출되는 함수임
	InitAbilityActorInfo();
}

void AAuraCharacter::OnRep_PlayerState()
{
	Super::OnRep_PlayerState();
	// 클라이언트 전용
	InitAbilityActorInfo();
}

// InitAbilityActorInfo도 호출하고 State가 생성해둔 컴포넌트도 캐릭터에 할당해주는 두가지 역할
void AAuraCharacter::InitAbilityActorInfo()
{
	AAuraPlayerState* PlayerState = GetPlayerState<AAuraPlayerState>(); // 템플릿 버전이 있음
	check(PlayerState);
	AbilitySystemComponent = PlayerState->GetAbilitySystemComponent();
	AbilitySystemComponent->InitAbilityActorInfo(PlayerState, this); // OwnerActor != AvatarActor
}

---

2. AI 캐릭터

예제에서 AI 캐릭터는 직접 ASC를 들고있고, 일반적으로 BeginPlay 시점에서 컨트롤러 할당도 되어있기 때문에 바로 BeginPlay에서 호출한다.

void AAuraEnemy::BeginPlay()
{
	Super::BeginPlay();
	
	AbilitySystemComponent->InitAbilityActorInfo(this,this); // OwnerActor == AvatarActor
}

---

Replication Mode

ASC 리플리케이션 모드는 3가지가 있다.

• Full : 싱글 플레이
• Mixed : 플레이어 컨트롤러
• Minimal : Ai 컨트롤러

주의 사항

Mixed 모드 사용시 ASC의 OwnerActor의 Owner는 항상 Controller 클래스여야한다.

• State 클래스가 OwnerActor인 경우 자동으로 Controller 클래스로 잡아주기 때문에 상관 없음
• Pawn 클래스도 마찬가지
• 그 외의 액터 클래스 A를 ASC의 OwnerActor로 사용할 때는 A.SetOwner() 를 통해 강제로 Controller로 잡아준 뒤 사용할 것

---

커밋

https://github.com/jongmin7759/Unreal_GAS/commit/e651ac220a9aa7b74f10b4b3d3e344510e289ef1