Um Assets organisiert und wiederverwendbar für Ihr Team oder über mehrere Projekte hinweg zu halten, können Sie Ihre Instanzen gruppieren und in wiederverwendbare Pakete umwandeln. Pakete machen den gesamten Prozess des Weltenbaus schneller und ergonomischer, helfen aber auch bei Konsistenz, Duplikation, Zusammenarbeit und Versionierung:
- Aktualisieren Sie ganz einfach alle Kopien eines Pakets auf die neueste Version oder aktualisieren Sie nur bestimmte Kopien.
- Stellen Sie Pakete so ein, dass sie sich automatisch aktualisieren, wann immer eine neue Version verfügbar ist.
- Geben Sie Mitwirkenden Bearbeitungs- oder Nutzungsberechtigungen für die Inhalte eines Pakets.
- Sehen Sie sich die vollständige Versionshistorie eines Pakets an, vergleichen Sie Versionen und stellen Sie alte Versionen wieder her.
Der effizienteste Workflow besteht darin, ein Paket zu erstellen, es mit allen Mitwirkenden zu teilen und es auf automatische Updates einzustellen. Und Sie müssen nicht warten, bis ein Modell "fertig" ist, bevor Sie es in einem Paket verwenden. Selbst wenn das Paket ein Platzhalter über einer einfachen Form ist, können Sie es verwenden, um Ihre Umgebung zu greyboxen und dann die Platzhalterkopien automatisch zu aktualisieren, während Sie detailliertere Versionen veröffentlichen.
Pakete erstellen
Wenn Sie ein Paket mit eingeschränkten Assets erstellen möchten, für die Sie keine explizite Erlaubnis haben, können Sie das Paket trotzdem erstellen, aber diese spezifischen eingeschränkten Assets werden zur Laufzeit nicht sichtbar oder hörbar sein, es sei denn, das Spiel selbst hat die Erlaubnis, diese Assets zu verwenden.
Sie können ein Paket aus jedem einzelnen Objekt oder jedem einzelnen Eltern- und Kinderzweig von Objekten erstellen. Wenn Sie ein Paket für ein einzelnes Objekt erstellen möchten, fügen Sie es zuerst einer Model-Gruppe hinzu, damit Sie später Kindobjekte innerhalb des Pakets hinzufügen, entfernen oder skalieren können, ohne das Paket zu brechen.
Um ein Paket zu erstellen:
Klicken Sie im Explorer-Fenster oder im 3D-Viewport mit der rechten Maustaste auf das Objekt oder die Objekte, die Sie in ein Paket umwandeln möchten, und wählen Sie im Kontextmenü In Paket umwandeln.
Füllen Sie im neuen Fenster die Paketdetails aus. Insbesondere, wenn Sie in einer Gruppe arbeiten, setzen Sie Eigentum auf die entsprechende Gruppe, in der Sie die Erlaubnis haben, Gruppen-Spiele zu erstellen/bearbeiten.
Eigentumsübertragungen werden vom Assetsystem nicht unterstützt, daher sollten Sie den Eigentümer beim Erstellen eines Pakets sorgfältig berücksichtigen.
Klicken Sie auf Einreichen.
Nach Abschluss der Umwandlung erhält das Objekt ein "Kettenlink"-Symbol im Explorer-Fenster, um es als Paket zu identifizieren. Darüber hinaus sehen Sie ein neues PackageLink-Objekt, das dem Objekt zugeordnet ist.
- OPTIONALWählen Sie das PackageLink-Objekt aus und aktivieren Sie AutoUpdate im Eigenschaften-Fenster. Beachten Sie, wie sich das Symbol ändert, um anzuzeigen, dass das Paket auf automatische Updates eingestellt ist.
Löschen oder verschieben Sie das PackageLink-Objekt nicht! Wenn Sie dies für eine Paketkopie tun, wird die Kopie wieder in ein normales Objekt umgewandelt und verliert die Paketfähigkeiten, wie die Fähigkeit, sich selbst zu aktualisieren, wenn eine neue Version verfügbar ist.
Pakete einfügen
Um ein Paket einzufügen, das im aktuellen Ort noch nicht existiert, müssen Sie es zunächst aus dem Toolbox einfügen:
- Aus Inventar ⟩ Meine Pakete für Pakete, die Sie veröffentlicht oder aus dem Creator Store erhalten haben, sowie für Pakete, die ein Freund besitzt und Ihnen Berechtigungen zur Nutzung gegeben hat.
- Aus Kreationen ⟩ Gruppenpakete für Pakete, die von Mitgliedern Ihrer Gruppe veröffentlicht wurden (einschließlich Ihnen selbst).
Sobald Sie ein Paket in das Datenmodell eines veröffentlichten Ortes eingefügt haben, erscheint es im Asset-Manager und bleibt dort, selbst wenn Sie später alle Kopien davon löschen.
Seien Sie vorsichtig, wenn Sie Assets einfügen, die Sie nicht erstellt haben, da sie bösartige Skripte enthalten können. Speichern Sie Ihr Spiel zuerst und untersuchen Sie alle Skripte innerhalb unbekannter Assets, damit Sie leicht zur Version des Ortes zurückkehren können.
Pakete ändern
Sie können Pakete und deren Kinder wie andere Objekte bearbeiten. Das Ändern von Paketen deaktiviert Auto-Update, bis Sie die Änderungen veröffentlichen oder rückgängig machen.
Die meisten Änderungen kennzeichnen das Paket als geändert, obwohl die folgenden Änderungen nicht als Paketänderungen betrachtet werden:
- Ändern des Namens des Wurzelknotens.
- Ändern der Enabled-Eigenschaft eines Wurzelknotens GuiObject, wie z.B. ScreenGui, SurfaceGui oder BillboardGui.
- Ändern eines Teileverweises eines Weld innerhalb des Pakets, der auf eine Instanz außerhalb des Pakets verweist.
Sobald geändert, erhalten Pakete mit unveröffentlichten Änderungen ein geändertes Symbol im Explorer-Fenster:
Konfigurationen hinzufügen oder aktualisieren
Sie können Instanzattribute an der Wurzel eines Pakets hinzufügen, um dessen Verhalten anzupassen. Wenn Sie ein Paket veröffentlichen, wird die aktuelle Menge an Attributen/Werten zu den Standardkonfigurationen des Pakets. Bei jeder Kopie eines Pakets können diese Attributwerte auf Instanzbasis geändert werden, und diese Änderungen werden durch fett kursiv angezeigt. Wenn Paketkopien aktualisiert werden, bleiben die geänderten Konfigurationswerte erhalten, während andere Attribute auf den neuesten Standardwert aktualisiert werden.
Derzeit ist die einzige Möglichkeit, Konfigurationswerte zu verwalten, Skripte im Paket hinzuzufügen, die zur Laufzeit Verhalten basierend auf der Konfiguration lesen und anwenden.
Wenn Sie einfach die Standard-Werte für Konfigurationen aktualisieren möchten, können Sie diese Attributwerte ändern und das Paket erneut veröffentlichen (das Paket wird in diesem Fall nicht als geändert gekennzeichnet). Wenn Sie andere Änderungen veröffentlichen möchten, aber die Standardkonfigurationswerte nicht ändern möchten, sollten Sie auf einem Paket ohne Wertänderungen veröffentlichen oder die Konfigurationen auf ihre Standardwerte zurücksetzen, bevor Sie veröffentlichen.
Verschachtelte Pakete
Sie können Pakete in andere Pakete einfügen, um komplexe Hierarchien zu pflegen und daran zusammenzuarbeiten, wie z.B. eine Reihe von Fahrzeugmechaniken, die unabhängig vom übergeordneten Paket des Fahrzeugs geändert werden können.
Wenn Sie ein verschachteltes Paket ändern, werden sowohl das verschachtelte Paket als auch das übergeordnete Paket als geändert betrachtet. Sie müssen Änderungen veröffentlichen für jedes verschachtelte Paket, bevor Sie Änderungen an seinem übergeordneten Paket veröffentlichen dürfen, da das Veröffentlichen des übergeordneten Pakets es als aktuell/ungeändert kennzeichnen würde und mit den Änderungen des verschachtelten Pakets in Konflikt stehen würde.
Paket-Skripte
Jedes Skript innerhalb eines ungeänderten Pakets ist schreibgeschützt und zeigt eine Benachrichtigung oben mit einem Hyperlink an, um das Skript zu entsperren.
Durch Klicken auf den Hyperlink:
- Wird das Paket unabhängig davon, ob Sie das Skript bearbeiten, als geändert gekennzeichnet.
- Entfernt die Benachrichtigung/den Hyperlink von anderen Skripten innerhalb des Pakets.
Sobald das Paket veröffentlicht und in einen ungeänderten Zustand versetzt wird, werden die Skripte darunter schreibgeschützt mit einem Hyperlink zum Ändern.
Paketänderungen veröffentlichen
Sie können jede Änderung an einem Paket als neue Version veröffentlichen, wodurch Ihre Updates anderen Paketkopien im gesamten Ort und in allen Spielen zur Verfügung stehen. Es ist nicht erforderlich, ein geändertes Paket zu veröffentlichen, bevor Sie einen Ort veröffentlichen, da die geänderte Version zusammen mit dem Ort für zukünftige Iterationen gespeichert wird.
Um Änderungen an einem Paket zu veröffentlichen:
Klicken Sie im Explorer-Fenster oder im 3D-Viewport mit der rechten Maustaste auf die geänderte Kopie und wählen Sie Veröffentlichen in Paket.
Wenn eine Paketkopie Auto-Update aktiviert hat, wird sie sofort aktualisiert, wenn Sie den Ort öffnen, der sie enthält. Andere Kopien erhalten ein "Download"-Symbol, das anzeigt, dass ein Update verfügbar ist. Sie können einzeln aktualisieren oder alle Kopien massenhaft aktualisieren.
- OPTIONALFügen Sie eine Beschreibung Ihrer Änderungen hinzu:
- Klicken Sie mit der rechten Maustaste auf das Paket und wählen Sie Paketdetails.
- Wählen Sie im Fenster Asset-Konfiguration die Registerkarte Versionen.
- Wählen Sie unter Ihrer letzten Änderung Hinzufügen.
- Beschreiben Sie Ihre Änderungen und klicken Sie auf die Schaltfläche Einreichen.
Veraltete Kopien aktualisieren
Sie können veraltete Paketkopien auf die neueste Version aktualisieren oder die ältere Version weiterhin verwenden.
Suchen Sie im Explorer-Fenster veraltete Kopien anhand des "Download"-Symbols. Sie können auch die veraltete Kopie im 3D-Viewport auswählen.
Klicken Sie mit der rechten Maustaste auf eine veraltete Kopie und wählen Sie Neueste Paket abrufen. Sie können auch mehrere Pakete auswählen, mit der rechten Maustaste klicken und Neueste für ausgewählte Pakete abrufen.
Massenupdates
Umfangreiche Verwendung von Paketen kann zu vielen Paketkopien über mehrere Orte in einem Spiel führen. Neben einzelner Synchronisierung und automatischen Updates können Sie alle Kopien eines Pakets durch Massenupdates aktualisieren.
- EMPFOHLENSchließen Sie andere Studio-Instanzen mit geöffneten Orten des Spiels; dies verhindert, dass eine andere nicht gespeicherte Instanz eines Ortes möglicherweise Ihre Updates überschreibt.
- Klicken Sie im Explorer-Fenster oder im 3D-Viewport mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Alle aktualisieren.
- Wählen Sie alle Orte im Spiel oder eine Teilmenge von Orten aus und klicken Sie auf Aktualisieren.
Massenupdates von Paketen speichern automatisch die ausgewählten Orte, veröffentlichen sie jedoch nicht. Darüber hinaus betrifft das Massenupdate keine geänderten Versionen eines Pakets; nach Abschluss des Massenupdates zeigt Studio eine Warnung mit der Anzahl der Pakete an, die es nicht aktualisiert hat, falls vorhanden.
Automatische Updates
Um das Synchronisieren zu erleichtern, können Sie eine Paketkopie so einstellen, dass sie sich automatisch aktualisiert, wann immer eine neuere Version veröffentlicht wird. Das Auto-Update der Paketkopien erfolgt, wenn ein Ort in Studio geöffnet wird.
Erweitern Sie im Explorer-Fenster den Hierarchiebaum des Pakets und wählen Sie das PackageLink-Objekt aus.
Aktivieren Sie im Eigenschaften-Fenster die AutoUpdate-Eigenschaft. Wenn Sie verschachtelte Pakete haben, gilt diese Eigenschaft nur für das übergeordnete Paket der höchsten Ebene, was bedeutet, dass automatische Updates nur erfolgen, wenn das übergeordnete Paket aktualisiert wird.
Automatische Updates gelten nicht für geänderte Paketkopien. Sobald Sie eine Paketinstanz ändern, wird ihre AutoUpdate-Eigenschaft deaktiviert und ignoriert.
Freigabe- und Zugriffslevels
Sie können Freunden, Spielen, Gruppen oder bestimmten Benutzerrollen in Gruppen die Erlaubnis erteilen, Ihre Pakete in ihren Kreationen frei zu verwenden. Weitere Informationen zum Asset-Zugriff finden Sie unter Asset-Datenschutz.
Wenn Sie ein Paket mit eingeschränkten Assets teilen, für die Sie keine explizite Erlaubnis haben, können Sie das Paket trotzdem teilen, aber diese spezifischen eingeschränkten Assets werden zur Laufzeit nicht sichtbar oder hörbar sein, es sei denn, der Freund, das Spiel oder die Gruppe hat die Erlaubnis, diese Assets zu verwenden.
Um die Paketberechtigungen für einen Mitwirkenden, wie einen Freund oder eine Gruppe, zu ändern:
Klicken Sie im Explorer-Fenster, in der Toolbox oder im Asset-Manager mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Paketoptionen ⟩ Paketdetails.
Wählen Sie im Fenster Asset-Konfiguration die Registerkarte Berechtigungen.
Verwenden Sie die Suchleiste, um einen Mitwirkenden einzugeben und auszuwählen, dem Sie die Erlaubnis zur Nutzung Ihres Pakets erteilen möchten, und wählen Sie dann ein Berechtigungslevel aus.
Berechtigung Beschreibung Verwenden & Anzeigen Der Mitwirkende kann die aktuellen und vorherigen Paketversionen verwenden und anzeigen (aber nicht bearbeiten). Sobald Sie einem Mitwirkenden diese Fähigkeit geben, können Sie den Zugriff auf eine Kopie, die er bereits in sein Spiel eingefügt hat, nicht mehr widerrufen; der Widerruf des Zugriffs verhindert die erneute Einfügung oder Paketaktualisierungen, aber die Paketkopien in seinem Datenmodell bleiben intakt. Bearbeiten Der Mitwirkende kann die aktuellen und vorherigen Paketversionen verwenden, anzeigen und bearbeiten, einschließlich der Veröffentlichung von Änderungen daran.
Paketänderungen zurücksetzen
Anstatt eine gesamte Reihe von Paketänderungen einzeln rückgängig zu machen, können Sie unveröffentlichte Änderungen in einer Aktion zurücksetzen, ein Paket auf eine vorherige Version wiederherstellen oder Änderungen an bestimmten Konfigurationen zurücksetzen.
Unveröffentlichte Änderungen zurücksetzen
Um eine gesamte Reihe von unveröffentlichten Änderungen rückgängig zu machen:
Suchen Sie im Explorer-Fenster geänderte Kopien anhand des Punktes auf ihren Paket-Symbolen. Sie können auch geänderte Kopien im 3D-Viewport auswählen.
Klicken Sie mit der rechten Maustaste auf eine einzelne geänderte Kopie und wählen Sie Änderungen am Paket rückgängig machen, oder wählen Sie mehrere Kopien (mindestens eine davon geändert), klicken Sie mit der rechten Maustaste und wählen Sie Änderungen an ausgewählten Paketen rückgängig machen.
Auf veröffentlichte Version zurücksetzen
Um ein Paket auf eine früher veröffentlichte Version zurückzusetzen:
- Klicken Sie im Explorer-Fenster, in der Toolbox oder im Asset-Manager mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Paketoptionen ⟩ Paketdetails.
- Wählen Sie im Fenster Asset-Konfiguration die Registerkarte Versionen. Das Fenster zeigt Details zu jeder veröffentlichten Version an, einschließlich des Datums und der Uhrzeit der Veröffentlichung sowie etwaiger Beschreibungen der Änderungen.
- Klicken Sie auf das Häkchen neben der Version, die Sie wiederherstellen möchten, und klicken Sie auf Einreichen.
Das Zurücksetzen von Änderungen an einem Paket setzt die Konfiguration nicht auf die Standardwerte zurück. Siehe Konfigurationen zurücksetzen.
Konfigurationen zurücksetzen
Um ein beliebiges Konfigurations-Attribut auf seinen Standardwert zurückzusetzen, wählen Sie Zurücksetzen aus dem Optionsmenü im Abschnitt Attribute des Eigenschaften-Fensters.
Paketversionen vergleichen
Wenn ein Paket mehrere Versionen hat, können Sie Änderungen zwischen den Versionen mit dem Diff-Viewer vergleichen. Das Tool hat ein Menü für die Paket-Hierarchie, das alle hinzugefügten, entfernten oder geänderten Instanzen zwischen den Versionen mit entsprechenden Symbolen anzeigt, einschließlich der folgenden Funktionen:
Visuelle Übersicht zeigt die visuellen Unterschiede der 3D-Darstellung unter verschiedenen Kamerapositionen. Es ist die Standardansicht für Pakete mit einem 3D-Objekt (Modelle, Teile) als Wurzelobjekt und derzeit nur für das Wurzelobjekt verfügbar.
Eigenschaften zeigt Änderungen von Eigenschaften und Attributen. Es ist die Standardansicht für Pakete mit einem Nicht-3D-Objekt (Skripte, Lichter, 2D-Objekte) als Wurzelobjekt und ist für alle Instanzen in einem Paket verfügbar.
Skript zeigt zeilenweise Skriptunterschiede. Es ist verfügbar für Pakete, die Skripte enthalten, unabhängig davon, ob das Skript das Wurzelobjekt ist oder nicht.
Um Paketversionen zu vergleichen:
Klicken Sie im Explorer oder im 3D-Viewport mit der rechten Maustaste auf das Zielpaket und wählen Sie Paketoptionen ⟩ Paketversionen vergleichen.
Standardmäßig vergleicht das Fenster Änderungen zwischen Ihrer lokalen Kopie und der neuesten Version. Verwenden Sie die beiden Dropdown-Menüs, um verschiedene Versionen zu vergleichen.
Einige ältere Versionen könnten mit dem Paket-Diff-Tool inkompatibel sein.
Nachdem Sie Versionen ausgewählt haben:
Um die visuellen Darstellungen des Wurzelmodells zu vergleichen, falls zutreffend, wählen Sie die Registerkarte Visuelle Übersicht und passen Sie die Kamerasteuerung für Ihren gewünschten Winkel an. Die Steuerungen sind über die Ansichten synchronisiert:
- Schwenken Sie die Kamera mit linken Mausklicks.
- Drehen Sie die Kamera mit rechten Mausklicks.
- Zoomen Sie mit dem Mausrad hinein und heraus.
- Zentrieren Sie mit der Tastenkombination F.
Um Eigenschaften und Attribute einer Instanz zu vergleichen, wählen Sie die Instanz und die Registerkarte Eigenschaften.
Um Skriptunterschiede für ein Paket zu vergleichen, das ein Skript ist oder Skripte enthält, verwenden Sie die Registerkarte Skript.
Dieses Tool ermöglicht es Ihnen nur, Skriptänderungen zwischen der aktuellen Version und der neuesten veröffentlichten oder lokalen Version zu vergleichen, ohne die Mitwirkenden anzuzeigen, die die Änderung vorgenommen haben.
Alternativ können Sie das Skript-Diff-Tool direkt öffnen, indem Sie mit der rechten Maustaste auf das Zielpaket im Explorer-Fenster oder 3D-Viewport klicken und Skriptänderungen anzeigen auswählen.
