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ą ogólny proces budowania światów i czynią go bardziej ergonomicznym, ale także pomagają w utrzymaniu spójności, eliminacji duplikatów, współpracy i wersjonowaniu:

• Łatwo aktualizuj wszystkie kopie pakietu do najnowszej wersji lub tylko aktualizuj konkretne kopie.
• Ustaw pakiety na automatyczną aktualizację za każdym razem, gdy pojawi się nowa wersja.
• Przyznaj współpracownikom uprawnienia Edytuj lub Użyj do zawartości pakietu.
• Zobacz pełną historię wersji pakietu, porównaj wersje i przywróć starsze wersje.

Najbardziej efektywny przepływ pracy to utworzenie pakietu, udostępnienie go współpracownikom oraz ustawienie go na automatyczną aktualizację. Nie musisz czekać, aż model będzie "gotowy", zanim użyjesz go w pakiecie. Nawet jeśli pakiet jest tylko miejscem na prostym kształcie, możesz go użyć do szarego modelowania swojego środowiska, a następnie mieć automatycznie aktualizowane kopie zastępcze, gdy publikujesz bardziej szczegółowe wersje.

Tworzenie pakietów

Możesz utworzyć pakiet z dowolnego pojedynczego obiektu lub z dowolnej pojedynczej gałęzi obiektów rodzica i dzieci. Jeśli chcesz utworzyć 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, a 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 pozwolenie na tworzenie/edycję gier grupowych.

   Przenoszenie własności nie jest obsługiwane przez system zasobów, więc dokładnie rozważ właściciela podczas tworzenia pakietu.

3. Kliknij Wyślij.

4. Po zakończeniu konwersji 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ż, jak 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 Narzędzi:

• 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 dał ci uprawnienia do użycia.
• Z Tworzenia ⟩ Pakiety Grupowe 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 samo jak inne obiekty. Modyfikowanie pakietów wyłącza automatyczną aktualizację, dopóki nie opublikujesz lub nie przywrócisz zmian.

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

• Zmiana nazwa 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ęzła głównego GuiObject, takiego jak ScreenGui, SurfaceGui lub BillboardGui.
• Zmiana odniesienia części Weld wewnątrz pakietu, które odnosi się do instancji poza pakietem.

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

Dodaj lub zaktualizuj konfiguracje

Możesz dołączyć atrybuty instancji na poziomie głównym pakietu, aby dostosować jego zachowanie. Gdy publikujesz pakiet, bieżący zestaw atrybutów/wartości stanie się domyślnymi konfiguracjami pakietu. W dowolnej kopii pakietu te wartości atrybutów mogą być zmieniane na poziomie instancji, a te zmiany są zaznaczone przez pogrubione kursywy. Gdy kopie pakietu są aktualizowane, zmodyfikowane wartości konfiguracji będą zachowane, podczas gdy inne atrybuty zostaną zaktualizowane do najnowszej wartości domyślnej.

Zagnieżdżone pakiety

Możesz zagnieżdżać pakiety w innych pakietach, aby utrzymać i współpracować nad złożonymi hierarchiami, takimi jak seria mechanik pojazdów, które można modyfikować niezależnie od pakietu rodzica pojazdu.

Jeśli zmodyfikujesz zagnieżdżony pakiet, zarówno zagnieżdżony pakiet jak i pakiet rodzica są uważane za zmodyfikowane. Musisz opublikować zmiany w jakimkolwiek zagnieżdżonym pakiecie, zanim będziesz mógł opublikować zmiany w jego pakiecie rodzica, ponieważ publikacja rodzica oznaczałaby go jako aktualny/niezmodyfikowany i kolidowałaby z modyfikacjami zagnieżdżonego pakietu.

Skrypty pakietów

Każdy skrypt w niezmodyfikowanym pakiecie jest tylko do odczytu i wyświetla powiadomienie na górze z hiperłączem 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.

Gdy pakiet jest publikowany i przenoszony do stanu niezmodyfikowanego, skrypty pod nim stają się tylko do odczytu z hiperłączem do modyfikacji.

Publikowanie zmian w pakiecie

Możesz opublikować każdą 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 publikowaniem miejsca, ponieważ zmodyfikowana wersja jest zapisywana razem z miejscem do przyszłej 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 aktualizacja jest dostępna. 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 Zasobów wybierz Wersje.
   3. Pod swoją najnowszą zmianą wybierz Dodaj.
   4. Opisz swoje zmiany, a następnie kliknij przycisk Wyślij.

Aktualizowanie przestarzałych kopii

Możesz zaktualizować przestarzałe kopie pakietów do najnowszej wersji lub możesz kontynuować używanie 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 najnowsze dla wybranych pakietów.

Masowe aktualizacje

Intensywne użycie pakietów może skutkować wieloma kopiami pakietów w różnych miejscach w grze. Oprócz indywidualnej synchronizacji i automatycznych aktualizacji, możesz zaktualizować wszystkie kopie pakietu poprzez masowe aktualizacje.

1. ZALECANE

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

Automatyczne aktualizacje

Aby ułatwić synchronizację, możesz ustawić kopię pakietu na automatyczną aktualizację za każdym razem, gdy opublikowana zostanie nowsza wersja. Automatyczna aktualizacja kopii pakietu nastąpi, gdy miejsce zostanie otwarte 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 rodzica, co oznacza, że automatyczne aktualizacje występują tylko wtedy, gdy pakiet rodzica jest aktualizowany.

Udostępnianie i poziomy dostępu

Możesz przyznać pozwolenie przyjaciołom, grom, grupom lub konkretnym rolom użytkowników grupy, aby mogli swobodnie używać twoich pakietów w swoich tworach. Aby uzyskać 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, Narzędzi lub Menedżera Zasobów, kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje Pakietu ⟩ Szczegóły Pakietu.

2. W oknie Konfiguracja Zasobów wybierz Uprawnienia.

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

   Uprawnienie	Opis
   Użyj i Zobacz	Współpracownik może używać i widzieć (ale nie edytować) bieżące i poprzednie wersje pakietu. Gdy raz przyznasz współpracownikowi tę możliwość, nie możesz cofnąć dostępu do kopii, którą już wstawił do swojej gry; cofnięcie dostępu uniemożliwia ponowne wstawienie lub aktualizacje pakietu, ale kopie pakietu w ich modelu danych pozostają nienaruszone.
   Edytuj	Współpracownik może używać, widzieć i edytować bieżące i poprzednie wersje pakietu, w tym publikować zmiany w nim.

Przywracanie zmian w pakiecie

Zamiast cofać całą serię zmian w pakiecie jeden po drugim, możesz przywrócić nieopublikowane zmiany w jednej akcji, przywrócić pakiet do poprzedniej wersji lub cofnąć zmiany do konkretnych konfiguracji.

Przywracanie nieopublikowanych zmian

Aby cofnąć całą serię 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 w pakiecie, lub wybierz wiele kopii (przynajmniej jedna z nich zmodyfikowana), kliknij prawym przyciskiem myszy i wybierz Cofnij zmiany w wybranych pakietach.

Przywracanie do opublikowanej wersji

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

1. W oknie Eksploratora, Narzędzi lub Menedżera Zasobów, kliknij prawym przyciskiem myszy żądany pakiet i wybierz Opcje Pakietu ⟩ Szczegóły Pakietu.
2. W oknie Konfiguracja Zasobów wybierz Wersje. Okno wyświetli szczegóły dla każdej opublikowanej wersji, w tym datę i czas publikacji oraz wszelkie opisy zmian.
3. Kliknij znacznik obok wersji, którą chcesz przywrócić, a następnie kliknij Wyślij.

Cofanie konfiguracji

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

Porównywanie wersji pakietów

Gdy pakiet ma wiele wersji, możesz porównać zmiany między wersjami za pomocą narzędzia do porównywania różnic. Narzędzie ma menu hierarchii pakietów, 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. Jest to domyślny widok dla pakietów z obiektem 3D (modele, części) jako obiektem głównym i jest obecnie dostępny tylko dla obiektu głównego.

• Właściwości pokazuje zmiany właściwości i atrybutów. Jest to domyślny widok dla pakietów z obiektem nie-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ępny dla pakietów zawierających skrypty, niezależnie od tego, czy skrypt jest obiektem głównym, czy nie.

Aby porównać wersje pakietów:

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 pożądanego kąta. Kontrole są synchronizowane w różnych widokach:

      • Przesuwaj kamerę, używając lewych kliknięć myszy.
      • Obracaj kamerę, używając prawych kliknięć myszy.
      • Przybliżaj i oddalaj kamerę za pomocą kółka myszy.
      • Wyśrodkowanie za pomocą skrótu klawiaturowego F.

   2. Aby porównać właściwości i atrybuty instancji, wybierz instancję i 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 tylko 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 otworzyć narzędzie do porównywania skryptów bezpośrednio, klikając prawym przyciskiem myszy docelowy pakiet w oknie Eksploratora lub w widoku 3D i wybierając Zobacz Zmiany w Skrypcie.