praca_magisterska/games/unreal/tutorial/part-6-cpp-create-game-director.md

Part 6 (C++): Create Game Director

← Previous: Part 5 (C++) - Create Enemy Spawner | Back to Index | Next: Part 7 (C++) - Create UI →

---

Overview

Create a Game Director to manage the game timer, victory/defeat conditions, and overall game state.

Time: ~10 minutes

---

Step 6.1: Create STGGameDirector C++ Class

1. Tools → New C++ Class → Actor → Name: STGGameDirector
2. Wait for compilation

---

Step 6.2: Define Game Director Variables

STGGameDirector.h:

⚠️ IMPORTANT: Replace YOURPROJECTNAME_API with your actual project's API macro (e.g., BULLETHELLCPP_API).

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "STGGameDirector.generated.h"

UCLASS()
class YOURPROJECTNAME_API ASTGGameDirector : public AActor
{
    GENERATED_BODY()
    
public:    
    ASTGGameDirector();

protected:
    virtual void BeginPlay() override;

public:    
    virtual void Tick(float DeltaTime) override;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Game")
    float GameDuration = 300.0f;

    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Game")
    float ElapsedTime = 0.0f;

    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Game")
    bool bGameActive = true;

    void OnPlayerDied();
    void OnVictory();
    void OnGameOver();
};

---

Step 6.3: Implement Game Director

STGGameDirector.cpp:

#include "STGGameDirector.h"
#include "Kismet/GameplayStatics.h"

ASTGGameDirector::ASTGGameDirector()
{
    PrimaryActorTick.bCanEverTick = true;
}

void ASTGGameDirector::BeginPlay()
{
    Super::BeginPlay();
    ElapsedTime = 0.0f;
    bGameActive = true;
}

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

    if (!bGameActive)
        return;

    ElapsedTime += DeltaTime;

    // Display timer on screen (key 0 = persistent slot for timer)
    if (GEngine)
    {
        int32 Minutes = FMath::FloorToInt(ElapsedTime / 60.0f);
        int32 Seconds = FMath::FloorToInt(FMath::Fmod(ElapsedTime, 60.0f));
        FString TimeStr = FString::Printf(TEXT("Time: %02d:%02d"), Minutes, Seconds);
        GEngine->AddOnScreenDebugMessage(0, 0.0f, FColor::White, TimeStr);
    }

    // Check for victory (survived full duration)
    if (ElapsedTime >= GameDuration)
    {
        OnVictory();
    }
}

void ASTGGameDirector::OnPlayerDied()
{
    OnGameOver();
}

void ASTGGameDirector::OnVictory()
{
    bGameActive = false;
    
    if (GEngine)
    {
        int32 Minutes = FMath::FloorToInt(ElapsedTime / 60.0f);
        int32 Seconds = FMath::FloorToInt(FMath::Fmod(ElapsedTime, 60.0f));
        FString Msg = FString::Printf(TEXT("VICTORY! You survived %02d:%02d!"), Minutes, Seconds);
        GEngine->AddOnScreenDebugMessage(-1, 999.0f, FColor::Green, Msg);
    }
    
    // Pause game
    UGameplayStatics::SetGamePaused(GetWorld(), true);
}

void ASTGGameDirector::OnGameOver()
{
    bGameActive = false;
    
    if (GEngine)
    {
        int32 Minutes = FMath::FloorToInt(ElapsedTime / 60.0f);
        int32 Seconds = FMath::FloorToInt(FMath::Fmod(ElapsedTime, 60.0f));
        FString Msg = FString::Printf(TEXT("GAME OVER! Survived %02d:%02d"), Minutes, Seconds);
        GEngine->AddOnScreenDebugMessage(-1, 999.0f, FColor::Red, Msg);
    }
    
    // Pause game
    UGameplayStatics::SetGamePaused(GetWorld(), true);
}

---

Step 6.4: Update Player Death to Notify Director

In STGPawn.cpp, update HandleDeath():

void ASTGPawn::HandleDeath()
{
    SetActorHiddenInGame(true);
    
    // Find and notify Game Director
    TArray<AActor*> FoundDirectors;
    UGameplayStatics::GetAllActorsOfClass(GetWorld(), ASTGGameDirector::StaticClass(), FoundDirectors);
    if (FoundDirectors.Num() > 0)
    {
        ASTGGameDirector* Director = Cast<ASTGGameDirector>(FoundDirectors[0]);
        if (Director)
        {
            Director->OnPlayerDied();
        }
    }
}

Add include: #include "STGGameDirector.h"

---

Step 6.5: Place Director in Level and Test

1. Drag STGGameDirector from C++ Classes into level
2. Press Play
3. Wait 5 minutes OR let player die

Expected Result:

• ✅ Timer counts up from 0
• ✅ After 300 seconds: "VICTORY!" message, game pauses
• ✅ If player dies: "GAME OVER!" message, game pauses

---

← Previous: Part 5 (C++) - Create Enemy Spawner | Back to Index | Next: Part 7 (C++) - Create UI →