Um Assets in deinem Team oder über mehrere Projekte hinweg organisiert und wiederverwertbar zu halten, gruppiere deine Instanzen und konvertiere sie in wiederverwertbare Pakete . Pakete machen den gesamten Prozess des Aufbaus von Welten schneller und effizienter, aber sie helfen auch mit Konsistenz, Duplikation, Zusammenarbeit und Versionierung:
- Einfach aktualisieren Sie alle Kopien eines Pakets auf die neueste Version (oder nur aktualisieren Sie spezifische Kopien ).
- Setzen Sie Pakete auf automatisches Updates wenn immer eine neue Version verfügbar ist.
- Geben Sie Mitwirkenden Bearbeiten oder Verwenden Berechtigungen für den Inhalt eines Pakets.
- Zeigen Sie die vollständige Versionsgeschichte für ein Paket, vergleichen Sie Versionen und restaurieren Sie alte Versionen.
Der effizienteste Workflow ist es, ein Paket zu erstellen, es mit irgendwelchen Mitwirkenden zu teilen und es dann auf automatische Weise zu aktualisieren. Und Sie müssen nicht warten, bis ein Modell "beendet" ist, bevor Sie es in einem Paket verwenden. Selbst wenn das Paket ein Platzhalter auf dem Simple-Form-Oberkopf ist, können Sie es verwenden, um Ihre Umgebung zu
Pakete erstellen
Du kannst ein Paket von einem einzelnen Objekt oder einer einzelnen Eltern- und Kinderniederlassung von Objekten erstellen. Wenn du ein Paket für ein einzelnes Objekt erstellen möchtest, empfehlen wir, zuerst zu einer Model Gruppe hinzuzufügen, damit du das Paket später ohne das Zerbrechen des Pakets hinzufügen, entfernen oder skalieren kannst.
In dem Explorer-Fenster oder Ansichtsfensterklicken Sie mit der rechten Maustaste auf das gewünschte Objekt und wählen Sie In Package konvertieren .
Füllen Sie im neuen Fenster die Packettails aus. Im Besonderen, wenn Sie in einer Gruppe arbeiten, setzen Sie Eigentum auf die entsprechende Gruppe, in der Sie die Berechtigung haben, Gruppenerlebnisse zu erstellen/zu bearbeiten.
Eigentumsübertragungen werden nicht unterstützt, so dass Sie den Besitzer sorgfältig berücksichtigen, wenn Sie ein Paket erstellen.
Klicken Sie auf Einreichen .
Nachdem die Konversion abgeschlossen ist, erhält das Objekt ein "verlinken"-Symbol im Explorer-Fenster, um als Paket identifiziert zu werden. Darüber hinaus können Sie ein neues PaketLink-Objekt sehen, das an das Objekt gebunden ist.
(Optional) Wählen Sie das PackageLink -Objekt aus und aktivieren Sie AutoUpdate im Eigenschaften -Fenster. Beachten Sie, wie das Icon sich ändert, um anzuzeigen, dass das Paket automatisch aktualisiert ist.
Löschen Sie oder bewegen Sie die PackageLink Instanz nicht! Wenn Sie dies für eine Kopie eines Pakets tun, wird die Kopie in ein normales Objekt umgewandelt und verliert Fähigkeiten wie die Fähigkeit, bei einer neuen Version zu aktualisieren.
Pakete einfügen
Um ein Paket, das noch nicht im aktuellen Ort existiert, einzufügen, musst du es zuerst aus der Toolbox einfügen:
- Von Inventar → My Packages für Pakete, die du veröffentlicht hast oder erhalten hast vom Creator-Store, sowie Pakete, die ein Freund und du ihm 1> Berechtigungen1> erteilt hast, um sie zu verwenden.
- Von Kreationen → Gruppen-Pakete für Pakete, die von Mitgliedern deiner Gruppe veröffentlicht wurden (einschließlich dir).
Sobald du ein Paket in das Modelleines Ortes eingefügt hast, erscheint es im Pakete-Ordner des Asset-Managers und bleibt auch dann noch in deinem Besitz, wenn du später alle Kopien löschst. jedoch wird der Ordner aktualisiert, um nur die Pakete zu reflektieren, die innerhalb des Ortes verwendet werden.
Seien Sie vorsichtig, wenn Sie Assets einfügen, die Sie nicht in Ihren Erlebnissen erstellt haben, da sie bösartige Skripte enthalten können. Speichern Sie zuerst Ihr Erlebnis und untersuchen Sie dann jedes Skript innerhalb unbekannter Assets, damit Sie leicht zurück zur Platz Version zurückkehren können.
Veröffentlichen von Paketänderungen
Du kannst jede Änderung, die du an einem Paket vornehmen, als neue Version veröffentlichen, um sie anderen Kopien des Pakets überall und in allen Erlebnissen zur Verfügung zu stellen. Beachte, dass es nicht erforderlich ist, ein modifiziertes Paket vor dem Veröffentlichen eines Ortes (die modifizierte Version wird zusammen mit dem Ort für eine künftige Iteration gespeichert) zu veröffentlichen.
Um Änderungen an einem Paket zu veröffentlichen:
Im Explorer-Fenster oder Ansichtsfensterklicken Sie mit der rechten Maustaste auf die modifizierte Kopie und wählen Sie Publish to Package .
Wenn eine Paketkopie Auto-Update aktiviert hat, zieht sie sofort die aktualisierte Version ein, wenn Sie den Ort öffnen, der sie enthält. Andere Kopien erhalten einen weißen Punkt auf dem Paket-Symbol, der anzeigt, dass ein Update verfügbar ist. Sie können sie individuell aktualisieren oder massenaktualisieren sie, wenn nötig.
(Optional) Füge eine Beschreibung deiner Änderungen hinzu:
- Klicken Sie mit der rechten Maustaste auf das Paket und wählen Sie Paket-Details .
- In dem Asset-Konfigurationsfenster wählen Sie Versionen .
- Unter deiner jüngsten Änderung, wähle Hinzufügen .
- Beschreiben Sie Ihre Änderungen und klicken Sie auf Einreichen .
Updating veraltete Kopien
Du kannst überholte Paketkopien auf die neueste Version aktualisieren, oder du kannst weiterhin die ältere Version verwenden.
Um eine oder mehrere Paketkopien auf die neueste Version zu aktualisieren:
In dem Explorer-Fenster, suchen Sie nach nicht aktualisierten Kopien durch den weißen Punkt auf der Symbol. Sie können auch die nicht aktualisierte Kopie im 3D-Ansichtsfenster auswählen, aber es könnte schwieriger sein, diesen Weg zu finden.
Klicken Sie mit der rechten Maustaste auf die veraltete Kopie und wählen Sie Letzte Packung erhalten . Sie können auch mehrere Packungen, mit der rechten Maustaste klicken und Letzte Packung für ausgewählte Pakete erhalten auswählen.
Massen-Updates
Die umfassende Verwendung von Paketen kann zu vielen Paketkopien führen, die an mehr Orten in einem Erlebnis liegen. Darüber hinaus können Sie alle Kopien eines Pakets über Massenaktualisierung und Automatische Updates aktualisieren.
(Empfohlen) Schließen Sie andere Studio-Instanzen mit einem der Erlebnisse, die offen sind; dies verhindert, dass eine nicht gespeicherte Instanz eines Ortes möglicherweise Ihre Updates überschreibt.
In dem Explorer-Fenster oder Ansichtsfensterklicken Sie mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Alle aktualisieren .
Wählen Sie alle Orte in der Erfahrung oder einige Untereinheiten von Orten und klicken Sie auf Aktualisieren .
Um unbeabsichtigte Überschreibungen zu verhindern, hat das Mass-Update keinen Einfluss auf modifizierte Versionen eines Pakets. Nachdem das Mass-Update abgeschlossen ist, zeigt Studio eine Warnung mit der Anzahl der Pakete an, die es nicht aktualisiert hat, wenn vorhanden.
Mass-Update-Pakete speichern automatisch plätze, die du ausgewählt hast, aber nicht veröffentlichen.
Automatische Updates
Um das Synchronisieren zu vereinfachen, kannst du ein Paket-Kopierer so einstellen, dass er automatisch aktualisiert wird, wenn eine neue Version veröffentlicht wird. Die automatische Aktualisierung der Paket-Kopien erfolgt, wenn ein Ort in Studio geöffnet wird.
In dem Explorer-Fenster, erweitern Sie den Baum der Hierarchie des Pakets und wählen Sie sein PaketLink-Objekt aus.
In dem Eigenschaften-Fenster, aktivieren Sie die AutoUpdate-Eigenschaft . Wenn Sie verschachtelte Pakete haben, gilt diese Eigenschaft nur für das höchste Stamm-Paket, was bedeutet, dass automatische Updates nur auf das höchste Stamm-Paket aktiviert werden.
Das automatische Aktualisieren gilt nicht für modifizierte Packungskopien. Sobald Sie eine Instanzmodifiziert haben, wird seine AutoUpdate -Eigenschaft deaktiviert und ignoriert.
Berechtigungs- und Zugriffsstufen teilen
Wenn gewünscht, können Sie Pakete mit Freunden teilen oder Zugriff auf bestimmte Benutzerrollen innerhalb Ihrer Gruppe gewähren.
In der Explorer, Toolbox oder Asset Manager, klicken Sie mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Paket-Details .
In dem Asset-Konfigurationsfenster wählen Sie Berechtigungen .
Für ein gruppenbesessenes Paket, erweitern Sie den Rollenbaum. Wählen Sie dann eine Berechtigungsebene für jede Rolle aus. Auswahlkisten, die deaktiviert sind, zeigen an, dass die Berechtigung bereits konfiguriert für diese Rolle ist und nicht von diesem Fenster aus geändert werden kann.
Berechtigung Beschreibung Bearbeiten Mitglieder der Rolle können die aktuellen und früheren Packungsversionen anzeigen, verwenden und Ansicht, einschließlich der Veröffentlichung von Änderungen an der Packungsversion. Der Zugriff auf den Zugriff auf eine Rolle von diesem Fenster gewährt nur Zugriff auf die spezielle Packung . Kein Zugriff Mitglieder der Rolle haben keinen Zugriff auf neue Versionen des Pakets, obwohl sie Zugriff auf die aktuelle Version im Ort behalten. Für ein benutzereigenes Paket, suchen Sie nach Freunden durch das Suchfeld, klicken Sie auf den Benutzernamen und wählen Sie eine Stufe.
Berechtigung Beschreibung Verwenden und anzeigen Der Benutzer kann die aktuellen und früheren Packungsversionen verwenden und anzeigen (aber nicht bearbeiten), und zwarum du dem Benutzer diese Fähigkeit gewährst. Einmal du dem Benutzer diese Fähigkeit gewährt hast, kannst du den Zugriff auf eine Kopie, die er bereits in seine Erlebniseingefügt hat, nicht zurückrufen oder Paket-Updates, aber die Kopien in ihrem Datenmodell bleiben intakt. Bearbeiten Der Benutzer kann die aktuellen und früheren Packungsversionen verwenden, Ansichtund bearbeiten, einschließlich der Veröffentlichung von Änderungen daran.
Pakete modifizieren
Du kannst Pakete und ihre Kinder bearbeiten, genau wie andere Objekte. Wenn du Pakete modifizierst, deaktiviert es die automatische Aktualisierung, bis du die Änderungen veröffentlichst oder rückgängig gemacht hast.
Die meisten Änderungen markieren das Paket als modifiziert, obwohl die folgenden Änderungen nicht Paket-Modifikationen sind:
- Ändern Sie den Namen des Root-Knotens.
- Ändern der Position oder Rotation des Wurzelknotens eines Pakets, das ein BasePart ist, 2> Class.Model2> oder 5> Class.GuiObject5> .
- Ändern einer Verweisung auf ein Teil innerhalb des Pakets, das eine Instanz außerhalb des Pakets referenziert.
Nachdem ein unveröffentlichtes Änderung in einem Paket modifiziert wurde, erhält ein Paket mit unveröffentlichten Änderungen im Explorer-Fenster eine modifizierte Schaltfläche:
Konfigurationen hinzufügen oder aktualisieren
Du kannst Instanz-Attributen in der Wurzel eines Pakets enthalten, um sein Verhalten anzupassen, z. B. die maximale Geschwindigkeit eines verpackten Fahrzeugs oder die Verzögerungszeit für einen verpackten Button.
Wenn Sie ein Paket veröffentlichen, wird die aktuelle Set von Attributen/Werten zum Standard-Konfigurationsbereich des Pakets. In jeder angegebenen Kopie eines Pakets werden Konfigurationen in Mutigitalien angezeigt, und diese Attribute-Werte können auf einer pro-Instanz-Basis geändert werden. Wenn Paket-Kopien aktualisiert werden, werden modifizierte Konfigurationswerte gespeichert, während andere Attribute auf dem neuesten Standard-Wert aktualis
Der einzige Weg, um Konfigurationswerte zu verwalten, ist derzeit, Skripte in das Paket hinzuzufügen, die basierend auf dem Verhalten zur Laufzeit basieren.
Wenn Sie einfach die Standardwerte für Konfigurationen aktualisieren möchten, um diese Werte zu ändern, können Sie diese Attribute-Werte ändern und das Paket (das Paket wird nicht als modifiziert in diesem Fall) veröffentlichen. Wenn Sie andere Änderungen veröffentlichen, aber nicht die Standardkonfigurationswerte ändern, sollten Sie auf ein Paket ohne irgendeinen Wert-Änderung veröffentlichen oder die Konfigurationen vor der Veröffentlichung wieder auf ihre Standardwerte zurückkehren.
Verknüpfte Pakete
Du kannst Pakete in anderen Paketen verschachteln, um komplexe Hierarchien wie eine Reihe von Fahrzeugmechanismen zu verwalten und zusammenzuarbeiten, die unabhängig vom Eltern-Paket des Fahrzeugs modifiziert werden können. Dieses Beispiel zeigt ein Auto-Paket, das vier Kopien des gleichen Rad-Packets enthält:
Wenn Sie ein mehrere Pakete modifizieren, werden sowohl das mehrere Pakete und das Eltern-Paket als modifiziert angesehen. Sie müssen Änderungen veröffentlichen an jedem mehreren Paket, bevor Sie Änderungen an seinem Eltern-Paket veröffentlichen dürfen, da die Veröffentlichung des Elterns als aktuell/unmodifiziert und konflikt mit den Änderungen des mehreren Pakets markiert.
Paket-Skripte
Jedes Skript innerhalb eines nicht modifizierten Pakets ist nur für die Lesung da und zeigt eine Benachrichtigung mit einem Hyperlink, um das Skript, das. PL: die Skriptsfreizuschalten.
Klicken Sie auf den Hyperlink:
- Markiert das Paket als modifiziert, unabhängig davon, ob du das Skript, das. PL: die Skriptsbearbeitest.
- Entfernt die Benachrichtigung/Hyperlink von anderen Skripts innerhalb des Pakets.
Sobald das Paket veröffentlicht und in einen nicht modifizierten Zustand verschoben wird, werden die Skripte unterhalb mit einem Hyperlink zu modifizieren.
Änderungen am Paket rückgängig machen
Statt einer gesamten Reihe von Packungsänderungen aufzuheben, kannst du unveröffentlichte Änderungen in einer Actionrückgängig machen, ein Paket zu einer früheren Version wiederherstellen oder Änderungen an bestimmten Konfigurationen zurückkehren.
Veröffentlichung nicht veränderter Änderungen rückgängig machen
Um eine ganze Reihe von nicht veröffentlichten Änderungen rückgängig zu machen:
In dem Explorer-Fenster, suchen Sie nach modifizierten Kopien durch den Exclamation-Punkt neben ihrem Namen. Sie können auch modifizierte Kopien in der Ansichtsfensterauswählen, was einfacher sein könnte.
Klicken Sie mit der rechten Maustaste auf eine einzelne modifizierte Kopie und wählen Sie Änderungen am Paket rückgängigmachen , oder wählen Sie mehrere Kopien ( mindestens eine davon modifiziert), klicken Sie mit der rechten Maustaste und wählen Sie Änderungen am ausgewählten Paket rückgängigmachen .
Zurücksetzen
Um ein Paket zu einer früher veröffentlichten Version zurückzusetzen:
In dem Explorer-Fenster, dem Ansichtsfenster, der Toolbox oder dem Asset-Manager klicken Sie mit der rechten Maustaste auf das gewünschte Paket und wählen Sie Paket-Details .
In dem Asset-Konfigurationsfenster, wählen Sie Versionen . Das Fenster zeigt Details für jede veröffentlichte Version, einschließlich des Veröffentlichungsdatums und der Zeit, sowie aller Änderungen.
Klicken Sie auf die Kontrollkästchen neben der Version, die Sie wiederherstellen möchten, und klicken Sie auf Einreichen .
Änderungen, die Sie an ein Paket zurückkehren, resetten die Konfiguration nicht auf die Standardversion. Siehe Rückgabe der Konfiguration.
Konfigurationen rückgängig machen
Um eine beliebige Konfiguration-Attribut zu seiner Standardversion zurückzusetzen, wählen Sie die Zurücksetzen -Option aus dem Ausrüstungsmenü in der Eigenschaften -Sektion der 1>Eigenschaften1>-Fenster.
Vergleich von Paketversionen
Wenn ein Paket mehrere Versionen hat, können Sie Änderungen zwischen Versionen mit dem Diff-Ansichts-Editor vergleichen, der hilfreich ist, um die Paket-Updates zu überprüfen, Ihre lokalen Änderungen gegen die neueste Version zu vergleichen und den Inhalt der letzten Version vor dem Restaurieren zu überprüfen.
Das Werkzeug hat ein Package Hierarchie-Menü, das alle hinzugefügten, entfernten oder modifizierten Instanzen zwischen Versionen mit entsprechenden Icons anzeigt, mit den folgenden Tabs verfügbar:
Visual Overview zeigt die visuellen Unterschiede der 3D-Renderung unter verschiedenen Kamerapositionen. Es ist die Standardansicht für Pakete mit einem 3D-Objekt (Modelle, Teile) als Basisobjekt und ist derzeit nur für das Basisobjekt verfügbar.
Eigenschaften zeigt Änderungen an Eigenschaften und Attributen. Es ist die Standardansicht für Pakete mit einem nicht-3D-Objekt (Skripte, Lichter, 2D-Objekte) als Basisobjekt und ist für alle Instanzen in einem Paket verfügbar.
Skript zeigt die Unterschiede zwischen Skripten anhand von Zeilen. Es ist für Pakete mit Skripten verfügbar, unabhängig davon, ob das Skript das Wurzelobjekt ist oder nicht.
Um Versionen von Paketen zu vergleichen:
In dem Explorer-Fenster oder Ansichtsfensterklicken Sie mit der rechten Maustaste auf das Zielpaket und wählen Sie Vergleichen Sie Paketversionen .
Standardmäßig vergleicht das Fenster die Änderungen zwischen deiner lokalen Kopie und der neuesten Version. Verwende die beiden Dropdown-Menüs, um verschiedene Versionen zu vergleichen.
Einige ältere Versionen könnten mit dem Package-Diff-Tool inkompatibel sein.
Nachdem du Versionen ausgewählt hast:
Um die visuellen Rendering des Modellzu vergleichen, wenn geltend, wählen Sie die visuelle Übersicht -Registerkarte und justieren Sie die Kamerasteuerung für Ihren gewünschten Blickwinkel. Steuerungen werden über Ansichten synchronisiert:
- Pfannen Sie die Kamera mit linken Mausklicks.
- Drehen Sie die Kamera mit rechten Maustasten.
- Zoomen Sie mit der Mausrad mit der Kamera ein und aus.
- Recenter mit der Tastenkürzel -F.
Um Eigenschaften und Attribute einer Instanz zu vergleichen, wählen Sie die Instanz und die Eigenschaften -Registerkarte.
Um Skript-Differenzen zu vergleichen, wählen Sie, wenn geltend, ein beliebiges Skript, um die Skript-Registerkarte für line-by-line-Änderungen zwischen Ihren ausgewählten Versionen zu öffnen, ähnlich wie bei Quellsteuerelementen.
Dieses Werkzeug erlaubt es Ihnen, die Skriptänderungen zwischen der aktuellen Version und der neuesten veröffentlichten oder lokalen Version zu vergleichen, ohne die Mitwirkenden anzugeben, die die Änderung vorgenommen haben.
Alternativ können Sie das Skript-Diff-Werkzeug direkt öffnen:
- In dem Explorer-Fenster oder Ansichtsfenster, klicken Sie mit der rechten Maustaste auf das Zielpaket, das entweder ein Skript sein oder Skripte enthalten muss, und wählen Sie Skript-Änderungen anzeigen .
- In der Registerkarte "Unterschiede" öffnet, vergleichen Sie alle Änderungen des ausgewählten Skripts zwischen der aktuellen Pack-Kopie und der neuesten veröffentlichten oder lokalen Version.