Pakiety

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.


Aby utrzymać zasoby zorganizowane i ponownie używalne w całym swoim zespołem lub na kilku projektach, z grupuj swoje instancje i konwertuj je w ponownie używalne pakiety . Pakiety ułatwiają ogólny proces budowy światów szybciej i bardziej ergonomicznie, ale pomagają również z konsekwencją, duplikacją, współpracą i wersją:

Najbardziej wydajny workflow to utworzyć pację , podziel się nią z dowolnymi współpracownikami i ustaw go na auto-aktualizację . I nie musisz czekać, aż model będzie "zrobiony", zanim można go używać w pacji. Nawet jeśli pacja jest

Tworzenie Pakietów

Możesz utworzyć pakiet z dowolnego pojedynczego obiektu lub dowolnego pojedynczego rodzica i dzieci w obiektach. Jeśli chcesz utworzyć pakiet dla pojedynczego obiektu, zalecamy dodać go do grupy Model, abyś mógł go później dodać, dodawaćlub skalować instancję w ramach pakietu bez łamania pakietu.

  1. W oknie Explorer lub 3D viewport, right-click the desired object and select Zapisz jako pakiet .

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. W nowym oknie wypełnij szczegóły pakietu. W szczególności, jeśli pracujesz w grupie grup, ustaw własność na odpowiedniej grupie, w której masz uprawnienia do tworzenia/edytowania doświadczeń grupowych.

  3. Kliknij Składać OFERTĘ .

  4. Po zakończeniu konwersji obiekt otrzymuje symbol "łączyć" w oknie Explorer, aby zidentyfikować go jako pakiet. Ponadto możesz zobaczyć nowy obiekt PackageLink powiązany z obiektem.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (Opcjonalnie) Wybierz obiekt PackageLink i włącz AutoUpdate w oknie Properties . Zauważ, jak ikona zmienia się, aby zaznaczyć, że pakiet jest ustawiony na automatyczną aktualizacja.

    A maple tree model in the Explorer window with the auto-update package icon next to it.

Uszkodzenia pakietów

Aby wstawić pakiet, który jeszcze nie istnieje w obecnym miejsce, musisz najpierw wstawić go z kosza narzędzi :

  • Z zapasuMoje Pakiety dla pakietów, które opublikowałeś lub otrzymałeś z Creator Store , a także pakietów, które posiada i dał ci przyjaciel.
  • Od UtworzeńPakiety grupowe dla paczek opublikowanych przez członków swojej grupy (w tym siebie).
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
Przybornik → Inwentarz → Moje Pakiety
A close up view of the Toolbox with the Creations tab highlighted.
Przybornik → Zestawy narzędziowe → Pakiety grupowe

Gdy wstawisz paczkę do modelu danych miejsca, pojawia się ona w Katalogu Pakietów katalogu Zarządzera zasobów i pozostaje tam nawet jeśli później usuniesz wszystkie kopie z niego. Ale gdy publikujesz miejsce, katalog zostanie zaktualizowany, aby odzwierciedlić tylko używane pakiety w miejscu.

The Asset Manager window with a few example packages.
Pakiety w Menedżerze Zasobów

Publikowanie zmian pakietu

Możesz opublikować wszelkie zmiany, które dokonujesz w pakiecie jako nową wersję, aby uczynić je dostępnymi dla innych kopii pakietu w całym miejscu i wszystkich doświadczeń. Uwaga, że nie jest wymagane opublikowanie modyfikowanego pakietu przed opublikowaniem miejsca (wersja modyfikowana jest zapisywana wraz z miejscem w przyszłości).

Aby opublikować zmiany w pakiecie:

  1. W oknie Explorer lub 3D viewport, right-click the modified copy and select Publish to Package .

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. Jeśli kopia pakietu ma aktualizację automatyczną włączoną, natychmiastowo przyciąga ona aktualizowaną wersję, gdy otworzysz miejsce, które je zawiera. Inne kopie otrzymują białą kropkę na ikonie pakietu, która wskazuje na dostępność aktualizacji. Możesz indywidualnie aktualizować lub masowo aktualizować je, jeśli to konieczne.

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (Opcjonalnie) Dodaj opis swoich zmian:

    1. Kliknij pakiet правой kl릭 i wybierz szczegóły pakietu .
    2. W oknie Konfiguracja zasobów wybierz Wersje.
    3. Podczas najnowszej zmiany, zaznacz Dodaj .
    4. Opisz swoje zmiany i kliknij Zatwierdź .

Aktualizowanie przestarzałych kopii

Możesz aktualizować przestarzałe kopie pakietu do najnowszej wersji lub możesz nadal używać starszej wersji.

Aby aktualizować jedną lub więcej kopii pakietu do najnowszej wersji:

  1. W oknie Explorer, lokalizuj nieaktualne kopie przez biały punkt na ikona. Możesz również wybrać nieaktualną kopię w oknie 3D, ale może być trudniej znaleźć ten sposób.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. Kliknij prawym przyciskiem myszy na usuniętą kopię i wybierz Zdobądź najnowszą wersję programu . Możesz również wybrać wiele pakietów, klikając prawym przyciskiem myszy i Zdobądź najnowszą dla wybranych pakietów .

Masowe aktualizacje

Używanie rozbudowanych pakietów może skutkować wieloma kopiami pakietu w różnych miejscach w doświadczeniu. Oprócz indywidualnego synchronizowania i aktualizacji automatycznych, możesz aktualizować wszystkie kopie pakietu poprzez masowe aktualizowanie.

  1. (Zalecane) Zamknij inne instancje Studio z dowolnym z otwartych miejsc doświadczenia; zapobiega to usunięciu innej niezapisanej instancji miejsca, co może potencjalnie zastąpić Twoje aktualizacje.

  2. W oknie Explorer lub 3D viewport, right-click the desired package and select Zaktualizuj wszystko .

  3. Wybierz wszystkie miejsca w doświadczeniu lub niektóre podzespoły miejsc i kliknij Zaktualizuj .

    A view of the mass update window, showing two places.

    Aby zapobiec nieintencjonalnym przeciążeniom, masowe aktualizowanie nie wpływa na zmodyfikowane wersje pakietu. Po zakończeniu masowej aktualizacji Studio wyświetla ostrzeżenie z liczbą paczek, które nie były aktualizacja, jeśli dotyczy.

Automatyczne aktualizacje

Aby ułatwić synchronizację, możesz ustawić kopię pakietu do aktualizacji automatycznie, gdy nowsza wersja zostanie opublikowana. Automatyczna aktualizacja kopii pakietu będzie miała miejsce, gdy miejsce zostanie otwarte w Studio.

  1. W oknie Explorer, rozwiej drzewo hierarchii pakietu i wybierz jego PackageLink obiekt.

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. W Oknie Proprietści, włącz Automatyczną aktualizację właściwość. Jeśli masz zapakowane paczki, ta właściwość dotyczy tylko najwyższego poziomu rodzica, co oznacza, że aktualizacje automatyczne następują tylko wtedy, gdy rodzica 2>zapakowana2> paczka jest aktualizowana.

Udostępnianie i poziomy dostępu

Jeśli chcesz, możesz podzielić się paczek z przyjaciółmi lub przyznać dostęp do określonych ról użytkownika w Twojej grupa.

  1. W Explorerze, Toolbox lub Asset Manager, prawym kliknięciem kliknij szczegóły pakietu .

  2. W oknie Konfiguracja zasobów wybierz Uprawnienia.

    • Dla pakietu własności grupy rozwiniętego drzewa związków. Następnie wybierz poziom uprawnienia dla każdej roli. Pole wyboru, które jest wyłączone, wskazuje, że pozwolenie jest już skonfigurowane dla tej roli i nie może być zmienione z tego okna.

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      ZezwolenieOpis
      Edytuj Członkowie roli mogą używać, oglądać i edytować obecne i poprzednie wersje pakietu, w tym publikować zmiany w nim. Udzielenie dostępu do edytowania roli z tego okna tylko daje dostęp do konkretnej wersji pakietu .
      Brak dostępu Członkowie tej roli nie mają dostępu do żadnych nowych wersji pakietu, choć zachowują dostęp do obecnej wersji umieszczonej w miejsce.
    • Dla pakietu użytkownika poszukaj przyjaciół poprzez polu wyszukiwania, kliknij ich nazwa użytkownikai wybierz poziom upoważnienia .

      ZezwolenieOpis
      Użyj i Zobacz Użytkownik może używać i wyświetlać (ale nie edytować) obecne i poprzednie wersje pakietu. Po zapewnieniu użytkownikowi tej funkcji nie można cofnąć dostępu do kopii, które już wkleił do swojego doświadczenia; cofnąć dostępu nie pozwala na ponowne umieszczenie lub aktualizację pakietu, ale kopie pakietu w ich modelu danych pozostają nieuszkodzone.
      Edytuj Użytkownik może używać, oglądać i edytować bieżące i poprzednie wersje pakietu, w tym publikować zmiany w nim.

Modyfikowanie paczek

Możesz edytować pakiety i ich dzieci tak jak inne obiekty. Modyfikowanie pakietów wyłącza aktualizację automatyczną, aż do czasu opublikowania lub cofnięcia zmian.

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

Większość edycji oznacza pakiet jako zmodyfikowany, choć następujące zmiany nie są uznawane za zmiany pakietu:

  • Zmiana imienia węzła korzenia.
  • Zmiany pozycji i lub rotacji i korzenia węzła pakietu, który jest BasePart , 1> Class.Model1> lub 4> Class.GuiObject4> .
  • Zmiany właściwości Włączonej węzła korzenia GuiObject takie jak ScreenGui, 1> Class.SurfaceGui1> lub 4> Class.BillboardGui4>.
  • Zmiana części referencji Weld w pakiecie, który odnosi się do instancji poza pakiecie.

Po zmodyfikowaniu, pakiety z nieopublikowanymi zmianami otrzymują zmodyfikowany icon w oknie Explorer :

The Explorer window with an icon that identifies unpublished package changes.

Dodawanie lub aktualizowanie konfiguracji

Możesz włączyć instytucje atrybuty w korzeniu pakietu, aby dostosować jego zachowanie, na przykład maksymalną prędkość pojazdu zapakowanego lub czas odwrócenia dla pakietu.

Kiedy publikujesz pację, obecny zestaw atrybutów/wartości staje się domyślnymi konfiguracjami pacji. W dowolnej dostępnej kopii pacji konfiguracje są wyświetlane w oryginalnych wersjach i te wartości atrybutów można zmienić na bazie przypadku. Gdy kopie pacji są aktualizowane, zmienione

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

Pakiety złożone

Możesz nazywać inne pakiety pakietami, aby utrzymać i współpracować z złożonymi hierarchiami, takimi jak seria pojazdów mechanicznych, która może być modyfikowana niezależnie od rodzica pakietu pojazdu. Ten przykład pokazuje przykład pakietu samochodowego, który zawiera cztery kopie tego samego pakietu koła:

An expanded hierarchy in the Explorer window showing how packages can contain packages.

Skrypty Pakietu

Każdy skrypt w nienaruszonym pakiecie jest tylko czytelny i pokazuje powiadomienie na górze z hiperłączem do odblokowania skryptu.

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

Kliknięcie hiperłącza:

  • Znaczy pakiet jako zmodyfikowany bez względu na to, czy edytujesz skrypt.
  • Usuwa powiadomienie/hiperłączeń z innych skryptów w pakiecie.

Gdy pakiet zostanie opublikowany i przeniesiony do nienaruszony stanu, skrypty pod nim stają się czytelne tylko z hiperłączem do modyfikacji.

Przywracanie zmian pakietu

Zamiast cofnięcia całej serii zmian w pakiecie jeden po drugim możesz przywrócić nieopublikowane zmiany w jednym akcji, przywrócić pakiet do poprzedniego wersji lub przywrócić zmiany do określonych konfiguracji .

Przywracanie nieopublikowanych zmian

Aby cofnąć całą serię nieopublikowanych zmian:

  1. W oknie Explorer znajduj modyfikowane kopie przy wykrzyknięciu obok ich nazw. Możesz również wybrać modyfikowane kopie w oknie 3D, co może być łatwiejsze.

  2. Kliknij prawym przyciskiem myszy pojedynczą zmodyfikowaną kopię i wybierz Odwróć zmiany pakietu lub wybierz wiele kopii (przynajmniej jedna z nich zmodyfikowana), kliknij prawym przyciskiem myszy i wybierz Odwróć zmiany wybranych pakietów .

Przywracanie do wersji

Aby przywrócić pakiet do wersji z poprzednio opublikowanej :

  1. W oknie Explorer, 3D viewport, Toolbox lub Asset Manager, right-click the desired package and select szczegóły pakietu .

  2. W oknie Konfiguracja zasobów wybierz wersje . Okno wyświetla szczegóły dla każdej opublikowanej wersji, w tym datę i czas publikacji, wraz z dowolnymi opisami zmian.

  3. Kliknij znaczek obok wersji, którą chcesz przywrócić, i kliknij Zatwierdź .

    The pop-up window for a chandelier asset. It displays multiple versions.

Przywracanie ustawień

Aby odwrócić dowolne akttryb konfiguracji atrybutu do jego domyślnego, wybierz opcję Zresetuj z menu gear w sekcji Atrybuty w oknie 2>Właściwości2>.

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

Porównanie wersji pakietu

Gdy pakiet ma wiele wersji, możesz porównać zmiany między wersjami, używając widoku różnic, który jest pomocny do przeglądania aktualizacji pakietu, porównywania lokalnych zmian wobec najnowszej wersji i sprawdzania zawartości poprzednich wersji przed przywróceniem.

Narzędzie ma menu hierarchii pakietu, które pokazuje wszystkie dodane, usunięte lub zmodyfikowane instancje między wersjami, używając odpowiednich ikonek, z następującymi dostępnymi zakładkami:

  • Przeglad wizualny pokazuje różnice wizualne 3D renderowania pod różnymi pozycjami kamery. Jest to domyślny widok dla paczek z obiektem 3D (modeli, części) jako obiektem korzenia, i jest obecnie tylko dostępny dla obiektu korzenia.

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • Właściwości pokazuje zmiany właściwości i cechach. Jest to domyślny widok dla paczek z nieobsługującym się obiektem (skrypty, światła, obiekty 2D) jako obiektu korzenia i jest dostępny dla wszystkich instancji w pacjalu.

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • Skrypt pokazuje różnice między skryptami linii. Jest dostępny dla paczek zawierających skrypty, niezależnie czy skrypt jest obiektem korzeniowym czy nie.

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

Aby porównać wersje pakietu:

  1. W oknie Explorer lub 3D viewport, right-click the target package and select Porównaj wersje pakietu .

  2. Domyślnie okno porównuje zmiany między twoją lokalną kopią a najnowszą wersją. Użyj dwóch menu uproszczonych menu, aby porównać różne wersje.

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. Po wyborze wersji:

    • Aby porównać wizualne renderowanie modelu korzenia, jeśli to mające zastosowanie, wybierz Przeglad wizualny zakładkę i dostosuj sterowanie kamera dla pożądanego kąta. Sterowanie jest zsynchronizowane między widokami:

      • Zakręć kamerę używając lewych kliknięć myszy.
      • Obróć kamerę używając prawych kliknięć myszy.
      • Zoomuj kamerkę w górę i w dół za pomocą koła myszy.
      • Użyj skrótu klawiaturowego -F.
    • Aby porównać właściwości i cechy instancja, wybierz instancję i Strona cech tab.

    • Aby porównać różnice w skryptach, jeśli to mające zastosowanie, wybierz dowolny skrypt, aby otworzyć Tab Skrypt dla zmian linii bocznej między wybranymi przez Ciebie wersjami, podobnie jak w przypadku aplikacji kontroli źródła.

Alternatywnie możesz otworzyć bezpośrednio narzędzie do różnicy krypt:

  1. W oknie Explorer lub 3D viewport, right-click target package, which must be a script, or contain scripts, and select Zobacz zmiany skryptów .
  2. W otwartym polu wyboru porównaj wszystkie zmiany w wybranym skrypcie między obecną kopią pakietu a najnowszą publikowaną lub lokalną wersją.