Ihr Projekt einrichten und kompilieren

Bevor du anfängst

Stellen Sie sicher, dass Sie Folgendes getan haben:

• Installed Unreal Engine und Visual Studio für die Unreal Engine eingerichtet

• Projekte und Actors kennengelernt und erfahren, wie man im Unreal Editor navigiert

• Lesen Sie Ein erstes First-Person-Abenteuerspiel programmieren 

Mit einer Vorlage beginnen

Dieses Tutorial beginnt mit einem Blueprint-basierten Projekt, das Beispiel-Assets enthält. Sie werden nach und nach Code hinzufügen, der die bestehende Blueprint-Funktionalität repliziert und erweitert. Auf diese Weise lernen Sie, neue Klassen in einem neuen C++-Projekt zu erstellen und dabei die entsprechenden Blueprints als Referenz zu verwenden.

Um ein neues Spiel-Projekt aus einer Vorlage zu erstellen, befolgen Sie diese Schritte:

1. Öffnen Sie die Unreal Engine. Gehen Sie im Unreal-Projektbrowser zur Spiele -Kategorie und wählen Sie die Vorlage First Person.

   

2. Behalten Sie in den Projektvorgaben den Projekttyp auf Blueprint bei. Das bedeutet, die Unreal Engine erstellt ein Projekt mit Blueprint-Standard-Assets anstatt C++-Assets. 

3. Wählen Sie für die Variante Arena-Shooter aus.

4. Benenne dein Projekt. Dieses Tutorial verwendet AdventureGame als Projektnamen.

5. Klicken Sie auf Erstellen, um Ihr neues Projekt im Editor zu öffnen.

Erweiterten Input verifizieren

Mit dem Erweiterten Eingabesystem können Sie die Bewegung Ihres Charakters steuern, indem Sie benutzerdefinierte Input-Actions erstellen, die definieren, welche Actions Ihr Charakter ausführen kann, z. B. Springen oder Ducken. Jede Input-Action existiert als Daten-Asset, das Sie im Code referenzieren können, um zwischen Ihrem Code und Ihrem Charakter zu kommunizieren. 

Später in diesem Tutorial werden Sie Input-Actions und Code kombinieren, damit Ihr Charakter sich bewegen und umsehen kann.

Das Erweiterte Eingabesystem sollte in Ihrem Projekt bereits aktiviert sein. Befolgen Sie diese Schritte, um dies zu überprüfen:

1. Gehen Sie im Menü des Unreal Editors ins Menü Bearbeiten und wählen Sie Plugins.

2. Suchen Sie nach Enhanced Input. Das Plugin sollte installiert und aktiviert sein.

   

Mehr Informationen zum Erweiterten Eingabesystem und den Input-Actions finden Sie hier: Enhanced Input.

Erstellen Sie eine C++-Spiel-Modus-Klasse

Ihr Blueprint-basiertes Projekt verfügt nicht über C++-Dateien oder ein Visual-Studio-Projekt, mit dem Sie arbeit können. Als Nächstes erstellen Sie Ihre erste Klasse und führen C++ in Ihr Projekt ein. Erstellen Sie zuerst eine benutzerdefinierte Spiel-Modus-Klasse, die die Unreal Engine anweist, das Visual-Studio-Projekt und die Dateien zu generieren, die Sie zum Programmieren benötigen. Ihre benutzerdefinierte Klasse wird von der AGameModeBase-Parent-Klasse abgeleitet.

Spiel-Modus-Assets definieren die Regeln, Siegbedingungen und die verwendeten Charaktere eines Spiels. Der Spiel-Modus legt auch die Standard-Gameplay-Framework-Klassen fest, die Ihr Projekt verwendet, darunter den Pawn, PlayerController und HUD. Später in diesem Tutorial werden Sie Ihren Spiel-Modus verwenden, um den Standard-Spieler-Charakter zu ändern.

Um eine neue Spiel-Modus-C++-Klasse zu erstellen, befolgen Sie diese Schritte:

1. Gehen Sie im Menü des Unreal Editors zu Werkzeuge > Neue C++-Klassen.

2. Suchen und wählen Sie im Fenster Parent-Klasse auswählen die Spiel-Modus-Basis und klicken Sie auf Weiter. 

   

3. Geben Sie einen Namen für die neue Klasse ein und klicken Sie dann auf Klasse erstellen. Dieses Tutorial verwendet AdventureGameMode. 

   

4. Es erscheinen zwei Warnmeldungen, die Sie benachrichtigen, dass Sie Ihr C++-Projekt mindestens einmal aus VS kompilieren müssen, bevor die Klassen im Inhaltsbrowser erscheinen. Klicken Sie auf OK und dann bei der zweiten Warnung auf Ja , um Ihren Code zu öffnen. 

Ihr Projekt erstellen

Bevor Sie anfangen, Code hinzuzufügen, sollten Sie die Vorbereitung Ihrer Umgebung abschließen, indem Sie Ihr Projekt in VS erstellen und den Unreal Editor aktualisieren. 

Projekt in Visual Studio öffnen

Falls die Engine Sie nicht automatisch aufgefordert hat, Ihr Projekt in VS zu öffnen, nachdem Sie die Spiel-Modus-Klasse erstellt haben, gehen Sie im Menü des Unreal Editors zu Werkzeuge und wählen Sie Visual Studio öffnen. 

Hier finden Sie auch standardmäßig die .sln-Datei Ihres Projekts in /Documents/Unreal Projects/[Projektname].

Wenn Sie Visual Studio öffnen, sehen Sie Ihre Projektdateien im Lösungs-Explorer.

Wenn Sie Ihr erstes Unreal-Engine-C++-Projekt in VS öffnen, sehen Sie eventuell im Lösungs-Explorer eine Warnung über fehlende Komponenten. Klicken Sie auf Installieren, damit VS sämtliche zusätzlichen Komponenten installieren darf, die für Ihr Projekt erforderlich sind.

Öffnen Sie im Lösungs-Explorerden Eintrag Spiele > [Projektname] > Quelle > [Projektname]. Hier befinden sich die Hauptdateien für Ihr Spiel, darunter zwei Dateien für Ihren neuen Spiel-Modus, [GameModeName].cpp und [GameModeName].h.

Das Projekt erstellen und den Unreal Editor aktualisieren

Damit der Unreal Editor Ihr Code-Projekt erkennt und Ihre C++-Klassen in den Inhaltsbrowser eingebunden werden, müssen Sie Ihr Projekt aus VS heraus erstellen und den Editor neu starten. 

Befolgen Sie diese Schritte, um Ihr Projekt zu erstellen, damit dessen Klassen im Unreal Editor erscheinen:

1. Klicken Sie im Lösungs-Explorer unter Spiele > [Projektname] auf Ihr Projekt und wählen Sie Build aus.  

2. Wenn der Build abgeschlossen ist, kehren Sie zurück zum Unreal Editor und prüfen Sie, ob in der unteren Werkzeugleiste die Schaltfläche Kompilieren erschienen ist und ob ein neuer C++-Klassen-Ordner im Inhaltsbrowser aufgetaucht ist. 

   

3. Wenn sie nicht erscheinen, schließen Sie den Editor und öffnen Sie Ihr Projekt erneut. Beim Öffnen des Editor wird Ihr Projekt neu kompiliert und der UE wird mitgeteilt, dass Ihre C++-Klassen existieren. Falls die Unreal Engine Sie dazu auffordert, Ihr Projekt neu zu erstellen, klicken auf Ja.  

Live Coding deaktivieren

Deaktivieren Sie Live Coding im Unreal Editor, bevor Sie Ihren Code erneut kompilieren. Mit Live Coding können Sie C++-Code in Implementierungsdateien (.cpp) ändern und neu erstellen, während die Engine läuft; es folgt jedoch einem anderen Kompilierungs-Workflow und kann zu Fehlern führen, wenn Sie Header-Dateien (.h) bearbeiten oder aus Visual Studio heraus kompilieren. Live Coding ist nützlich, wenn Sie mit einer entwickelten Codebasis arbeiten, wir empfehlen aber, die Funktion zu deaktivieren, wenn Sie ein neues Projekt starten.

Um Live Coding zu deaktivieren, klicken in der unteren Werkzeugleiste des Editors auf die drei Punkte neben der Schaltfläche Kompilieren und deaktivieren Sie Live Coding aktivieren.

Eine C++-Klasse zu Blueprints erweitern 

Nachdem Sie nun Ihren eigenen benutzerdefinierten Spiel-Modus erstellt haben, erweitern Sie ihn auf Blueprints, um seine Eigenschaften dem Editor zur Verfügung zu stellen, und legen Sie dann diesen neuen Blueprint als Standard-Spiel-Modus Ihres Projekts fest. 

Wenn Sie Ihre Spiel-Modus-Klasse um Blueprints erweitern, werden Klassenwerte direkt im Editor angezeigt, anstatt alles über Code zu erledigen. Der Blueprint agiert als Child der C++-Klasse und erbt die gesamte Funktionalität der Klasse.

Befolgen Sie diese Schritte, um ein Blueprint-Asset von Ihrer GameMode-Klasse abzuleiten:

1. Gehen Sie im Inhaltsbrowser-Asset-Baum zu C++-Klassen > [Projektname], um die von Ihnen erstellten C++-Klassen zu finden.

2. Klicken Sie mit der rechten Maustaste auf Ihre Spiel-Modus-Basis-Klasse und wählen Sie Blueprint-Klasse basierend auf [GameModeBaseName] erstellen aus. 

   

3. Benennen Sie im Fenster Blueprint-Klasse hinzufügen Ihren Blueprint mit dem Präfix BP_, damit Sie ihn später identifizieren können. Dieses Tutorial verwendet BP_AdventureGameMode. 

4. Wählen Sie für den Pfad Alles > Inhalt > FirstPerson > Blueprintsund klicken Sie dann auf Klasse erstellen. 

   

   Die Unreal Engine öffnet den Blueprint automatisch in einem neuen Blueprint-Editor-Fenster. 

Sie können das neue Fenster im Hauptfenster des Editors andocken, indem Sie den Tab des Blueprints neben dem Karte-Tab (Lvl_FirstPerson) im Hauptfenster des Editors ziehen. 

Spiel-Modus des Projekts ändern

Neue Unreal-Engine-Projekte verwenden standardmäßig einen Beispiel-Spiel-Modus. Um dies in Ihren benutzerdefinierten Spiel-Modus zu ändern, müssen Sie die Einstellungen Ihres Projekts bearbeiten.

Um den standardmäßigen Spiel-Modus zu ändern, befolgen Sie diese Schritte:

1. Gehen Sie im Mhauptmenü des Editors zu Bearbeiten > Projekt-Einstellungen.

2. Wählen Sie im Abschnitt Projekt im linken Panel Karten und Modi aus. 

3. Ändern Sie oben in der Einstellungen-Tabelle den Standard-Spiel-Modus zu Ihrem Spiel-Modus-Blueprint.

   

4. Schließen Sie die Projekt-Einstellungen.

5. Navigieren Sie im Hauptmenü zu Fenster > Welteinstellungen. Standardmäßig wird das Welteinstellungen-Panel neben dem Details-Panel angedockt angezeigt. Diese Einstellungen steuern, wie sich das aktuelle Level verhält.

6. Setzen Sie im Abschnitt Spiel-Modus GameMode Override auf Ihren neuen Spielmodus-Blueprint.

   

   Sie müssen den GameMode Override nur für mögliche Sample-Level ändern. Wenn Sie ein neues, leeres Level erstellen, ist GameMode Override standardmäßig auf Keiner gesetzt.

Eine Debug-Nachricht auf dem Bildschirm hinzufügen

Ein guter Anfang, um Ihrem Projekt Code hinzuzufügen, ist das Hinzufügen einer „Hallo Welt!“-Nachricht auf dem Bildschirm.

Fügen Sie eine Debug-Nachricht hinzu, um zu bestätigen, dass Sie Ihren neuen Spiel-Modus verwenden und nicht den Standard-Spiel-Modus der Unreal Engine. Log-Nachrichten und Debug-Nachrichten sind nützlich, um Code während der Entwicklung zu überprüfen und zu debuggen.

Standard-StartPlay()-Funktion überschreiben

AGameModeBase enthält eine StartPlay()-Funktion, die die UE aufruft, wenn das Spiel bereit ist, das Gameplay zu beginnen. Sie überschreiben diese Funktion in Ihren benutzerdefinierten GameMode-Klassen, um globale Spielstart-Logik hinzuzufügen. Hier überschreiben Sie den Wert, damit beim Spielstart eine Debug-Nachricht erscheint. 

Befolgen Sie diese Schritte, um StartPlay() in Ihrer benutzerdefinierten GameMode-Klasse zu überschreiben: 

1. Öffnen Sie die .h--Header-Datei Ihrer Spiel-Modus-Klasse in VS. Der Beispiel-Code in diesem Tutorial verwendet eine Klasse namens AdventureGameMode.

   Der Standardcode sollte so aussehen:

   C++

   UCLASS()
   class ADVENTUREGAME_API AAdventureGameMode : public AGameModeBase
   {
   	GENERATED_BODY()
   	
   };

   Copy full snippet(6 lines long)

   GENERATED_BODY() ist ein Makro, das vom Unreal Header Tool verwendet wird, um automatisch den Code zu generieren, der für diese Klasse und andere UObjects erforderlich ist, um mit der Unreal Engine zu funktionieren. Mehr Informationen zum Unreal Header Tool finden Sie in der UHT documentation. 

   Die AAdventureGameMode-Klasse stellt Ihrem Code verschiedene Spiel-Modus-Zustände bereit, darunter Beginn oder Ende eines Spiels, Betreten einer Karte oder ein laufendes Spiel. Wenn der jeweilige Zustand ausgelöst wird, wird eine assoziierte Funktion wie StartPlay() oder ResetLevel() ausgeführt.    

2. Fügen Sie Ihrer AAdventureGameModeBase-Klasse eine Override-Deklaration für die StartPlay()-Funktion hinzu.

   C++

   UCLASS()
   class ADVENTUREGAME_API AAdventureGameMode : public AGameModeBase
   {
   	GENERATED_BODY()
   
   	virtual void StartPlay() override;	
   };

   Copy full snippet(7 lines long)

3. Speichern Sie die .h- Datei.

Debug-Nachricht zu StartPlay() hinzufügen

Implementieren Sie Ihre StartPlay()-Überschreibung mit benutzerdefiniertem Code, der eine Debug-Nachricht ausgibt.

Befolgen Sie diese Schritte, um bei Beginn des Gameplays eine Debug-Nachricht auf dem Bildschirm anzuzeigen:

1. Öffnen Sie die .cpp-Datei Ihres Spiel-Modus, um die soeben deklarierte Funktion zu implementieren.

2. Fügen Sie eine neue Funktionsdefinition für StartPlay() hinzu. Diese Funktion wird in AAdventureGameMode deklariert, also definieren Sie sie mit AAdventureGameMode::StartPlay().  

   C++

   void AAdventureGameMode::StartPlay()
   {
   
   }

   Copy full snippet(4 lines long)

3. Fügen Sie in AMyGameModeBase::StartPlay() Super::StartPlay() hinzu, um die StartPlay()-Funktion aus der Parent-Klasse AAdventureGameMode aufzurufen. Das ist notwendig, um die andere Logik zu verarbeiten, die beim Spielstart ausgeführt werden soll.  

4. Fügen Sie als Nächstes einen check auf GEngine != nullptr hinzu, um sicherzustellen, dass der globale Engine-Zeiger gültig ist.

   C++

   void AAdventureGameMode::StartPlay()
   {
   	Super::StartPlay();
   
   	check(GEngine != nullptr);
   }
   

   Copy full snippet(6 lines long)

   Das ist ein Pointer auf die UEngine-Klasse, die die Unreal Engine selbst verwendet. Die Prüfung, ob dieser gültig ist, sichert, dass Ihr Spiel korrekt ausgeführt wird, bevor der Code fortgesetzt wird. Wenn der globale Engine-Zeiger nicht gültig ist, stürzt Ihr Spiel ab.  

5. Verwenden Sie die GEngine, um auf die AddOnScreenDebugMessage()-Mitgliederfunktion der UEngine Zugang zu erhalten, die eine Nachricht auf dem Bildschirm anzeigt, wenn das Spiel läuft. 

   Diese Funktion nimmt vier Werte entgegen:

   • Einen eindeutigen int-Schlüssel, der die Nachricht identifiziert und verhindert, dass dieselbe Nachricht mehrfach hinzugefügt wird. Verwenden Sie -1, wenn die Einzigartigkeit keine Rolle spielt.

   • Eine Float-Zahl in Sekunden für die Anzeige der Nachricht.

   • Eine FColor, die die Textfarbe festlegt.

   • Eine FString-Nachricht, die ausgegeben werden soll.

   Verwenden Sie folgende Werte, wird fünf Sekunden lang eine „Hallo Welt!“-Nachricht auf dem Bildschirm angezeigt, wenn das Spiel beginnt:

   C++

   GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Yellow, TEXT("Hello World, this is AdventureGameMode!"));

   Copy full snippet(1 line long)

6.   Speichern Sie die .cpp-Datei.   

  Nun sollte AAdventureGameMode::StartPlay() so aussehen:  

#include "AdventureGameMode.h"

void AAdventureGameMode::StartPlay()
{
	Super::StartPlay();

	check(GEngine != nullptr);

	GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Yellow, TEXT("Hello World!"));
}

Ihren Code kompilieren und testen

Sie können im Unreal Editor auf die Schaltfläche Kompilieren klicken, um Ihr Projekt neu zu erstellen; wir empfehlen jedoch die Neuerstellung aus VS heraus. Nach dem Kompilieren sehen Sie, wie sich Ihre Codeänderungen im Editor und im Spiel bemerkbar machen.

Um Ihre Änderungen im Spiel zu sehen, klicken Sie auf Spielen in der Haupt-Symbolleiste, um den Modus Play in Editor (PIE) zu starten. Ihre Debug-Nachricht erscheint oben links.

Um den PIE-Modus zu beenden, drücken Sie Umschalttaste + Escape oder klicken Sie auf Stopp in der Symbolleiste des Level-Editors.

Als Nächstes

Nun haben Sie ein grundlegendes Projekt mit einem neuen Spiel-Modus, und Sie können mit der Erstellung Ihres Spieler-Charakters beginnen! Im nächsten Abschnitt erstellen Sie eine neue Charakterklasse und lernen, wie Sie mit Input-Actions Ihrem Charakter Bewegungssteuerelemente hinzufügen.

Einen Spieler-Charakter mit Input-Actions erstellen

Lernen Sie, wie Sie einen C++-Charakter mit Input-Actions erstellen.

Vollständiger Code

Dies ist der vollständige Code, der in diesem Teil erstellt wurde:

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/GameModeBase.h"
#include "AdventureGameMode.generated.h"

UCLASS()
class ADVENTUREGAME_API AAdventureGameMode : public AGameModeBase
{
	GENERATED_BODY()

#include "AdventureGameMode.h"

void AdventureGameMode::StartPlay()
{
	Super::StartPlay();

	check(GEngine != nullptr);

	GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Yellow, TEXT("Hello World!"));
}