패키지

팀이나 여러 프로젝트에서 자산을 조직화하고 재사용할 수 있도록 하려면 인스턴스를 그룹화하고 재사용 가능한 패키지 로 변환합니다.패키지는 전체 세계 빌드 프로세스를 더 빠르고 인체공학적으로 만들지만, 일관성, 제거, 공동 작업 및 버전 관리에도 도움이 됩니다.

• 쉽게 패키지의 모든 복사본을 최신 버전으로(또는 특정 복사본만) 업데이트할 수 있습니다(update all copies 또는 specific updates).
• 패키지를 자동으로 업데이트 하도록 설정하여 새 버전이 있을 때마다 업데이트합니다.
• 공동 작업자에게 패키지의 콘텐츠에 대한 편집 또는 사용 권한을 부여합니다.
• 패키지의 전체 버전 기록을 보고, 버전을 비교하고, 이전 버전을 복원합니다.

가장 효율적인 워크플로는 패키지를 생성하고, 공동 작업자와 공유하고, 자동으로 업데이트로 설정하는 것입니다.그리고 패키지에서 사용하기 전에 모델이 "완료"되기를 기다릴 필요가 없습니다.패키지가 단순한 모양 위에 플레이스홀더인 경우에도 환경을 회색 상자로 만들고 자세한 버전을 게시할 때 플레이스홀더 복사본이 자동으로 업데이트되도록 사용할 수 있습니다.

패키지 생성

단일 개체나 단일 부모 및 자식 개체 분기에서 패키지를 생성할 수 있습니다.단일 개체에 대한 패키지를 생성하려는 경우, 패키지를 나중에 패키지를 부수지 않고 인스턴스를 추가, 제거 또는 확장할 수 있도록 먼저 Model에 추가하는 것이 좋습니다.

1. 탐색기 창이나 3D 뷰포트에서 원하는 개체를 마우스 오른쪽 버튼으로 클릭하고 패키지로 변환 을 선택합니다.

2. 새 창에서 패키지 세부 정보를 채우십시오.특히, 그룹 에서 작업하는 경우, 그룹 경험을 생성하거나 편집할 수 있는 적절한 그룹에 소유권 을 설정하십시오.

   소유권 이전은 자산 시스템에서 지원되지 않으므로 패키지를 생성할 때 주의 깊게 소유자를 고려하십시오.

3. 클릭 제출 .

4. 변환이 완료되면 개체는 탐색기 창에서 패키지로 식별하기 위한 "체인 연결" 기호를 받습니다.또한 개체에 부모로 지정된 새로운 패키지 링크 개체를 볼 수 있습니다.

   

5. (옵션) 패키지링크 개체를 선택하고 속성 창에서 활성화를 활성화하십시오.패키지가 자동으로 업데이트되도록 설정되었음을 나타내기 위해 아이콘이 어떻게 변경되는지 참고하십시오.

   

패키지 삽입

현재 플레이스이미 존재하지 않는 패키지를 삽입하려면 먼저 도구 상자에서 삽입해야 합니다.

• 크리에이터 스토어에서 게시하거나 획득한 패키지에서 인벤토리 > 내 패키지 및 친구가 소유하고 사용 권한을 부여한 패키지에서 권한을 사용하도록 허용한 패키지로, 크리에이터 스토어에서 게시하거나 획득한 패키지에서 권한을 사용할 수 있습니다.
• 그룹의 멤버인 크리에이션 에서 그룹 패키지 로 패키지를 게시하는 멤버의 그룹에서 그룹 패키지 (자신을 포함).

>

>

패키지를 게시된 플레이스데이터 모델에 삽입한 후에는 자산 관리자에 나타나고 나중에 모든 복사본을 삭제해도 여전히 거기에 유지됩니다.

패키지 변경 사항 게시

패키지에 적용한 변경 사항을 새 버전으로 게시하여 장소 전체와 모든 경험에서 패키지의 다른 복사본에 사용할 수 있도록 할 수 있습니다.장소를 게시하기 전에 수정된 패키지를 게시하는 것은 필요하지 않습니다 (수정된 버전은 향후 반복을 위해 장소와 함께 저장됩니다).

패키지에 변경 사항을 게시하려면:

1. 탐색기 창이나 3D 뷰포트에서 수정된 복사본을 마우스 오른쪽 버튼으로 클릭하고 패키지에 게시 를 선택합니다.

2. 패키지 복사본에 자동 업데이트가 켜져 있으면, 그들을 포함하는 장소를 열 때 즉시 업데이트된 버전을 가져옵니다.다른 복사본은 업데이트가 사용 가능하다는 패키지 아이콘에 흰색 점이 표시됩니다.필요에 따라 개별적으로 업데이트하거나 마스 업데이트를 수행할 수 있습니다.

   

3. (옵션) 변경 사항의 설명 추가:

   1. 패키지를 마우스 오른쪽 버튼으로 클릭하고 패키지 세부 정보 를 선택합니다.
   2. 자산 구성 창에서 버전 을 선택합니다.
   3. 가장 최근의 변경에서 추가 를 선택합니다.
   4. 변경 사항을 설명하고 제출 을 클릭하십시오.

업데이트된 복사본 업데이트

오래된 패키지 복사본을 최신 버전으로 업데이트하거나 이전 버전을 계속 사용할 수 있습니다.

하나 이상의 패키지 복사본을 최신 버전으로 업데이트하려면:

1. 탐색기 창에서 패키지 아이콘의 흰색 점으로 업데이트되지 않은 복사본을 찾으십시오.3D 뷰포트에서 오래된 복사본을 선택할 수도 있지만, 이 방법을 찾기가 어려울 수 있습니다.

   

2. 오래된 복사본을 마우스 오른쪽 버튼으로 클릭하고 최신 패키지 가져오기 를 선택합니다.여러 패키지를 선택하고, 오른쪽 클릭하고, 선택한 패키지에 대한 최신 버전 가져오기 를 수행할 수도 있습니다.

대규모 업데이트

패키지의 광범위한 사용으로 인해 경험의 여러 장소에서 많은 패키지 복사본이 생성될 수 있습니다.개별 동기화 및 자동 업데이트와 더불어 마스 업데이트를 통해 패키지의 모든 복사본을 업데이트할 수 있습니다.

1. (권장) 경험의 장소 중 하나를 열어 다른 Studio 인스턴스를 닫으십시오; 이렇게 하면 장소의 다른 저장되지 않은 인스턴스가 업데이트를 덮어쓸 수 있는 것을 방지합니다.

2. 탐색기 창이나 3D 뷰포트에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 모두 업데이트를 선택합니다.

3. 경험의 모든 장소나 일부 장소 집합을 선택하고 업데이트 를 클릭하십시오.

   

   의도하지 않은 덮어쓰기를 방지하기 위해 대규모 업데이트는 패키지의 수정된 버전에 영향을 주지 않습니다.대규모 업데이트가 완료되면 Studio는 패키지 수가 업데이트되지 않은 경우 경고를 표시합니다(있는 경우). 업데이트하지 않은 패키지 수 .

자동 업데이트

동기화를 더 쉽게 만들려면 새로운 버전이 게시될 때마다 자동으로 업데이트되도록 패키지 복사본을 설정할 수 있습니다.패키지 복사본의 자동 업데이트는 Studio에서 장소가 열릴 때 발생합니다.

1. 탐색기 창에서 패키지의 계층 트리를 확장하고 패키지링크 개체를 선택합니다.

   

2. 속성 창 에서 자동 업데이트 속성을 활성화합니다.중첩된 패키지가 있는 경우 이 속성은 최상위 부모 패키지에만 적용되므로 자동 업데이트는 부모 패키지 가 업데이트될 때만 발생합니다.

공유 및 액세스 레벨

원하는 경우 패키지를 친구와 공유하거나 그룹 내에서 특정 사용자 역할에 액세스를 부여할 수 있습니다.

1. 탐색기 창에서 도구 상자, 또는 자산 관리자에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 패키지 세부 정보를 선택합니다.

2. 자산 구성 창에서 권한을 선택합니다.

   • 그룹 소유 패키지의 경우 역할 트리를 확장합니다 .그런 다음 각 역할에 대한 권한 레벨을 선택합니다.비활성화된 선택 상자는 권한이 이미 구성되었음을 나타내며 이 창에서 변경할 수 없습니다.

     

     권한	설명
     편집	역할의 멤버는 현재 및 이전 패키지 버전을 사용하고, 보고 및 편집하며, 게시 변경 사항을 포함하여 변경 사항을 게시할 수 있습니다.이 창에서 역할에 편집 액세스를 부여하면 특정 패키지에만 액세스할 수 있습니다 특정 패키지 .
     액세스 불가능	역할의 멤버는 패키지의 새 버전에 액세스할 수 없지만 장소에 삽입된 현재 버전에 액세스할 수는 있습니다.

   • 사용자 소유 패키지의 경우 검색 필드를 통해 친구를 검색하고, 사용자 이름을 클릭하고, 권한 레벨을 선택하십시오.

     권한	설명
     사용 및 보기	사용자는 현재 및 이전 패키지 버전을 사용하고 볼 수 있지만 편집할 수는 없습니다.사용자에게 이 기능을 제공하면 이미 경험에 삽입한 복사본에 대한 액세스를 취소할 수 없으며, 액세스를 취소하면 재삽입이나 패키지 업데이트가 방지되지만 데이터 모델의 패키지 복사본은 그대로 유지됩니다.
     편집	사용자는 현재 및 이전 패키지 버전을 사용하고, 보고 및 편집하며, 변경 사항을 게시할 수 있습니다.

패키지 수정

패키지와 패키지의 자식은 다른 개체와 마찬가지로 편집할 수 있습니다. 패키지를 수정하면 변경 사항을 게시하거나 되돌릴 때까지 자동 업데이트가 비활성화됩니다.

대부분의 편집은 패키지를 수정한 것으로 표시하지만 다음 변경은 패키지 수정으로 간주되지 않습니다 :

• 루트 노드의 이름 변경 .
• 패키지의 루트 노드의 위치 또는 회전 을 변경하는 것은 패키지의 BasePart, Model 또는 GuiObject입니다.
• 루트 노드의 활성화 속성을 변경하여 예를 들어 GuiObject , ScreenGui 또는 SurfaceGui 또는 BillboardGui .
• 패키지 외부의 인스턴스를 참조하는 패키지 내의 부품 참조를 변경하는 Weld 내부 패키지 참조

수정된 후에는 게시되지 않은 변경 사항이 있는 패키지가 탐색기 창에서 수정된 아이콘을 얻습니다.

구성 추가 또는 업데이트

예를 들어 패키지의 최대 속도 또는 패키지된 버튼의 디바운스 시간을 사용자 지정하기 위해 패키지 루트에 인스턴스 특성을 포함할 수 있습니다.

패키지를 게시하면 현재 특성/값 집합이 패키지의 기본 구성 이 됩니다.패키지의 어떤 복사본에서든 구성은 굵은 이탈릭으로 표시되고 이러한 특성 값은 인스턴스 기반으로 변경할 수 있습니다.패키지 복사본이 업데이트되면 수정된 구성 값이 유지되고, 다른 특성은 최신 기본값으로 업데이트됩니다.

중첩된 패키지

차량의 부모 패키지와 독립적으로 수정할 수 있는 차량 메커니즘의 시리즈와 같은 복잡한 계층을 유지하고 공동 작업하려면 다른 패키지 내에 패키지를 중첩할 수 있습니다.이 예제에서는 동일한 바퀴 패키지의 4개 복사본이 포함된 자동차 패키지를 보여줍니다:

패키지 스크립트

수정되지 않은 패키지 내의 각 스크립트는 읽기 전용이며 스크립트를 잠금 해제하기 위한 하이퍼링크가 있는 상단에 알림을 표시합니다.

하이퍼링크 클릭:

• 스크립트를 편집하는지 여부에 관계없이 패키지를 수정한 것으로 표시합니다.
• 패키지 내의 다른 스크립트에서 알림/하이퍼링크를 제거합니다. 패키지가 게시되고 수정되지 않은 상태로 이동되면 패키지 아래의 스크립트가 수정할 수 있는 하이퍼링크로 읽기 전용이 됩니다.

패키지 변경 사항 되돌리기

전체 패키지 변경 시리즈를 하나씩 취소하는 대신, 한 번의 액션게시되지 않은 변경 사항을 되돌리거나, 이전의 버전으로 패키지를 복원하거나, 특정 구성에 변경 사항을 되돌릴 수 있습니다.

게시되지 않은 변경 사항 되돌리기

전체 시리즈의 게시되지 않은 변경 사항을 취소하려면:

1. 탐색기 창에서 명칭 옆에 있는 느낌표로 수정된 복사본을 찾으십시오.3D 뷰포트에서 수정된 복사본을 선택하는 것도 더 쉬울 수 있습니다.

2. 단일 수정된 복사본을 마우스 오른쪽 버튼으로 클릭하고 패키지 변경 취소 를 선택하거나, 여러 복사본(적어도 하나는 수정됨)을 마우스 오른쪽 버튼으로 클릭하고 선택한 패키지 변경 취소 를 선택합니다.

버전으로 복원

패키지를 이전에 게시된 버전으로 복원하려면 :

1. 탐색기 창에서 3D 뷰포트 , 도구 상자 , 또는 자산 관리자 에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 패키지 세부 정보 를 선택합니다.

2. 자산 구성 창에서 버전을 선택합니다.창에는 게시 날짜와 시간, 변경 사항 설명을 포함하여 각 게시된 버전에 대한 세부 정보가 표시됩니다.

3. 복원하려는 버전 옆에 있는 확인란을 클릭하고 제출 을 클릭하십시오.

   

구성 되돌리기

모든 구성 특성을 기본값으로 되돌리려면 재설정 옵션을 속성 창의 속성 섹션에서 장비 메뉴에서 선택하십시오.

패키지 버전 비교

패키지에 여러 버전이 있는 경우 패키지 업데이트를 검토하고, 로컬 변경 사항을 최신 버전과 비교하고, 복원하기 전에 과거 버전의 콘텐츠를 확인하는 데 도움이 되는 차이 보기를 사용하여 버전 간의 변경을 비교할 수 있습니다.

도구에는 해당 아이콘을 사용하여 버전 간에 추가, 제거 또는 수정된 모든 인스턴스를 나타내는 패키지 계층 메뉴와 다음 탭이 사용 가능합니다.

• 시각 개요 에서는 다양한 카메라 위치에서 3D 렌더링의 시각적 차이를 보여줍니다.3D 개체(모델, 부품)가 루트 개체로 있는 패키지의 기본 보기이며, 현재는 루트 개체에만 사용할 수 있습니다.

  

• 속성 은 속성과 특성의 변경 사항을 표시합니다.루트 개체로 3D가 아닌 개체(스크립트, 조명, 2D 개체)가 있는 패키지의 기본 보기이며 패키지의 모든 인스턴스에서 사용할 수 있습니다.

  

• 스크립트 는 줄별 스크립트 차이를 보여줍니다.스크립트가 루트 개체인지 여부에 관계없이 스크립트가 포함된 패키지에서 사용할 수 있습니다.

  

패키지 버전을 비교하려면:

1. 탐색기 창이나 3D 뷰포트에서 대상 패키지를 마우스 오른쪽 버튼으로 클릭하고 패키지 버전 비교 를 선택합니다.

2. 기본적으로 창은 로컬 복사본과 최신 버전 간의 변경 사항을 비교합니다. 두 개의 드롭다운 메뉴를 사용하여 다른 버전을 비교하십시오.

   

   일부 이전 버전은 패키지 차이 도구와 호환되지 않을 수 있습니다.

3. 버전을 선택한 후:

   • 루트 모델의 시각적 렌더링을 비교하려면, 적용 해당경우 시각 개요 탭을 선택하고 원하는 각도에 대한 카메라 제어를 조정하십시오.컨트롤은 뷰 간에 동기화됩니다:

     • 왼쪽 마우스 클릭을 사용하여 카메라를 회전합니다.
     • 오른쪽 마우스 클릭을 사용하여 카메라를 회전합니다.
     • 마우스 휠로 카메라를 확대하고 축소합니다.
     • 키보드 단축키를 사용하여 다시 중앙화합니다 -F.

   • 인스턴스의 속성과 특성을 비교하려면 인스턴스와 속성 탭을 선택하십시오.

   • 스크립트 차이를 비교하려면, 적용 해당경우, 선택한 버전 간의 줄 단위 변경을 위해 스크립트 탭을 열기 위한 모든 스크립트를 선택하십시오, 소스 제어 응용 프로그램과 유사합니다.

     이 도구는 변경 내용을 표시하지 않고 현재 버전과 최신 게시 또는 로컬 버전 사이에서 스크립트 변경을 비교할 수만 있습니다. This tool only allows you to compare script changes between the current version and the latest published or local version, without indicating the collaborators who made the change.

또는 스크립트 차이 도구를 직접 열 수도 있습니다:

1. 탐색기 창 또는 3D 뷰포트에서 대상 패키지를 마우스 오른쪽 버튼으로 클릭하여 스크립트이거나 스크립트가 포함된 패키지여야 하고 스크립트 변경 보기를 선택합니다.
2. 열린 차이 탭에서 선택한 스크립트의 모든 변경을 현재 패키지 복사본과 최신 게시된 또는 로컬 버전 사이에서 비교합니다.