Unreal-Engine-Plugin

Installation

Das uVersion-Plugin wird als vorkompilierte Binärdatei ausgeliefert und vom Desktop-Client verwaltet. Kein Kompilieren Ihrerseits, keine Quelldateien, mit denen Sie hantieren müssen.

Unterstützte Unreal-Versionen: 5.6 und höher.

Vorgehen

1. Installieren Sie den uVersion-Desktop-Client
2. Fügen Sie den Workspace mit Ihrem Unreal-Projekt zum Client hinzu
3. Das Unreal-Panel erkennt Ihre .uproject automatisch
4. Der Client installiert das Plugin passend zu Ihrer Unreal-Version und Plattform
5. Öffnen Sie das Projekt in Unreal, das Plugin ist sofort aktiv

Updates

Der Desktop-Client prüft beim Öffnen des Projekts und alle 6 Stunden auf neue Versionen. Sobald eine neuere Version für Ihr Unreal verfügbar ist, erscheint im Unreal-Panel des Clients ein « Update ready »-Badge. Schließen Sie den Unreal-Editor und klicken Sie dann darauf, um das Update anzuwenden (das Plugin kann nicht ersetzt werden, solange es geladen ist).

Erste Verbindung

Im Unreal-Editor: Tools → Source Control → Connect to Source Control, wählen Sie uVersion im Dropdown Provider.

Ihre Zugangsdaten werden automatisch aus dem Desktop-Client übernommen. Sie müssen nichts erneut eingeben. Sollte der Desktop-Client aus irgendeinem Grund nicht installiert sein, zeigt der Editor ein Formular an, um die Serveradresse und Ihre Zugangsdaten einzugeben.

Was das Plugin in Unreal leistet

Natives Source Control

Checkout, checkin, revert, history: alles ist über das Rechtsklick-Menü im Content Browser erreichbar, genau wie bei jedem anderen Unreal-Source-Control-Provider. Artists müssen nichts Neues lernen.

Automatisches Sperren beim Bearbeiten

Wenn Sie einen Asset bearbeiten, setzt das Plugin automatisch eine serverseitige Sperre, ohne dass Sie einen manuellen Checkout durchführen müssen. Sie arbeiten, das Plugin kümmert sich im Hintergrund um die Sperre.

Visueller Blueprint-Diff

Vergleichen Sie zwei Revisionen eines Blueprints direkt in Unreal mit dem standardmäßigen visuellen Diff-Werkzeug des Editors. Funktioniert bei jedem Commit im Verlauf.

Validierung vor dem Checkin

Vor jeder Übermittlung führt das Plugin eine Reihe von Prüfungen an den geänderten Dateien durch: Blueprint-Kompilierung, Namenskonvention, Texturgröße, fehlende Abhängigkeiten, zirkuläre Abhängigkeiten und mehr. Fehler blockieren den Checkin, Warnungen werden als Hinweise angezeigt. Regeln lassen sich pro Projekt aktivieren und konfigurieren, über das Admin-Panel des Desktop-Clients.

Redirector-Bereinigung

Wenn Sie einen Asset umbenennen oder verschieben, erzeugt Unreal Redirectors, die sich ansammeln können. Das Plugin erkennt und bereinigt sie automatisch beim Checkin und aktualisiert die Referenzen in allen betroffenen Assets.

Abgleich beim Start

Beim Öffnen des Projekts prüft das Plugin den Zustand Ihrer Assets und gleicht den Status mit dem Server ab. Dateien, die Sie gerade bearbeitet haben, werden automatisch erneut gesperrt, damit ein Teammitglied sich nicht versehentlich etwas aneignet, das Sie begonnen hatten.

Anfrage zur Sperrfreigabe

Wenn Sie einen Asset bearbeiten möchten, den ein Teammitglied gesperrt hat, können Sie mit dem Plugin eine Freigabeanfrage senden. Eine Benachrichtigung erreicht das Teammitglied in seinem Desktop-Client.

Häufige Probleme

« Failed to connect to source control »

Prüfen Sie, ob Sie im Desktop-Client ordnungsgemäß angemeldet sind. Er hält Ihre Zugangsdaten.

Das Plugin aktualisiert sich nicht

Schließen Sie zuerst den Unreal-Editor: Das Plugin kann nicht ersetzt werden, solange es geladen ist. Klicken Sie dann auf das Status-Badge des Plugins im Unreal-Panel des Desktop-Clients, um die Prüfung erneut auszuführen und das Update anzuwenden.