Is Variable 에 체크가 되어있는데 이 버튼에 클릭 이벤트를 생성하고 함수를 바인딩 하는 과정은 아래에서 다시 설명하겠다.
StartButton 안에 TextBlock을 넣고 StartButtonText 이름으로 변경
게임의 상태에 따라 안의 텍스트 문구는 "Start" 혹은 "Restart"로 변경되도록 C++에서 구현
📌 Menu Level 생성하고 설정
흔히 게임 개발 시 메뉴 전용 맵을 만들어, 그 맵에서는 메뉴만 띄우도록하고, 실제 게임이 시작되면 게임 레벨로 넘어가도록 한다. 이 방식을 사용하면 "Menu UI"와 "Game Level"이 완전히 분리되어, 구조가 더 명확해진다.
nu Level을 만든뒤 Project Settings에서 Editor Startup Map, Game Default Map으로 설정
📌 게임 흐름에 맞게 WBP 전환
메뉴 위젯을 게임이 시작될 때, 게임이 종료 될 때 등 상황에 맞게 표시하고, 유저가 플레이 한다면 숨기고 HUD 위젯을 띄우는 등 자연스러운 전환이 필요하다.
1. 플레이 버튼을 누르면 Menu UI가 가장 먼저 띄워진다. 2. 게임 시작시 자동으로 HUD를 띄운다. 3. Menu가 나타날 때마다, UI 입력모드로 전환하여 버튼 클릭에 집중하게 만드는 방식으로 수정한다. 4. 게임이 종료되면 Menu UI가 다시 뜨도록 한다.
#include "StrikeZonePlayerController.h"
#include "SZ_GameState.h"
#include "SZ_GameInstance.h"
#include "EnhancedInputSubsystems.h"
#include "Blueprint/UserWidget.h"
#include "PlayerCharacter.h"
#include "Drone.h"
#include "Kismet/GameplayStatics.h"
#include "Components/TextBlock.h"
AStrikeZonePlayerController::AStrikeZonePlayerController()
: HUDWidgetClass(nullptr),
HUDWidgetInstance(nullptr),
MainMenuWidgetClass(nullptr),
MainMenuWidgetInstance(nullptr)
{
}
void AStrikeZonePlayerController::BeginPlay()
{
Super::BeginPlay();
// 현재 레벨이 Menu Level이라면, Main Menu 위젯 송출
FString CurrentMapName = GetWorld()->GetMapName();
if (CurrentMapName.Contains("MenuLevel"))
{
ShowMainMenu(false);
}
}
void AStrikeZonePlayerController::ShowGameHUD()
{
if (HUDWidgetInstance)
{
HUDWidgetInstance->RemoveFromParent();
HUDWidgetInstance = nullptr;
}
if (MainMenuWidgetInstance)
{
MainMenuWidgetInstance->RemoveFromParent();
MainMenuWidgetInstance = nullptr;
}
if (HUDWidgetClass)
{
HUDWidgetInstance = CreateWidget<UUserWidget>(this, HUDWidgetClass);
if (HUDWidgetInstance)
{
HUDWidgetInstance->AddToViewport();
bShowMouseCursor = false;
SetInputMode(FInputModeGameOnly());
}
}
ASZ_GameState* GameState = GetWorld() ? GetWorld()->GetGameState<ASZ_GameState>() : nullptr;
if (GameState)
{
GameState->UpdateHUD();
}
}
void AStrikeZonePlayerController::ShowMainMenu(bool bIsReStart)
{
// HUD가 사용중이라면 제거
if (HUDWidgetInstance)
{
HUDWidgetInstance->RemoveFromParent();
HUDWidgetInstance = nullptr;
}
// 메인 메뉴가 사용중이라면 제거
if (MainMenuWidgetInstance)
{
MainMenuWidgetInstance->RemoveFromParent();
MainMenuWidgetInstance = nullptr;
}
// 1. 메인 메뉴 인스턴스 생성
// 2. 메인 메뉴 뷰포트에 송출
// 3. bShowMouseCursor = true, 메뉴에서 마우스 클릭 가능하도록 보여지게 설정
// 4. FInputModeUIOnly 구조체 생성, UI전용 입력모드로 설정
if (MainMenuWidgetClass)
{
MainMenuWidgetInstance = CreateWidget<UUserWidget>(this, MainMenuWidgetClass);
if (MainMenuWidgetInstance)
{
MainMenuWidgetInstance->AddToViewport();
bShowMouseCursor = true;
SetInputMode(FInputModeUIOnly());
}
}
// bool 값에 따라 Button Text를 변경
if (UTextBlock* ButtonText = Cast<UTextBlock>(MainMenuWidgetInstance->GetWidgetFromName(TEXT("StartButtonText"))))
{
if (bIsReStart)
{
ButtonText->SetText(FText::FromString(TEXT("Restart")));
}
else
{
ButtonText->SetText(FText::FromString(TEXT("Start")));
}
}
}
void AStrikeZonePlayerController::StartGame()
{
// 게임 시작 시, GameInstance의 데이터 초기화
if (USZ_GameInstance* GameInstance = Cast<USZ_GameInstance>(UGameplayStatics::GetGameInstance(this)))
{
GameInstance->CurrentLevelIndex = 0;
GameInstance->TotalScore = 0;
}
// 초기 맵 오픈
UGameplayStatics::OpenLevel(GetWorld(), FName("BasicLevel"));
// 게임 진행
SetPause(false)
}
📍 ShowMainMenu( ) / ShowGameHUD( ):
현재 사용중인 위젯이 있다면 UWidget::RemoveFromParent( ) 함수를 사용해 제거. 이 함수는 위젯이 부모로부터 제거될 때 호출되는 가상 함수로, 위젯이 관리되고 있는 경우 게임 뷰포트 서브시스템에서 제거하거나, 현재 부모 위젯으로 부터 제거하는 함수이다.
각 함수에 맞는 위젯을 생성.
bShowMouseCursor 를 통해 마우스를 숨길지 여부를 결정
MainMenu의 경우 마우스를 통해 UI와 상호작용을 해야한다. 이때 UI에 포커스가 가도록 하려면 SetInputMode 계열 함수를 사용해 PlayerController가 어느 입력을 우선으로 처리할지 결정한다.
FInputModeUIOnly 구조체를 생성해 이것으로 SetInputMode를 설정하면, 플레이어의 마우스 입력과 키 입력이 먼저 UI로 전달된다. 이때 캐릭터 이동이나 시야 회전 등 게임 월드 입력은 잠시 비활성화되고, UI와의 상호작용에 집중할 수 있다.
ShowMainMenu( ) 함수의 경우 매개변수 bool 값에 따라 Button Text를 "Start" 혹은 "Restart" 로 변경
📍 StartGame( ):
GameInstance의 데이터를 초기화
UGameplayStatics::OpenLevel( ) 함수로 초기 맵 "BasicLevel"을 오픈
