Um Assets zu organisieren und wiederverwendbar für Ihr Team oder verschiedene Projekte 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, Duplikatsreduzierung, 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, wenn eine neue Version verfügbar ist.
- Geben Sie Mitarbeitern Bearbeitungs- oder Nutzungsberechtigungen für den Inhalt eines Pakets.
- Sehen Sie sich die vollständige Versionshistorie für ein Paket an, vergleichen Sie Versionen und stellen Sie alte Versionen wieder her.
Der effizienteste Arbeitsablauf besteht darin, ein Paket zu erstellen, es mit allen Mitarbeitern zu teilen und es so einzustellen, dass es automatisch aktualisiert wird. Und Sie müssen nicht warten, bis ein Modell "fertig" ist, bevor Sie es in einem Paket verwenden. Selbst wenn das Paket eine Platzhalterdarstellung über einer einfachen Form ist, können Sie es verwenden, um Ihre Umgebung zu greyboxen, und die Platzhalterkopien werden automatisch aktualisiert, 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 zur Nutzung haben, können Sie das Paket dennoch erstellen, doch diese spezifischen eingeschränkten Assets werden zur Laufzeit nicht sichtbar oder hörbar sein, es sei denn, das Spiel selbst hat die Berechtigung, diese Assets zu verwenden.
Sie können ein Paket aus einem einzelnen Objekt oder einem 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 Kinderobjekte im Paket hinzufügen, entfernen oder skalieren können, ohne das Paket zu beschädigen.
Um ein Paket zu erstellen:
Klicken Sie im Explorer Fenster oder im 3D-Viewport mit der rechten Maustaste auf die Objekt(e), 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 Berechtigung zum Erstellen/Bearbeiten von Gruppenspielen haben.
Eigentumsübertragungen werden vom Assetsystem nicht unterstützt. Daher sollten Sie beim Erstellen eines Pakets sorgfältig über den Eigentümer nachdenken.
Klicken Sie auf Übermitteln.
Nachdem die Konvertierung abgeschlossen ist, erhält das Objekt ein Symbol für "Kettenlink" im Explorer Fenster, um es als Paket zu kennzeichnen. Außerdem sehen Sie ein neues PackageLink Objekt, das dem Objekt übergeordnet 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 bei einer Paketkopie tun, wird die Kopie wieder in ein normales Objekt umgewandelt und die Paketfunktionen, wie die Möglichkeit, sich bei einer neuen Version zu aktualisieren, gehen verloren.
Pakete einfügen
Um ein Paket, das im aktuellen Ort noch nicht existiert, einzufügen, müssen Sie es anfangs aus dem Toolbox einfügen:
- Aus Inventar ⟩ Meine Pakete für Pakete, die Sie veröffentlicht haben 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, wird es im Asset-Manager angezeigt und bleibt dort, auch wenn Sie später alle Kopien daraus löschen.
Seien Sie vorsichtig, wenn Sie Assets einfügen, die Sie nicht erstellt haben, da sie schädliche Skripte enthalten können. Speichern Sie Ihr Spiel zuerst und untersuchen Sie alle Skripte innerhalb unbekannter Assets, damit Sie problemlos zur Platzversion zurückkehren können.
Pakete modifizieren
Sie können Pakete und deren Kinder genau wie andere Objekte bearbeiten. Das Modifizieren von Paketen deaktiviert Auto-Update, bis Sie die Änderungen veröffentlichen oder vorherige Änderungen zurücksetzen.
Die meisten Bearbeitungen kennzeichnen das Paket als modifiziert, obwohl die folgenden Änderungen nicht als Paketmodifikationen angesehen werden:
- Ändern des Namen des Stammknotens.
- Ändern der Enabled Eigenschaft eines Stammknotens GuiObject, wie z. B. ScreenGui, SurfaceGui oder BillboardGui.
- Ändern eines Teilenreferenz von einem Weld innerhalb des Pakets, das auf eine Instanz außerhalb des Pakets verweist.
Nachdem sie modifiziert wurden, erhalten Pakete mit unveröffentlichten Änderungen ein modifiziertes 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 der aktuelle Satz von Attributen/Werten zur Standardkonfiguration des Pakets. Bei jeder Kopie eines Pakets können diese Attributwerte auf instanzspezifischer Basis geändert werden, und diese Änderungen werden durch fett kursiv gekennzeichnet. Wenn Paketkopien aktualisiert werden, werden modifizierte Konfigurationswerte beibehalten, während andere Attribute auf den neuesten Standardwert aktualisiert werden.
Derzeit ist die einzige Möglichkeit, Konfigurationswerte zu behandeln, Skripte im Paket hinzuzufügen, die zur Laufzeit das 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 (in diesem Fall wird das Paket nicht als modifiziert gekennzeichnet). Wenn Sie andere Änderungen veröffentlichen möchten, aber die Standardkonfigurationswerte nicht ändern möchten, sollten Sie in ein Paket veröffentlichen, ohne irgendwelche Wertänderungen vorzunehmen, oder die Konfigurationen auf ihre Standardwerte zurücksetzen, bevor Sie veröffentlichen.
Verschachtelte Pakete
Sie können Pakete in anderen Paketen verschachteln, um komplexe Hierarchien zu pflegen und zusammenzuarbeiten, wie z. B. eine Serie von Fahrzeugmechaniken, die unabhängig vom Stamm-Paket des Fahrzeugs modifiziert werden können.
Wenn Sie ein verschachteltes Paket modifizieren, werden sowohl das verschachtelte Paket als auch das Elter-Paket als modifiziert angesehen. Sie müssen die Änderungen veröffentlichen für jedes verschachtelte Paket, bevor Sie Änderungen am Eltern-Paket veröffentlichen dürfen, da die Veröffentlichung des Eltern-Pakets es als aktuell/unmodifiziert markieren würde und mit den Modifikationen des verschachtelten Pakets in Konflikt steht.
Paket-Skripte
Jedes Skript innerhalb eines unmodifizierten Pakets ist schreibgeschützt und zeigt eine Benachrichtigung oben mit einem Hyperlink zum Entsperren des Skripts an.
Durch Klicken auf den Hyperlink:
- Wird das Paket als modifiziert gekennzeichnet, unabhängig davon, ob Sie das Skript bearbeiten.
- Entfernt die Benachrichtigung/Hyperlink von anderen Skripten innerhalb des Pakets.
Sobald das Paket veröffentlicht und in einen unmodifizierten Zustand versetzt wurde, werden die Skripte darunter schreibgeschützt mit einem Hyperlink zum Modifizieren.
Paketänderungen veröffentlichen
Sie können jede Änderung an einem Paket als neue Version veröffentlichen, damit Ihre Updates anderen Paketkopien im gesamten Ort und in allen Spielen zur Verfügung stehen. Es ist nicht erforderlich, ein modifiziertes Paket zu veröffentlichen, bevor Sie einen Ort veröffentlichen, da die modifizierte 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 modifizierte Kopie und wählen Sie Veröffentlichen an Paket.
Wenn eine Paketkopie die Auto-Update-Funktion aktiviert hat, zieht sie sofort die aktualisierte Version, 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 Asset-Konfigurations-Fenster Versionen.
- Wählen Sie unter Ihrer letzten Änderung Hinzufügen aus.
- Beschreiben Sie Ihre Änderungen und klicken Sie dann auf die Schaltfläche Übermitteln.
Veraltete Kopien aktualisieren
Sie können veraltete Paketkopien auf die neueste Version aktualisieren oder weiterhin die ältere Version 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 Version des Pakets abrufen. Sie können auch mehrere Pakete auswählen, mit der rechten Maustaste klicken und Neueste für ausgewählte Pakete abrufen wählen.
Massenupdates
Umfangreiche Nutzung von Paketen kann dazu führen, dass viele Paketkopien in mehreren Orten eines Spiels vorhanden sind. Neben individuellem Synchronisieren und automatischen Updates können Sie alle Kopien eines Pakets durch Massenaktualisierung 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.
Das Massenaktualisieren von Paketen speichert automatisch die ausgewählten Orte, veröffentlicht sie jedoch nicht. zudem wird, um unbeabsichtigte Überschreibungen zu vermeiden, das Massenaktualisieren nicht auf modifizierte Versionen eines Pakets angewendet; nachdem das Massenupdate abgeschlossen ist, zeigt Studio eine Warnung mit der Anzahl der Pakete an, die nicht aktualisiert wurden, 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.
Klicken Sie im Explorer Fenster auf die Hierarchiebäume 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 am höchsten eingestufte Elternpaket, was bedeutet, dass automatische Updates nur dann erfolgen, wenn das Eltern-Paket aktualisiert wird.
Automatische Updates gelten nicht für modifizierte Paketkopien. Sobald Sie eine Paketinstanz ändern, wird ihre AutoUpdate-Eigenschaft deaktiviert und ignoriert.
Freigabe- und Zugriffslevel
Sie können Freunden, Spielen, Gruppen oder bestimmten Benutzerrollen einer Gruppe Berechtigungen erteilen, damit sie Ihre Pakete in ihren Kreationen frei verwenden können. Für weitere Informationen zu Asset-Zugriff, siehe Asset-Datenschutz.
Wenn Sie ein Paket mit eingeschränkten Assets teilen, für die Sie keine explizite Erlaubnis zur Nutzung haben, können Sie das Paket dennoch 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 Berechtigung, diese Assets zu verwenden.
Um die Paketberechtigungen für einen Mitarbeiter, 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 Asset-Konfigurations-Fenster Berechtigungen.
Verwenden Sie die Suchleiste, um einen Mitarbeiter einzugeben und auszuwählen, dem Sie die Berechtigung zur Verwendung Ihres Pakets erteilen möchten, und wählen Sie dann ein Berechtigungsniveau.
Berechtigung Beschreibung Benutzen & Ansehen Der Mitarbeiter kann die aktuellen und vorherigen Versionen des Pakets benutzen und ansehen (aber nicht bearbeiten). Sobald Sie einem Mitarbeiter diese Fähigkeit geben, können Sie den Zugriff auf eine Kopie, die er bereits in seinem Spiel eingefügt hat, nicht widerrufen; der Widerruf des Zugriffs verhindert eine erneute Einfügung oder Paketaktualisierungen, aber die Paketkopien in seinem Datenmodell bleiben intakt. Bearbeiten Der Mitarbeiter kann die aktuellen und vorherigen Versionen des Pakets nutzen, ansehen und bearbeiten, einschließlich der Veröffentlichung von Änderungen daran.
Paketänderungen zurücksetzen
Anstatt eine gesamte Reihe von Paketänderungen nacheinander rückgängig zu machen, können Sie unveröffentlichte Änderungen zurücksetzen, ein Paket auf eine vorherige Version zurücksetzen oder Änderungen an bestimmten Konfigurationen zurücksetzen.
Unveröffentlichte Änderungen zurücksetzen
Um eine gesamte Reihe unveröffentlichter Änderungen rückgängig zu machen:
Lokalisieren Sie im Explorer Fenster modifizierte Kopien anhand des Punktes auf ihren Paket-Icons. Sie können auch modifizierte Kopien im 3D-Viewport auswählen.
Klicken Sie mit der rechten Maustaste auf eine einzelne modifizierte Kopie und wählen Sie Änderungen am Paket rückgängig machen, oder wählen Sie mehrere Kopien (mindestens eine davon modifiziert), 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ühere 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 Asset-Konfigurations-Fenster Versionen. Das Fenster zeigt Details zu jeder veröffentlichten Version an, einschließlich des Datums und der Uhrzeit der Veröffentlichung sowie eventueller Beschreibungen zu den Änderungen.
- Klicken Sie auf das Häkchen neben der Version, die Sie wiederherstellen möchten, und klicken Sie auf Übermitteln.
Das Zurücksetzen von Änderungen an einem Paket setzt die Konfiguration nicht auf den Standard zurück. Siehe Konfigurationen zurücksetzen.
Konfigurationen zurücksetzen
Um ein beliebiges Konfigurationsattribut auf den Standard 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 Versionen mit dem Änderungsansichts-Tool vergleichen. Das Tool hat ein Menü für die Paket-Hierarchie, das alle hinzugefügten, entfernten oder modifizierten Instanzen zwischen den Versionen mit entsprechenden Symbolen anzeigt, einschließlich der folgenden Funktionen:
Visuelle Übersicht zeigt die visuellen Unterschiede des 3D-Renderings unter verschiedenen Kamerapositionen. Es ist die Standardansicht für Pakete mit einem 3D-Objekt (Modelle, Teile) als Stammobjekt und derzeit nur für das Stammobjekt verfügbar.
Eigenschaften zeigt Änderungen von Eigenschaften und Attributen an. Es ist die Standardansicht für Pakete mit einem Nicht-3D-Objekt (Skripte, Lichter, 2D-Objekte) als Stammobjekt und ist für alle Instanzen in einem Paket verfügbar.
Skript zeigt Zeile für Zeile die Unterschiede zwischen Skripten. Es ist für Pakete verfügbar, die Skripte enthalten, unabhängig davon, ob das Skript das Stammobjekt ist oder nicht.
Um Paketversionen zu vergleichen:
Klicken Sie im Explorer oder 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 Paketdifferenz-Tool inkompatibel sein.
Nach Auswahl der Versionen:
Um die visuellen Darstellungen des Stammmodells zu vergleichen, falls zutreffend, wählen Sie die Registerkarte Visuelle Übersicht aus und passen Sie die Kamerasteuerung für den gewünschten Winkel an. Die Steuerungen sind in allen Ansichten synchronisiert:
- Schwenken Sie die Kamera mit Linksklicks.
- Drehen Sie die Kamera mit Rechtsklicks.
- Zoomen Sie mit dem Mausrad in die Kamera hinein und hinaus.
- Zentrieren Sie sich mit der Tastenkombination F.
Um Eigenschaften und Attribute einer Instanz zu vergleichen, wählen Sie die Instanz und die Registerkarte Eigenschaften aus.
Um die Skriptdifferenzen für ein Paket zu vergleichen, das ein Skript ist oder Skripte enthält, verwenden Sie die Registerkarte Skript.
Dieses Tool erlaubt Ihnen nur, Skriptänderungen zwischen der aktuellen Version und der neuesten veröffentlichten oder lokalen Version zu vergleichen, ohne anzuzeigen, welche Mitarbeiter die Änderung vorgenommen haben.
Alternativ können Sie das Skriptdifferenz-Tool direkt öffnen, indem Sie mit der rechten Maustaste auf das Zielpaket im Explorer Fenster oder im 3D-Viewport klicken und Skriptänderungen anzeigen auswählen.
