패키지

자산을 정리하고 팀 또는 여러 프로젝트에서 재사용할 수 있도록 하려면 인스턴스를 그룹화하고 이를 재사용 가능한 패키지로 변환할 수 있습니다. 패키지는 세계를 구축하는 전체 프로세스를 더 빠르고 인체공학적으로 만들 뿐만 아니라 일관성, 중복 제거, 협업 및 버전 관리에도 도움이 됩니다:

• 패키지의 모든 복사본을 최신 버전으로 쉽게 업데이트하거나 특정 복사본만 업데이트할 수 있습니다.
• 새 버전이 있을 때마다 패키지를 자동으로 업데이트하도록 설정할 수 있습니다.
• 협업자에게 패키지의 내용에 대한 편집 또는 사용 권한을 부여할 수 있습니다.
• 패키지의 전체 버전 기록을 보고, 버전을 비교하고, 이전 버전을 복원할 수 있습니다.

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

패키지 만들기

단일 객체 또는 객체의 단일 부모 및 자식 브랜치에서 패키지를 만들 수 있습니다. 단일 객체에 대한 패키지를 만들고 싶다면, 나중에 패키지 내에서 자식 객체를 추가, 제거 또는 크기를 조정할 수 있도록 먼저 Model 그룹에 추가해야 합니다.

패키지를 만들려면:

1. 탐색기 창 또는 3D 뷰포트에서 패키지로 변환할 객체를 마우스 오른쪽 버튼으로 클릭하고, 컨텍스트 메뉴에서 패키지로 변환을 선택합니다.

2. 새 창에서 패키지 세부정보를 입력합니다. 특히, 그룹에서 작업 중인 경우, 소유권을 해당 그룹으로 설정해야 합니다.

   소유권 이전은 자산 시스템에서 지원되지 않으므로, 패키지를 만들 때 소유자를 신중하게 고려해야 합니다.

3. 제출을 클릭합니다.

4. 변환이 완료되면, 객체는 탐색기 창에서 패키지로 식별하기 위해 "체인 링크" 기호를 받습니다. 또한, 객체에 부모로 PackageLink 객체가 새로 생성됩니다.

   

5. 선택 사항

   PackageLink 객체를 선택하고 속성 창에서 AutoUpdate를 활성화합니다. 패키지가 자동 업데이트로 설정되었음을 나타내기 위해 아이콘이 변경되는 것을 주목하세요.

패키지 삽입

현재 장소에 존재하지 않는 패키지를 삽입하려면, 처음에 툴박스에서 삽입해야 합니다:

• 인벤토리 ⟩ 내 패키지에서, 당신이 게시했거나 크리에이터 스토어에서 얻은 패키지, 친구가 소유하고 사용 권한을 부여한 패키지.
• 창작물 ⟩ 그룹 패키지에서, 당신의 그룹 구성원이 게시한 패키지(자신 포함).

게시된 장소의 데이터 모델에 패키지를 삽입하면, 자산 관리자에 나타나며, 나중에 모든 복사본을 삭제하더라도 그곳에 남아 있습니다.

패키지 수정

패키지와 그 자식은 다른 객체처럼 편집할 수 있습니다. 패키지를 수정하면 자동 업데이트가 비활성화되며, 변경 사항을 게시하거나 되돌리기 전까지 유지됩니다.

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

• 루트 노드의 이름 변경.
• BasePart, Model 또는 GuiObject인 패키지의 루트 노드의 위치 또는 회전 변경.
• ScreenGui, SurfaceGui 또는 BillboardGui와 같은 루트 노드 GuiObject의 Enabled 속성 변경.
• 패키지 내에서 패키지 외부의 인스턴스를 참조하는 Weld의 부품 참조 변경.

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

구성 추가 또는 업데이트

패키지의 루트에 인스턴스 속성을 포함하여 동작을 사용자 정의할 수 있습니다. 패키지를 게시하면 현재 속성/값 세트가 패키지의 기본 구성이 됩니다. 특정 패키지의 복사본에서 이러한 속성 값을 인스턴스별로 변경할 수 있으며, 변경된 사항은 굵은 이탤릭체로 표시됩니다. 패키지 복사본이 업데이트되면, 수정된 구성 값은 보존되며, 다른 속성은 최신 기본 값으로 업데이트됩니다.

중첩 패키지

복잡한 계층 구조를 유지하고 협업하기 위해 다른 패키지 내에 패키지를 중첩할 수 있습니다. 예를 들어, 차량의 부모 패키지와 독립적으로 수정할 수 있는 일련의 차량 메커니즘을 포함할 수 있습니다.

중첩 패키지를 수정하면 중첩 패키지 및 부모 패키지가 수정된 것으로 간주됩니다. 부모 패키지에 대한 변경 사항을 게시하기 전에 중첩 패키지에 대한 변경 사항을 게시해야 합니다. 부모를 게시하면 현재/수정되지 않은 것으로 표시되며 중첩 패키지의 수정 사항과 충돌합니다.

패키지 스크립트

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

하이퍼링크를 클릭하면:

• 스크립트를 편집하든 아니든 패키지가 수정된 것으로 표시됩니다.
• 패키지 내의 다른 스크립트에서 알림/하이퍼링크가 제거됩니다.

패키지가 게시되고 수정되지 않은 상태로 이동하면, 그 아래의 스크립트는 읽기 전용이 되며 수정할 수 있는 하이퍼링크가 표시됩니다.

패키지 변경 사항 게시

패키지에 대한 모든 변경 사항을 새 버전으로 게시할 수 있으며, 이를 통해 업데이트를 장소 전역 및 모든 게임의 다른 패키지 복사본에서 사용할 수 있습니다. 수정된 패키지를 장소를 게시하기 전에 게시할 필요는 없습니다. 수정된 버전은 향후 반복을 위해 장소와 함께 저장됩니다.

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

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

2. 패키지 복사본에 자동 업데이트가 켜져 있으면, 해당 패키지를 포함하는 장소를 열 때 즉시 업데이트된 버전을 가져옵니다. 다른 복사본은 업데이트가 가능하다는 것을 나타내는 "다운로드" 기호를 받습니다. 복사본을 개별적으로 업데이트하거나 대량 업데이트할 수 있습니다.

   

3. 선택 사항

   변경 사항에 대한 설명을 추가합니다:

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

오래된 복사본 업데이트

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

1. 탐색기 창에서 "다운로드" 기호로 오래된 복사본을 찾습니다. 3D 뷰포트에서 오래된 복사본을 선택할 수도 있습니다.

   

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

대량 업데이트

패키지를 광범위하게 사용하면 게임의 여러 장소에 많은 패키지 복사본이 생성될 수 있습니다. 개별 동기화 및 자동 업데이트 외에도, 대량 업데이트를 통해 패키지의 모든 복사본을 업데이트할 수 있습니다.

1. 권장

   게임의 장소가 열려 있는 다른 스튜디오 인스턴스를 닫습니다. 이렇게 하면 다른 저장되지 않은 장소 인스턴스가 업데이트를 덮어쓰는 것을 방지할 수 있습니다.
2. 탐색기 창 또는 3D 뷰포트에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 모두 업데이트를 선택합니다.
3. 게임의 모든 장소 또는 일부 장소를 선택하고 업데이트를 클릭합니다.

자동 업데이트

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

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

   

2. 속성 창에서 AutoUpdate 속성을 활성화합니다. 중첩 패키지가 있는 경우, 이 속성은 가장 높은 수준의 부모 패키지에만 적용되며, 자동 업데이트는 부모 패키지가 업데이트될 때만 발생합니다.

공유 및 접근 수준

친구, 게임, 그룹 또는 특정 그룹 사용자 역할에 대해 패키지를 자유롭게 사용할 수 있는 권한을 부여할 수 있습니다. 자산 접근에 대한 자세한 내용은 자산 개인 정보를 참조하세요.

협업자(예: 친구 또는 그룹)에 대한 패키지 권한을 변경하려면:

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

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

3. 검색창에 패키지를 사용할 수 있는 권한을 부여할 협업자를 입력하고 선택한 후, 권한 수준을 선택합니다.

   권한	설명
   사용 및 보기	협업자는 현재 및 이전 패키지 버전을 사용할 수 있으며 볼 수 있지만 편집할 수는 없습니다. 협업자에게 이 능력을 부여하면, 그들이 이미 게임에 삽입한 복사본에 대한 접근을 철회할 수 없습니다. 접근을 철회하면 재삽입이나 패키지 업데이트가 방지되지만, 그들의 데이터 모델에 있는 패키지 복사본은 그대로 유지됩니다.
   편집	협업자는 현재 및 이전 패키지 버전을 사용할 수 있으며 볼 수 있고 편집할 수 있으며, 변경 사항을 게시할 수 있습니다.

패키지 변경 사항 되돌리기

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

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

전체 게시되지 않은 변경 사항 시리즈를 되돌리려면:

1. 탐색기 창에서 패키지 아이콘의 점으로 수정된 복사본을 찾습니다. 3D 뷰포트에서 수정된 복사본을 선택할 수도 있습니다.

   

2. 수정된 복사본을 마우스 오른쪽 버튼으로 클릭하고 패키지 변경 사항 되돌리기를 선택하거나, 여러 복사본(그 중 하나 이상이 수정됨)을 선택하고 마우스 오른쪽 버튼을 클릭하여 선택한 패키지의 변경 사항 되돌리기를 선택합니다.

게시된 버전으로 복원

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

1. 탐색기 창, 툴박스 또는 자산 관리자에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 패키지 옵션 ⟩ 패키지 세부정보를 선택합니다.
2. 자산 구성 창에서 버전을 선택합니다. 창에는 게시된 각 버전의 세부정보가 표시되며, 게시 날짜 및 시간과 변경 사항에 대한 설명이 포함됩니다.
3. 복원하려는 버전 옆의 체크마크를 클릭하고 제출을 클릭합니다.

구성 되돌리기

기본값으로 구성 속성을 되돌리려면, 속성 창의 속성 섹션에서 해당 속성의 옵션 메뉴에서 재설정을 선택합니다.

패키지 버전 비교

패키지에 여러 버전이 있는 경우, 차이 뷰어를 사용하여 버전 간의 변경 사항을 비교할 수 있습니다. 이 도구는 버전 간에 추가, 제거 또는 수정된 모든 인스턴스를 나타내는 패키지 계층 메뉴를 가지고 있으며, 다음과 같은 기능이 포함되어 있습니다:

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

• 속성은 속성과 속성의 변경 사항을 보여줍니다. 이는 루트 객체가 비-3D 객체(스크립트, 조명, 2D 객체)인 패키지의 기본 보기이며, 패키지의 모든 인스턴스에 대해 사용할 수 있습니다.

• 스크립트는 줄별 스크립트 차이를 보여줍니다. 이는 스크립트를 포함하는 패키지에 대해 사용할 수 있으며, 스크립트가 루트 객체인지 여부에 관계없이 사용할 수 있습니다.

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

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

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

   

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

3. 버전을 선택한 후:

   1. 루트 모델의 시각적 렌더링을 비교하려면, 해당하는 경우 시각적 개요 탭을 선택하고 원하는 각도에 맞게 카메라 제어를 조정합니다. 제어는 모든 보기에서 동기화됩니다:

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

   2. 인스턴스의 속성과 속성을 비교하려면 인스턴스를 선택하고 속성 탭을 선택합니다.

   3. 스크립트가 패키지인 경우 또는 스크립트를 포함하는 경우 스크립트 차이를 비교하려면 스크립트 탭을 사용합니다.

      이 도구는 현재 버전과 최신 게시된 또는 로컬 버전 간의 스크립트 변경 사항만 비교할 수 있으며, 변경을 수행한 협업자를 나타내지 않습니다.

      또는 탐색기 창이나 3D 뷰포트에서 대상 패키지를 마우스 오른쪽 버튼으로 클릭하고 스크립트 변경 사항 보기를 선택하여 스크립트 차이 도구를 직접 열 수 있습니다.