Weekend8

Kyu_·2026년 1월 17일

개인공부

목록 보기

3/4

6번과제하기

요구사항 해석

간단한 퍼즐용 오브젝트를 준비하는 과제인데 회전 발판, 이동 플랫폼등 동적으로 움직이는 발판을 만들고 이거를 C++로직, Tick함수로 제어하는 과제

최소 2가지 이상의 C++ Actor클래스를 가져야하고, ㄴStaticMeshComponent를 가져야 한데, 이것들은 그냥 발판으로 2가지 이상 만들면 될 것 같다.

Tick함수를 활용해서 회전, 이동 발판을 만들어야 하고 리플렉션 시스템을 이용해서 각각 다른속도, 이동범위, 회전값등을 적용해보고 실험도 해보자

또, 마지막으로 타이머 시스템을 활용해서 일정 시간 후에 발판이 사라지거나 주기걱으로 다른 위치로 이동하는 추가 구현과제랑
SpawnActor를 통해 임의 좌표에 여러개 배치하는 랜덤 스테이지의 기초개념을 공부할 수 있는 추가 구현 과제도 구현해보자

체크포인트

--- 필수 과제 ---

--- 도전 과제 ---

타이머를 통해서 발판 사라지고 주기적으로 이동하는거 구현
랜덤하게 발판 배치되는 랜덤퍼즐 생성해보기

--- 과제를 끝내며 ---

AI보다는 공식문서를 많이 활용했는가??

레벨 꾸미기

우선 New level에서 Basic을 선택 한 후 Scale을 4로 줄인 발판 3개를 만들었다.
각각 1만씩 떨어져있으며 왼쪽부터 시작, 중간지점, 끝 이렇게 나누었다.
- 시작 <-> 중간 : 필수과제
- 중간 <-> 끝 : 도전과제

GameMode, Default Map지정

Default Map은 만든 Level로 지정을 해주고, 게임모드는 BP로 상속한 게임모드를 지정
- 레벨을 여러개 사용하지 않을것이라 전역으로 게임모드를 지정해주기만 했다.

C++ 클래스 만들기

캐릭터 만들기

캐릭터 클래스 생성 + 블루프린트
IA, IMC만들고 BP_MyPlayerController에 매핑
LocalPlayerSubsystem을 통해 IMC를 활성화

RotatingPlatform 만들기

스태틱메시로는 별을 선택했고, 콜리전이 없어서 에셋에디터에서 Collision을 Use Complex Collision As Simple로 설정했다.
발판이 회전하면서 캐릭터도 같이 돌아주기 때문에 캐릭터에서 GetCharacterMovement()->bIgnoreBaseRotation = true;로 주었다.

발판이 한쪽으로만 이동하는 문제

기존 코드

void AMovingPlatform::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);

    if (!FMath::IsNearlyZero(MoveSpeed))
    {
        if (GetActorLocation().X > MaxRange) {
            MoveDirection *= -1;
        }
        AddActorLocalOffset(FVector(MoveSpeed * MoveDirection * DeltaTime, 0.0f, 0.0f));
    }
}

수정 코드

void AMovingPlatform::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);

    if (!FMath::IsNearlyZero(MoveSpeed))
    {
        if (FMath::Abs(StartLocation.X - GetActorLocation().X) > MaxRange) {
            MoveDirection *= -1;
        }
        AddActorLocalOffset(FVector(MoveSpeed * MoveDirection * DeltaTime, 0.0f, 0.0f));
    }
}

FMath::Abs를 사용했다.
- 시작지점의 X값과 현재 X값을 비교해서 절대값비교
발판 이동속도도 너무 느린것같아서 에디터에서 기존 50.0f에서 150.0f로 3배 늘려주었다.

FinishZone만들기

void AFinishZone::BeginPlay()
{
	Super::BeginPlay();
    Collision->OnComponentBeginOverlap.AddDynamic(this, &AFinishZone::OnOverlap);
}

void AFinishZone::OnOverlap(
    UPrimitiveComponent* OverlappedComponent,
    AActor* OtherActor,
    UPrimitiveComponent* OtherComp,
    int32 OtherBodyIndex,
    bool bFromSweep,
    const FHitResult& SweepResult)
{
    if (!OtherActor) return;

    if (HUDWidgetClass)
    {
        APlayerController* PlayerController = GetWorld()->GetFirstPlayerController();
        if (PlayerController)
        {
            UUserWidget* HUDWidget = CreateWidget<UUserWidget>(PlayerController, HUDWidgetClass);
            if (HUDWidget)
            {
                HUDWidget->AddToViewport();
            }

            PlayerController->SetIgnoreMoveInput(true);
            PlayerController->SetIgnoreLookInput(true);
            PlayerController->bShowMouseCursor = true;
            UKismetSystemLibrary::QuitGame(this, PlayerController, EQuitPreference::Quit, false);
        }
    }
}

위젯을 만들고 OnOverlap이라는 함수를 통해 FinishZone에 닿았을때 게임오버가 출력되도록 만들었다.
- 타이머가 없어서 종료위젯없이 바로 종료되었다.

타이머 구현하기

--- h ---

// 타이머
FTimerHandle QuitTimerHandle;

UFUNCTION()
void QuitGameDelayed();

--- cpp ---

GetWorld()->GetTimerManager().SetTimer(
    QuitTimerHandle,
    this,
    &AFinishZone::QuitGameDelayed,
    2.0f,
    false // 반복없게끔
);

void AFinishZone::QuitGameDelayed()
{
    APlayerController* PlayerController = GetWorld()->GetFirstPlayerController();
    UKismetSystemLibrary::QuitGame(this, PlayerController, EQuitPreference::Quit, false);
}

헤더에서 FTimerHandle을 선언해주고 SetTimer의 인자로 넘겨줄 함수 선언
GetWorld()->GetTimerManager().SetTimer로 2초후 게임이 종료되게끔

순간이동, 사라지는 발판

회전하는 발판에서 사라지는것을 구현하고, 이동하는 발판에서 순간이동을 구현하기로 하였다.

사라지는 발판

// ARotatingPlatform.h

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Timer")
bool bUseToggle = false;

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Timer")
float TimerDelay = 2.0f;

UFUNCTION()
void ToggleVisibility();

FTimerHandle TimerHandle;
bool bIsVisible;

// ARotatingPlatform.cpp

void ARotatingPlatform::BeginPlay()
{
    Super::BeginPlay();

    if (bUseToggle) {
        GetWorld()->GetTimerManager().SetTimer(
            TimerHandle,
            this,
            &ARotatingPlatform::ToggleVisibility,
            TimerDelay,
            true  // 반복
        );
    }
}

void ARotatingPlatform::ToggleVisibility()
{
    bIsVisible = !bIsVisible;

    SetActorHiddenInGame(!bIsVisible);
    SetActorEnableCollision(bIsVisible);
}

bUseToggle : true면 TimerDelay마다 발판 사라지고 나타나고 반복

앞 회전 발판은 bUseToggle을 true로 지정하였다. (뒤 회전발판은 false)

순간이동 발판

// AMovingPlatform.h
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Moving")
bool bUseTeleportMode = false;
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Moving")
float TimerDelay = 2.0f;

FTimerHandle TeleportTimerHandle;

UFUNCTION()
void TeleportToRandom();

// AMovingPlatform.cpp

void AMovingPlatform::BeginPlay()
{
    Super::BeginPlay();
    ...

    if (bUseTeleportMode) {
    PrimaryActorTick.bCanEverTick = false;
    GetWorld()->GetTimerManager().SetTimer(
        TeleportTimerHandle,
        this,
        &AMovingPlatform::TeleportToRandom,
        TimerDelay,
        true
    );
    }
}

void AMovingPlatform::TeleportToRandom()
{
    float RandomX = StartLocation.X + FMath::RandRange(-MaxRange, MaxRange);
    FVector RandomLocation(RandomX, StartLocation.Y, StartLocation.Z);

    SetActorLocation(RandomLocation);
}

bUseTeleportMode : false면 기존처럼 Tick에서 이동, true면 텔레포트 모드
- TimerDelay마다 범위내에서 발판이 순간이동

발판 랜덤스폰

UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Spawning")
TArray<TSubclassOf<ARotatingPlatform>> PlatformClasses;

UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Spawning")
float TimerDelay;

UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Spawning")
TArray<ARotatingPlatform*> SpawnedPlatforms;

UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Spawning")
int32 SpawnCount;

FTimerHandle TimerHandle;

UFUNCTION(BlueprintCallable, Category = "Spawning")
void SpawnRandomPlatforms();

FVector GetRandomPointInVolume() const;

// SpawnVolume.cpp

void ASpawnVolume::BeginPlay()
{
	Super::BeginPlay();

    SpawnRandomPlatforms();

    GetWorldTimerManager().SetTimer(
        TimerHandle,
        this,
        &ASpawnVolume::SpawnRandomPlatforms,
        TimerDelay,
        true
    );
}

void ASpawnVolume::SpawnRandomPlatforms()
{
    for (ARotatingPlatform* Platform : SpawnedPlatforms)
    {
        if (Platform && Platform->IsValidLowLevel())
        {
            Platform->Destroy();
        }
    }
    SpawnedPlatforms.Empty();

    for (int32 i = 0; i < SpawnCount; ++i)
    {
        int32 RandomIndex = FMath::RandRange(0, PlatformClasses.Num() - 1);
        TSubclassOf<ARotatingPlatform> SelectedClass = PlatformClasses[RandomIndex];

        if (!SelectedClass) continue;

        FVector SpawnLocation = GetRandomPointInVolume();
        ARotatingPlatform* SpawnedPlatform = GetWorld()->SpawnActor<ARotatingPlatform>(
            SelectedClass, SpawnLocation, FRotator::ZeroRotator,
            FActorSpawnParameters()
        );

        if (SpawnedPlatform)
        {
            SpawnedPlatform->bUseToggle = FMath::RandBool();
            if (SpawnedPlatform->bUseToggle) {
                SpawnedPlatform->TimerDelay = FMath::RandRange(1.0f, 3.0f);
            }
            SpawnedPlatform->RotationSpeed = FMath::RandRange(50.0f, 200.0f);

            SpawnedPlatforms.Add(SpawnedPlatform);
        }
    }
}

FVector ASpawnVolume::GetRandomPointInVolume() const
{
    FVector Origin = SpawningBox->GetComponentLocation();
    FVector BoxExtent = SpawningBox->GetScaledBoxExtent();

    return FVector(
        FMath::RandRange(Origin.X - BoxExtent.X, Origin.X + BoxExtent.X),
        FMath::RandRange(Origin.Y - BoxExtent.Y, Origin.Y + BoxExtent.Y),
        FMath::RandRange(Origin.Z - BoxExtent.Z, Origin.Z + BoxExtent.Z)
    );
}

PlatformClasses : 스폰될 플랫폼들 블루프린트에서 지정
SpawnedPlatforms : 스폰된 플랫폼들을 저장해놓음, 다음 랜덤 플랫폼들이 스폰될때 Destroy하기 위함
SpawnCount : 스폰될 발판 수
SpawnRandomPlatforms : 기존 발판 삭제하고 다시 랜덤위치 재생성