[UE/Basic] 치트 매니저 (Cheat Manager)

1. 개요

오늘은 기능 테스트에 유용한

치트 매니저에 대해 정리해보고자 한다.

 

2. 치트 매니저란?

Console창

언리얼에는 콘솔 창에서 실행할 수 있는 명령어를 관리하는 클래스이다.

 

치트 매니저 클래스를 살펴보면 다양한 콘솔 명령어들을 수행하는 함수들이 정의되어 있다.

 

 

3. 치트 매니저 활용

PlatyerControler > Details

치트 매니저는 플레이어 컨트롤러에서 설정할 수 있다.

 

우리가 직접 CheatManger를 상속한 클래스를 만들어

플레이어 컨트롤러에 등록하면

직접 구현한 콘솔 명령어들을 실행할 수 있다.

 

4. 치트 매니저 장점

치트 매니저는 기능 테스트 목적으로 사용된다.

 

예를 들어,

미션을 달성하지 못했지만 다음 레벨로 바로 넘어가 테스트하고 싶은 경우

명령어를 통해 레벨을 넘길 수 있다.

 

또는 특정 아이템을 테스트해보고 싶지만

그것을 얻기 위해서는 일정 플레이가 필요한 경우

명령어를 통해 즉시 아이템을 소환할 수 있다.

 

즉,

특정한 상황을 만들어야 할 때

치트 매니저는 유용하게 사용될 수 있다.

 

5. 치트 매니저 구현

5.1 클래스 생성

Tools > New C++ Class > CheatManager

언리얼 에디터 창에서 CheateManger를 C++ 클래스로 생성한다.

 

5.2 명령어 함수 선언

UCLASS()
class MAIN_API UStageCheatManager : public UCheatManager
{
	GENERATED_BODY()

public:
	// 콘솔 명령어 함수 구현 
	UFUNCTION(exec)
	void MoveNextLevel();
};

콘솔 명령어 함수를 선언한다.

• UFUCNTION(exec) 지정자를 설정한다.
• 함수를 선언한다.
• 함수의 이름은 콘솔창에서 명령어 이름이 된다.

 

5.3 명령어 함수 정의

void UStageCheatManager::MoveNextLevel()
{
	if (GetWorld() == nullptr)
		return;

	if (AStageGameState* GameStage = GetWorld()->GetGameState<AStageGameState>())
	{
		GameStage->EndLevel();
	}
}

해당 함수에서는 명령어 입력 시

다음 레벨로 넘어가는 기능을 수행한다.

 

5.4 플레이어 컨트롤러 속성 변경

PlayerController > Details

플레이어 컨트롤러에서 Cheat Class를 생성한 치트 매니저로 변경한다.

 

6. 테스트

콘솔 명령어를 통해

다음 레벨로 이동하는 것을 확인할 수 있다.