Pakiety

Aby utrzymać zasoby w porządku i ponownie je wykorzystać w zespole lub w różnych projektach, możesz grupować swoje instancje i przekształcać je w pakiety. Pakiety przyspieszają cały proces budowania światów, sprawiając, że jest on bardziej ergonomiczny, a także pomagają w utrzymaniu spójności, eliminacji duplikacji, współpracy i wersjonowaniu:

• Łatwo zaktualizuj wszystkie kopie pakietu do najnowszej wersji lub aktualizuj tylko konkretne kopie.
• Ustaw pakiety na automatyczne aktualizacje zawsze, gdy dostępna jest nowa wersja.
• Nadaj współpracownikom uprawnienia Edycja lub Użycie do zawartości pakietu.
• Wyświetl pełną historię wersji pakietu, porównuj wersje i przywracaj stare wersje.

Najwydajniejszy przepływ pracy to utworzenie pakietu, udostępnienie go współpracownikom oraz ustawienie na automatyczne aktualizacje. Nie musisz czekać, aż model będzie "ukończony", zanim użyjesz go w pakiecie. Nawet jeśli pakiet jest miejscem przechowywania na prostej bryle, możesz go użyć do greybox'a swojego środowiska, a następnie automatyczne aktualizacje spowodują, że placeholderowe kopie będą się aktualizować, gdy opublikujesz bardziej szczegółowe wersje.

Tworzenie pakietów

Możesz stworzyć pakiet z dowolnego pojedynczego obiektu lub dowolnej gałęzi obiektów nadrzędnych i ich dzieci. Jeśli chcesz stworzyć pakiet dla pojedynczego obiektu, najpierw dodaj go do grupy Model, aby móc później dodawać, usuwać lub skalować obiekty podrzędne w pakiecie bez łamania pakietu.

Aby utworzyć pakiet:

1. W oknie Eksploratora lub w widoku 3D, kliknij prawym przyciskiem myszy obiekt(y), które chcesz przekształcić w pakiet i w menu kontekstowym wybierz Przekształć w Pakiet.

2. W nowym oknie wypełnij szczegóły pakietu. W szczególności, jeśli pracujesz w grupie, ustaw Własność na odpowiednią grupę, w której masz uprawnienia do tworzenia/edycji gier grupowych.

   Przekazywanie własności nie jest wspierane przez system zasobów, dlatego dokładnie przemyśl właściciela podczas tworzenia pakietu.

3. Kliknij Zatwierdź.

4. Po zakończeniu przekształcania obiekt otrzymuje symbol "łańcucha" w oknie Eksploratora, aby zidentyfikować go jako pakiet. Dodatkowo możesz zobaczyć nowy obiekt PackageLink przypisany do obiektu.

   

5. OPCJONALNE

   Wybierz obiekt PackageLink i włącz AutoUpdate w oknie Właściwości. Zauważ, że ikona zmienia się, aby wskazać, że pakiet jest ustawiony na automatyczną aktualizację.

Wstawianie pakietów

Aby wstawić pakiet, który nie istnieje już w bieżącym miejscu, musisz początkowo wstawić go z Toolboxa:

• Z Inwentarza ⟩ Moje Pakiety dla pakietów, które opublikowałeś lub uzyskałeś z Sklepu Twórcy, a także pakietów, które posiada przyjaciel i udzielił ci uprawnień do ich użycia.
• Z Kreacji ⟩ Pakiety Grupy dla pakietów opublikowanych przez członków twojej grupy (w tym ciebie).

Gdy wstawisz pakiet do modelu danych opublikowanego miejsca, pojawi się on w Menedżerze Zasobów i pozostanie tam nawet, jeśli później usuniesz wszystkie jego kopie.

Modyfikowanie pakietów

Możesz edytować pakiety i ich dzieci tak, jak inne obiekty. Modyfikowanie pakietów wyłącza automatyczną aktualizację do momentu, gdy opublikujesz lub cofniesz zmiany.

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

• Zmiana nazwy węzła głównego.
• Zmiana pozycji lub rotacji węzła głównego pakietu, który jest BasePart, Model lub GuiObject.
• Zmiana właściwości Enabled w węźle głównym GuiObject, takim jak ScreenGui, SurfaceGui lub BillboardGui.
• Zmiana referencji części Weld wewnątrz pakietu, która odnosi się do instancji poza pakietem.

Po modyfikacji pakiety z nieopublikowanymi zmianami otrzymują ikonę zmodyfikowaną w oknie Eksploratora:

Dodawanie lub aktualizowanie konfiguracji

Możesz dodać atrybuty instancji na poziomie głównym pakietu, aby dostosować jego działanie. Gdy publikujesz pakiet, obecny zestaw atrybutów/wartości staje się domyślnymi konfiguracjami pakietu. W dowolnej kopii pakietu te wartości atrybutów można zmieniać na poziomie instancji, a te zmiany są oznaczane przez pogrubione kursywy. Gdy kopie pakietów są aktualizowane, zmienione wartości konfiguracji będą zachowane, podczas gdy inne atrybuty zostaną zaktualizowane do najnowszej wartości domyślnej.

Pakiety zagnieżdżone

Możesz zagnieżdżać pakiety w innych pakietach, aby utrzymać i współpracować nad złożonymi hierarchiami, takimi jak seria mechanizmów pojazdów, które mogą być modyfikowane niezależnie od nadrzędnego pakietu pojazdu.

Jeśli modyfikujesz zagnieżdżony pakiet, zarówno zagnieżdżony pakiet, jak i pakiet nadrzędny są uznawane za zmodyfikowane. Musisz opublikować zmiany w dowolnym zagnieżdżonym pakiecie, zanim będziesz mógł opublikować zmiany w jego pakiecie nadrzędnym, ponieważ publikacja pakietu nadrzędnego oznaczy go jako aktualny/niezmodyfikowany i będzie kolidować z modyfikacjami zagnieżdżonego pakietu.

Skrypty pakietu

Każdy skrypt w niezmodyfikowanym pakiecie jest tylko do odczytu i pokazuje powiadomienie na górze z linkiem do odblokowania skryptu.

Kliknięcie hiperłącza:

• Oznacza pakiet jako zmodyfikowany, niezależnie od tego, czy edytujesz skrypt.
• Usuwa powiadomienie/hiperłącze z innych skryptów w pakiecie.

Po opublikowaniu pakietu i przejściu w stan niezmodyfikowany, skrypty pod nim stają się tylko do odczytu z hiperłączem do modyfikacji.

Publikowanie zmian w pakiecie

Możesz opublikować dowolną zmianę w pakiecie jako nową wersję, udostępniając swoje aktualizacje innym kopiom pakietu w całym miejscu i we wszystkich grach. Nie jest wymagane publikowanie zmodyfikowanego pakietu przed publikacją miejsca, ponieważ zmodyfikowana wersja jest zapisywana wraz z miejscem do przyszłych iteracji.

Aby opublikować zmiany w pakiecie:

1. W oknie Eksploratora lub w widoku 3D kliknij prawym przyciskiem myszy zmodyfikowaną kopię i wybierz Opublikuj do Pakietu.

2. Jeśli kopia pakietu ma włączoną automatyczną aktualizację, natychmiast pobiera zaktualizowaną wersję, gdy otworzysz miejsce, które je zawiera. Inne kopie otrzymują symbol "pobierania", który wskazuje, że dostępna jest aktualizacja. Możesz indywidualnie zaktualizować lub masowo zaktualizować wszystkie kopie.

   

3. OPCJONALNE

   Dodaj opis swoich zmian:

   1. Kliknij prawym przyciskiem myszy pakiet i wybierz Szczegóły Pakietu.
   2. W oknie Konfiguracja Zasobu wybierz Wersje.
   3. Pod swoim najnowszym zmianą kliknij Dodaj.
   4. Opisz swoje zmiany, a następnie kliknij przycisk Zatwierdź.

Aktualizowanie przestarzałych kopii

Możesz zaktualizować przestarzałe kopie pakietów do najnowszej wersji lub możesz dalej używać starszej wersji.

1. W oknie Eksploratora zlokalizuj przestarzałe kopie po symbolu "pobierania". Możesz także wybrać przestarzałą kopię w widoku 3D.

   

2. Kliknij prawym przyciskiem myszy przestarzałą kopię i wybierz Pobierz najnowszy pakiet. Możesz także wybrać wiele pakietów, kliknąć prawym przyciskiem myszy i wybrać Pobierz najnowszy dla wybranych pakietów.

Masowe aktualizacje

Intensywne wykorzystanie pakietów może skutkować wieloma kopiami pakietów w różnych miejscach w grze. Oprócz indywidualnego synchronizowania i automatycznych aktualizacji, możesz aktualizować wszystkie kopie pakietu poprzez masowe aktualizacje.

1. ZALECANE

   Zamknij inne instancje Studio z otwartymi miejscami gry; zapobiega to przypadkowemu nadpisaniu twoich aktualizacji przez inną niezapisaną instancję miejsca.
2. W oknie Eksploratora lub w widoku 3D kliknij prawym przyciskiem myszy żądany pakiet i wybierz Aktualizuj Wszystkie.
3. Wybierz wszystkie miejsca w grze lub pewien podzbiór miejsc i kliknij Aktualizuj.

Automatyczne aktualizacje

Aby ułatwić synchronizację, możesz ustawić kopię pakietu na automatyczne aktualizacje, gdy tylko nowa wersja zostanie opublikowana. Automatyczną aktualizację kopii pakietu dokonuje się, gdy miejsce jest otwierane w Studio.

1. W oknie Eksploratora, rozwiń drzewo hierarchii pakietu i wybierz jego obiekt PackageLink.

   

2. W oknie Właściwości włącz właściwość AutoUpdate. Jeśli masz zagnieżdżone pakiety, ta właściwość dotyczy tylko najwyższego pakietu nadrzędnego, co oznacza, że automatyczne aktualizacje występują tylko wtedy, gdy aktualizowany jest pakiet nadrzędny.

Udostępnianie i poziomy dostępu

Możesz przyznać uprawnienia znajomym, grom, grupom lub konkretnym rolom użytkowników grupy, aby mogli swobodnie korzystać z twoich pakietów w swoich twórczościach. Więcej informacji na temat dostępu do zasobów, zobacz Prywatność zasobów.

Aby zmienić uprawnienia pakietu dla współpracownika, takiego jak przyjaciel lub grupa:

1. W oknie Eksploratora, Toolbox lub Menedżera Zasobów, kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje Pakietu ⟩ Szczegóły Pakietu.

2. W oknie Konfiguracja Zasobu, wybierz Uprawnienia.

3. Używając paska wyszukiwania, wprowadź i wybierz współpracownika, któremu chcesz przyznać pozwolenie na użycie twojego pakietu, a następnie wybierz poziom uprawnienia.

   Uprawnienia	Opis
   Użyj i Wyświetl	Współpracownik może używać i przeglądać (ale nie edytować) aktualne i poprzednie wersje pakietu. Po przyznaniu współpracownikowi tej zdolności, nie możesz cofnąć dostępu do kopii, którą już wstawił do swojej gry; cofnięcie dostępu zapobiega ponownemu wstawieniu lub aktualizacjom pakietów, ale kopie pakietów w ich modelu danych pozostają nienaruszone.
   Edycja	Współpracownik może używać, przeglądać i edytować aktualne oraz poprzednie wersje pakietu, w tym publikować zmiany w nim.

Cofanie zmian w pakiecie

Zamiast cofać cały szereg zmian w pakiecie jeden po drugim, możesz cofnąć nieopublikowane zmiany w jednej akcji, przywrócić pakiet do wcześniejszej wersji lub cofnąć zmiany do konkretnych konfiguracji.

Cofanie nieopublikowanych zmian

Aby cofnąć cały szereg nieopublikowanych zmian:

1. W oknie Eksploratora zlokalizuj zmodyfikowane kopie po kropce na ich ikonach pakietów. Możesz także wybrać zmodyfikowane kopie w widoku 3D.

   

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

Przywrócenie do wersji opublikowanej

Aby przywrócić pakiet do wcześniej opublikowanej wersji:

1. W oknie Eksploratora, Toolboxie lub Menedżerze Zasobów, kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje Pakietu ⟩ Szczegóły Pakietu.
2. W oknie Konfiguracja Zasobu wybierz Wersje. Okno pokazuje szczegóły dla każdej opublikowanej wersji, w tym datę i godzinę publikacji oraz wszelkie opisy zmian.
3. Kliknij znacznik obok wersji, którą chcesz przywrócić, a następnie kliknij Zatwierdź.

Cofanie konfiguracji

Aby cofnąć dowolny atrybut konfiguracji do wartości domyślnej, wybierz Resetuj z menu opcji w sekcji Atrybuty w oknie Właściwości.

Porównaj wersje pakietu

Gdy pakiet ma wiele wersji, możesz porównać zmiany między wersjami używając narzędzia do porównywania różnic. Narzędzie ma menu hierarchii pakietu, które wskazuje wszystkie dodane, usunięte lub zmodyfikowane instancje między wersjami za pomocą odpowiednich ikon, w tym następujące funkcje:

• Przegląd wizualny pokazuje wizualne różnice w renderowaniu 3D pod różnymi pozycjami kamery. To jest domyślny widok dla pakietów z obiektem 3D (modele, części) jako obiektem głównym i obecnie jest dostępny tylko dla obiektu głównego.

• Właściwości pokazuje zmiany właściwości i atrybutów. To jest domyślny widok dla pakietów z obiektem niena 3D (skrypty, światła, obiekty 2D) jako obiektem głównym i jest dostępny dla wszystkich instancji w pakiecie.

• Skrypt pokazuje różnice w skryptach linia po linii. Jest dostępne dla pakietów zawierających skrypty, niezależnie od tego, czy skrypt jest obiektem głównym, czy nie.

Aby porównać wersje pakietu:

1. W oknie Eksploratora lub w widoku 3D kliknij prawym przyciskiem myszy docelowy pakiet i wybierz Opcje Pakietu ⟩ Porównaj Wersje Pakietu.

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

   

   Niektóre starsze wersje mogą być niekompatybilne z narzędziem do porównywania różnic pakietów.

3. Po wybraniu wersji:

   1. Aby porównać wizualne renderowania modelu głównego, jeśli dotyczy, wybierz zakładkę Przegląd wizualny i dostosuj kontrolę kamery do żądnego kąta. Kontrole są zsynchronizowane w różnych widokach:

      • Poruszaj kamerą używając lewych kliknięć myszy.
      • Kręć kamerą używając prawych kliknięć myszy.
      • Powiększaj i pomniejszaj kamerę za pomocą kółka myszy.
      • Centruj używając skrótu klawiaturowego F.

   2. Aby porównać właściwości i atrybuty instancji, wybierz instancję oraz zakładkę Właściwości.

   3. Aby porównać różnice w skryptach dla pakietu, który jest skryptem lub zawiera skrypty, użyj zakładki Skrypt.

      To narzędzie pozwala jedynie na porównanie zmian w skryptach między bieżącą wersją a najnowszą opublikowaną lub lokalną wersją, bez wskazywania współpracowników, którzy dokonali zmiany.

      Alternatywnie, możesz bezpośrednio otworzyć narzędzie do porównywania skryptów klikając prawym przyciskiem myszy docelowy pakiet w oknie Eksploratora lub w widoku 3D i wybierając Zobacz Zmiany w Skrypcie.