Diese Seite bietet detaillierte Befehle für Abonnenten zum Download des Quellcodes für Unreal Engine (UE) aus dem Unreal Engine GitHub-Repository und zu den ersten Schritten für die Arbeit mit dem Code.
Bevor Sie auf das Repository unter https://github.com/EpicGames/UnrealEngine zugreifen können, benötigen Sie:
ein Epic Games-Konto,
ein GitHub-Konto und
müssen Ihr GitHub-Konto mit Ihrem Epic Games-Konto verbunden haben, wie auf der Seite UE auf GitHub beschrieben.
Sie müssen den Quellcode nicht herunterladen, um mit Unreal Engine zu arbeiten. Wenn Sie lieber die Binärversion von Unreal herunterladen und installieren möchten, lesen Sie unsere Dokumentation Installing Unreal Engine (Installation von Unreal Engine), um zu erfahren, wie Sie Unreal werden. Sie werden jedoch möglicherweise feststellen, dass der Zugriff auf den Quellcode für Sie und Ihr Projekt äußerst nützlich sein kann. Zum Beispiel:
Sie erhalten Zugang zu allen neuen Funktionen und Bug-Fixes, die Epic-Techniker jeden Tag vornehmen, praktisch unmittelbar.
Wenn Sie einen Bug finden, den wir noch nicht behoben haben, der aber für Ihr Projekt entscheidend sein kann, können Sie die Blockierung Ihres Projekts aufheben, indem Sie den Fix in Ihrer eigenen Version des Quellcodes vornehmen und Ihre eigenen Binärdateien neu erstellen.
Sie können die Engine verbessern und der gesamten Unreal-Community helfen, indem Sie Ihre Korrekturen und Funktionen an Epic senden.
Wenn Sie ein Unreal Engine-Lizenznehmer sind, können Sie über unseren Perforce-Server statt über das öffentliche GitHub-Repository auf den Quellcode zugreifen.
Zugriff auf Unreal Engine-Quellcode über GitHub
Unreal Engine beinhaltet vollen Zugriff auf den kompletten C++-Quellcode, sodass Sie Unreal Engine komplett studieren, anpassen, erweitern und debuggen und Ihr Projekt ohne Einschränkungen abschließen können.
Unser Quellcode-Repository auf GitHub wird laufend aktualisiert, während wir auf unserer eigenen Hauptlinie ständig neue Funktionen entwickeln. Daher müssen Sie nicht auf die nächste Veröffentlichung des Produkts warten, um Zugriff auf den aktuellsten Code zu erhalten.
Gehen Sie wie folgt vor, um auf den Unreal Engine-Quellcode zuzugreifen:
Navigieren Sie zu GitHub und registrieren Sie ein Konto.
Melden Sie sich mit Ihrem verifizierten Epic Games-Konto bei UnrealEngine.com an. Um Ihr Konto-Dashboard zu öffnen, zeigen Sie mit dem Mauszeiger auf Ihren Benutzernamen und wählen im Dropdown-Menü Persönlich aus.
Wenn das Konto-Dashboard geöffnet ist, wählen Sie in der Seitenleiste den Tab Verbindungen aus. Wählen Sie den Tab Konten aus und wählen Sie dann die Verbinden-Schaltfläche unter dem GitHub-Symbol aus.
Falls Sie dem Unreal Engine-Endverbraucher-Lizenzvertrag noch nicht zugestimmt haben, müssen Sie sich die Bedingungen durchlesen und das Kontrollkästchen aktivieren. Wählen Sie dann Konto verknüpfen aus. Wenn Sie sich bei Ihrem GitHub-Konto abgemeldet haben, werden Sie nach dem Klicken auf die Schaltfläche „Konto verknüpfen“ zu GitHub weitergeleitet, um sich anzumelden.
Klicken zum Abschluss des OAuth-App-Autorisierungsprozesses auf die Schaltfläche EpicGames autorisieren. Weitere Informationen zu diesem Thema finden Sie unter dem GitHub-Überblick Authorizing OAuth Apps.
GitHub sendet eine E-Mail und lädt Sie ein, der Organisation @EpicGames auf GitHub beizutreten. Sie müssen innerhalb von sieben Tagen auf die Schaltfläche @EpicGames beitreten dieser E-Mail klicken, um die Verknüpfung des GitHub- und Epic Games-Kontos abzuschließen.
Nach Abschluss erhalten Sie eine E-Mail von Epic Games, in der Ihnen bestätigt wird, dass Ihr GitHub- und Epic Games-Konto erfolgreich verknüpft wurden. Falls Sie keine Bestätigungs-E-Mail erhalten, oder bei Problemen mit Ihrem Konto suchen Sie Hilfe beim Kundendienst. Sie können nun loslegen, indem Sie zu unserer GitHub-Seite navigieren (Anmeldung erforderlich), um den vollständigen Quellcode herunterzuladen.
Quellcode-Branches
Sie werden feststellen, dass wir den Quellcode von UE in verschiedenen Branches veröffentlicht haben.
Branches, deren Name dev, staging oder test enthält, sind üblicherweise für interne Epic Games-Prozesse gedacht und sind selten nützlich für Endverbraucher. Andere kurzlebige Branches können von Zeit zu Zeit auftauchen, wenn wir neue Versionen oder Hotfixes stabilisieren.
Release-Branch
Der Release-Branch spiegelt immer die aktuelle offizielle Version wider. Diese wurden von unserem QA-Team ausgiebig getestet und sind ein großartiger Ausgangspunkt zum Erlernen von Unreal Engine und Erstellen Ihrer eigenen Projekte. Wir arbeiten hart daran, diese Versionen stabil und zuverlässig zu machen, und haben das Ziel, alle paar Monate eine neue Version zu veröffentlichen.
Main-Branch
Die aktivste Entwicklung von UE findet im Branch ue5-main statt. Dieser Branch spiegelt die aktuelle Version der Engine wider und kann fehlerhaft sein oder sich nicht kompilieren lassen. Wir stellen sie Entwicklern zur Verfügung, die gern neue Funktionen testen oder gleichzeitig mit uns an der Entwicklung arbeiten möchten.
Wenn Sie sich für die Arbeit in diesem Branch entscheiden, beachten Sie, dass er wahrscheinlich den Branches für die aktuelle offizielle Version und die nächste anstehende Version voraus ist. Daher sind Inhalte und Code, die Sie für die Arbeit mit dem Branch ue5-main erstellen, möglicherweise nicht mit öffentlichen Versionen kompatibel, bis wir für eine zukünftige offizielle Version einen neuen Branch direkt aus ue5-main erstellen.
Lesen Sie sich den Artikel Setting Up Visual Studio (Einrichten von Visual Studio) durch, um sicherzustellen, dass Sie eine Version von Visual Studio verwenden, die mit Ihrer gewünschten Version von Unreal Engine kompatibel ist.
Installieren Sie GitHub für Windows und forken und klonen Sie unser Repository.
Weitere Informationen zur Nutzung von Git über die Befehlszeile finden Sie in den Artikeln Einrichten von Git und Ein Repository forken.
Wenn Sie Git nicht verwenden möchten, können Sie den Quellcode über die Schaltfläche „ZIP herunterladen“ auf der rechten Seite herunterladen. Das integrierte Windows-Zip-Dienstprogramm markiert den Inhalt der Zip-Dateien, die aus dem Internet heruntergeladen wurden, als nicht sicher zur Ausführung. Klicken Sie daher mit der rechten Maustaste auf die Zip-Datei und wählen Sie „Eigenschaft...“ und „Nicht blockieren“ aus, bevor Sie sie entpacken. Zip-Dienstprogramme von Drittanbietern tun dies normalerweise nicht.
Installieren Sie Visual Studio.
Alle Desktop-Versionen von Visual Studio können UE erstellen, einschließlich Visual Studio Community, das kostenlos für kleine Teams und Einzelentwickler ist. Beachten Sie die Seite Setting Up Visual Studio (Einrichten von Visual Studio), um sicherzustellen, dass Sie alle erforderlichen VS-Komponenten für die Arbeit mit UE heruntergeladen haben.
Öffnen Sie Ihren Quellordner im Explorer und führen Sie
Setup.bataus.Damit werden binäre Inhalte für die Engine heruntergeladen, Voraussetzungen installiert und die Unreal-Dateiverknüpfungen eingerichtet. Unter Windows kann eine Warnung von SmartScreen erscheinen. Klicken Sie auf Mehr Informationen und dann auf Trotzdem ausführen, um fortzufahren.
Der Abschluss eines sauberen Downloads der Engine-Binärdateien kann einige Zeit dauern. Bei nachfolgenden Vorgängen ist nur ein inkrementeller Download erforderlich, der viel schneller ist.
Führen Sie
GenerateProjectFiles.bataus, um Projektdateien für die Engine zu erstellen. Dies sollte weniger als eine Minute dauern.Laden Sie das Projekt in Visual Studio, indem Sie auf die Datei
UE5.slndoppelklicken. Setzen Sie Ihre Lösungskonfiguration auf Development Editor und Ihre Lösungsplattform auf Win64. Klicken Sie dann mit der rechten Maustaste auf das UE-Ziel und wählen Sie Build aus. Das Kompilieren kann je nach Systemspezifikationen zwischen 10 und 40 Minuten dauern.Nachdem die Kompilierung abgeschlossen ist, können Sie den Editor aus Visual Studio laden, indem Sie Ihr Startprojekt auf UE5 setzen und F5 zum Debuggen drücken.
Diese Seite zeigt den Lizenznehmern, wie sie Unreal Engine von unserem Quellcode-Repository auf GitHub herunterladen und erstellen können. Falls Sie die Binär- Version von Unreal Engine herunterladen möchten, informieren Sie sich in unserer Dokumentation Installing Unreal Engine (Installation von Unreal Engine), um zu erfahren, wie Sie sich Unreal holen.
Zusätzliche Zielplattformen
Android-Support wird über das Einrichtungsskript heruntergeladen, wenn Sie den Android NDK installiert haben. Weitere Informationen dazu finden Sie in der Anleitung Android Quick Start (Android Schnellstart).
Für die iOS-Entwicklung ist ein Mac erforderlich. Anweisungen finden Sie in der Anleitung iOS Quick Start (iOS Schnellstart).
Die Entwicklung für Konsolen und andere Plattformen mit eingeschränktem Zugang, etwa Sony PlayStation, Microsoft Xbox und Nintendo Switch, ist nur möglich, wenn Sie ein registriertes Entwickler-Konto bei diesen Drittanbietern haben.
Abhängig von der Plattform sind möglicherweise zusätzliche Dokumentation oder Anleitungen auf der Epic Pro Support-Seite oder als herunterladbares Archiv im Bereich der Unreal Engine-Foren verfügbar, der sich auf Ihre Plattform bezieht.
Wenn Sie keinen Zugriff auf diese Ressourcen haben, registrieren zuerst ein Entwickler-Konto bei dem Drittanbieter. Wenden Sie sich dann an Ihren Epic Games- Kontomanager, wenn Sie einen haben, oder füllen Sie das Formular Console Development Request (Konsolenentwicklungsanforderung) für Unreal Engine aus und schicken Sie es ab, wenn das nicht der Fall ist. Epic wird Sie mit einer formellen Vereinbarung kontaktieren, die Sie digital unterzeichnen können. Nach der Genehmigung erhalten Sie Anweisungen, wie Sie auf den Quellcode, Binärdateien und weitere Anweisungen für Ihre Plattform zugreifen können.
Lizenzierung und Mitwirkung
Ihr Zugang zur Unreal Engine und Ihre Nutzung auf GitHub unterliegen der Unreal Engine-Endverbraucher-Lizenzvereinbarung. Wenn Sie diesen Bedingungen nicht zustimmen, die von Zeit zu Zeit geändert werden können, sind Ihnen der Zugang zu bzw. die Verwendung von Unreal Engine nicht gestattet.
Wir freuen uns über jeden Beitrag zur Entwicklung von Unreal Engine, der über Pull-Anfragen auf GitHub getätigt wird. Der Großteil unserer aktiven Entwicklung findet im master-
Branch statt. Daher nehmen wir lieber dort Pull-Anfragen entgegen (besonders für neue
Funktionen). Wir achten darauf, dass neuer Code immer den
Nächste Schritte
Nachdem Sie Unreal Engine nun heruntergeladen und eingerichtet haben, sind Sie bereit, die Engine über den Quellcode zu erstellen.
Fußnoten
Wenn Sie den Editor zum ersten Zeit aus einem neuen Quell-Build starten, kann es zu langen Ladezeiten kommen. Die Engine optimiert den Inhalt für Ihre Plattform im abgeleiteten Daten-Cache. Dies sollte nur einmal passieren.
Ihre privaten Forks des Unreal Engine-Codes sind mit den Berechtigungen Ihres GitHub-Kontos verknüpft. Wenn Sie das Abonnement stornieren oder Ihren GitHub-Benutzernamen ändern, müssen Sie die Inhalte erneut forken und Ihre Änderungen von einer lokalen Kopie hochladen.