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

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

Section 1 : 프로젝트 생성과 캐릭터, 인풋 등 기본 셋업을 다루고 있음

---

Enhanced Input

{프로젝트명}.bulid.cs

• EnhancedInput 사용하기 위해서 모듈 등록 필요

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

Input Mapping Context , Input Action 필요

// AuraPlayerController 클래스의 멤버
	UPROPERTY(EditAnywhere, Category="Input")
	TObjectPtr<UInputMappingContext> AuraContext;
	UPROPERTY(EditAnywhere, Category="Input")
	TObjectPtr<UInputAction> MoveAction;

EnhancedInput Subsystem에 등록

• EnhancedInputLocalPlayerSubsystem에 InputMappingContext 추가하기
• Subsystem은 싱글톤 클래스
• check()으로 ValidCheck : Throw ASSERT

void AAuraPlayerController::BeginPlay()
{
	Super::BeginPlay();
	// Assert , 인풋이 제대로 안 되면 어차피 게임 못함
	check(AuraContext);

	UEnhancedInputLocalPlayerSubsystem* Subsystem = ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(GetLocalPlayer());
	check(Subsystem);
	Subsystem->AddMappingContext(AuraContext,0);
}

SetupInputComponent에서 InputAction과 동작 함수 바인딩하기

• InputComponent는 컨트롤러에 원래 있는 멤버고 프로젝트 설정에서 인핸스드인풋 컴포넌트가 디폴트 클래스로 설정되어 있기 때문에 캐스팅이 가능한 것.(디폴트 클래스 변경하면 안 될 수 있음)
• CastChecked<>() : 캐스팅 + Valid Check (반드시 성공해야하는 상황에 사용)

void AAuraPlayerController::SetupInputComponent()
{
	Super::SetupInputComponent();

	// 프로젝트 디폴트 설정에 인핸스드인풋 컴포넌트가 설정되어 있기때문에 캐스팅 가능
	UEnhancedInputComponent* EnhancedInputComponent = CastChecked<UEnhancedInputComponent>(InputComponent);
	EnhancedInputComponent->BindAction(MoveAction,ETriggerEvent::Triggered,this,&AAuraPlayerController::Move);

}

입력 데이터 받아오기

• FInputActionValue 를 적절한 데이터 유형으로 캐스팅해서 사용 (InputAction에 이미 설정된 유형이 있음)

void AAuraPlayerController::Move(const FInputActionValue& InputActionValue)
{
	const FVector2d InputAxisVector = InputActionValue.Get<FVector2D>();
...
}

---

캐릭터

bOrientRotationToMovement : 입력 방향에 따라 캐릭터 회전

AAuraCharacter::AAuraCharacter()
{
	// 탑다운 뷰로 진행되는 게임이므로 카메라는 고정되어있고 입력 방향에 따라 캐릭터가 회전하도록 설정
	GetCharacterMovement()->bOrientRotationToMovement = true;
	GetCharacterMovement()->RotationRate = FRotator(0.f, 400.f, 0.f);
    // 캐릭터가 바닥에 붙어있도록 설정
	GetCharacterMovement()->bConstrainToPlane = true;
	GetCharacterMovement()->bSnapToPlaneAtStart = true;

	bUseControllerRotationPitch = false;
	bUseControllerRotationYaw = false;
	bUseControllerRotationRoll = false;
}

---

래퍼(Wrapper)

TObjectPrt<T> : 스마트 포인터

• 패키지 버전에서는 그냥 포인터(Raw Pointer)와 동일하게 동작하지만 에디터에서는 추가 기능을 지원한다.
• 클래스 멤버에 포인터를 쓸 때 TObjectPrt<T> 사용 권장
• Access Tracking , Lazy Loading ... 지원

UPROPERTY(EditAnywhere,Category="Combat")
	TObjectPtr<USkeletalMeshComponent> Weapon;

---

TScriptInterface<T> : 인터페이스 포인터 래퍼

• 인터페이스 포인터를 멤버로 직접 두는 대신 포인터 사용 권장

TScriptInterface<IEnemyInterface> LastActor;

---

FName

FName 구조체는 대소문자 구별이 없는 간소화된 문자열이므로 굳이 텍스트 매크로 사용하지 않고 바로 넘겨줘도 괜찮다.

AAuraCharacterBase::AAuraCharacterBase()
{
	PrimaryActorTick.bCanEverTick = false;

	// FName에는 텍스트 매크로 쓰지 않아도 됨 , FString에 사용 
	Weapon = CreateDefaultSubobject<USkeletalMeshComponent>("Weapon");
	Weapon->SetupAttachment(GetMesh(),"WeaponHandSocket");
}

---

캐릭터 외곽선 효과 - Custom Depth Stencil Pass

1. 프로젝트 세팅 - 엔진 렌더링 세팅 - Custom Depth Stencil Pass 부분 - Enable with Stencil로 설정

2. 포스트 프로세스 볼륨에 머티리얼 추가 필요
   (머티리얼은 따로 만들어줘야 함. 이 강의에서는 같이 제공해주는 외곽선 머티리얼을 사용했음)

3. 액터에서 렌더 옵션 켜주기
   SetCustomDepthStencilValue(CUSTOM_DEPTH_RED) : 머티리얼에서 사용한 커스텀 밸류와 일치시켜주면 된다.
   SetRenderCustomDepth(true)

AAuraEnemy::AAuraEnemy()
{
	GetMesh()->SetCollisionResponseToChannel(ECC_Visibility,ECR_Block);
	// #define 매크로를 사용해서 상수 사용 최소화
	GetMesh()->SetCustomDepthStencilValue(CUSTOM_DEPTH_RED);
	if (Weapon)
	{
		Weapon->SetCustomDepthStencilValue(CUSTOM_DEPTH_RED);
	}
}

void AAuraEnemy::HighlightActor()
{
	GetMesh()->SetRenderCustomDepth(true);
	if (Weapon)
	{
		Weapon->SetRenderCustomDepth(true);
	}
}

LastActor와 ThisActor를 활용한 액터 선택 경우의 수

/**
 	 * Line trace from cursor. There are several scenarios:
 	 *  A. LastActor is null && ThisActor is null
 	 *		- Do nothing
 	 *	B. LastActor is null && ThisActor is valid
 	 *		- Highlight ThisActor
 	 *	C. LastActor is valid && ThisActor is null
 	 *		- UnHighlight LastActor
 	 *	D. Both actors are valid, but LastActor != ThisActor
 	 *		- UnHighlight LastActor, and Highlight ThisActor
 	 *	E. Both actors are valid, and are the same actor
 	 *		- Do nothing
 	 */
 
 	if (LastActor == nullptr)
 	{
 		if (ThisActor != nullptr)
 		{
 			// Case B
 			ThisActor->HighlightActor();
 		}
 		else
 		{
 			// Case A - both are null, do nothing
 		}
 	}
 	else // LastActor is valid
 	{
 		if (ThisActor == nullptr)
 		{
 			// Case C
 			LastActor->UnHighlightActor();
 		}
 		else // both actors are valid
 		{
 			if (LastActor != ThisActor)
 			{
 				// Case D
 				LastActor->UnHighlightActor();
 				ThisActor->HighlightActor();
 			}
 			else
 			{
 				// Case E - do nothing
 			}
 		}
 	}

---

인터페이스

마우스를 올렸을 때 원하는 액터에 다양하게 유동적으로 적용할 수 있도록 인터페이스를 만들었다.

Unreal Interface의 자식 클래스

UINTERFACE(MinimalAPI)
class UEnemyInterface : public UInterface
{
	GENERATED_BODY()
};
class AURA_API IEnemyInterface
{
	GENERATED_BODY()

public:
	// 순수 가상 함수
	virtual void HighlightActor() = 0;
	virtual void UnHighlightActor() = 0;
};

---

인터페이스 상속 받기

UCLASS()
class AURA_API AAuraEnemy : public AAuraCharacterBase, public  IEnemyInterface // 인터페이스 상속
{
	GENERATED_BODY()

public:
	AAuraEnemy();
	
	virtual void HighlightActor() override;
	virtual void UnHighlightActor() override;
	
};

---

전방선언

포인터나 참조형 멤버인 경우 헤더에 해당 클래스나 구조체를 사용하기 위해 다른 헤더를 include 할 필요가 없다.

• BasePawn 클래스 멤버에 캡슐 컴포넌트 포인터가 들어가는 상황
• 전방 선언 없이 BasePawn.h 파일에 Capsule~.h를 인클루드하면 BasePawn 헤더를 포함하는 다른 클래스들이 나올 때마다 사용하지 않을 캡슐 컴포넌트 정보까지 같이 포함하게 되므로 파일이 무의미하게 커지게 됨
• 반면 전방 선언을 통해 클래스 포인터라는 것만 알려주고 실제 구현 부분인 cpp 파일에 캡슐 컴포넌트 헤더 파일을 포함해 컴파일한다면 나중에 BasePawn 헤더를 포함하더라도 캡슐 컴포넌트가 딸려가지 않아 효율적임
  • ex) class UCapsuleComponent* CapsuleComp;

AuraPlayerController 예시

// 전방선언
class IEnemyInterface;
struct FInputActionValue; // Ftype 구조체는 struct로 전방선언
class UInputAction;
class UInputMappingContext;


UCLASS()
class AURA_API AAuraPlayerController : public APlayerController
{
	GENERATED_BODY()

public:
	AAuraPlayerController();
	virtual void PlayerTick(float DeltaTime) override;

protected:
	virtual void BeginPlay() override;
	virtual void SetupInputComponent() override;
	

private:
	UPROPERTY(EditAnywhere, Category="Input")
	TObjectPtr<UInputMappingContext> AuraContext; // 전방선언
	UPROPERTY(EditAnywhere, Category="Input")
	TObjectPtr<UInputAction> MoveAction; // 전방선언
	
	void Move(const FInputActionValue& InputActionValue); // 전방선언
	void CursorTrace();
	TScriptInterface<IEnemyInterface> LastActor; // 전방선언
	TScriptInterface<IEnemyInterface> ThisActor; // 전방선언
};

---

커밋

https://github.com/jongmin7759/Unreal_GAS/commit/78bec3f628f2db222f3c95159b420ca135ac8360