패키지

자산을 정리하고 팀 또는 여러 프로젝트 간에 재사용 가능하게 유지하려면 인스턴스를 그룹화하고 이를 재사용 가능한 패키지로 변환할 수 있습니다. 패키지는 월드 빌드 전반의 프로세스를 더 빠르고 편리하게 만들어 주며, 일관성, 중복 제거, 협업 및 버전 관리에도 도움이 됩니다:

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

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

패키지 생성

단일 객체 또는 단일 부모와 하위 객체의 브랜치를 통해 패키지를 생성할 수 있습니다. 단일 객체에 대한 패키지를 생성하려면 먼저 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 뷰포트에서 대상을 마우스 오른쪽 버튼으로 클릭하고 스크립트 변경 사항 보기를 선택하여 스크립트 차이 보기 도구를 직접 열 수 있습니다.