패키지

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.


자산을 팀이나 여러 프로젝트 간에 구성하고 재사용할 수 있도록 인스턴스를 그룹화하고 재사용 가능한 패키지 로 변환합니다. 패키지는 전체 프로세스를 더 빠르고 더 이상적으로 만들지만, 일관성, 중복, 공동 작업 및 버전 관리를 도울 수도 있습니다.

가장 효율적인 워크플로우는 패키지를 만드는 것입니다. 패키지를 공유하는 것은 모든 공동 작업자와, 그것을 자동으로 업데이트하도록 설정하는 것입니다. 패키지를 사용하는 것이 패키지를 복

패키지 생성

개별 개체 또는 개별 부모 및 자식 분기의 개체에서 패키지를 만들 수 있습니다. 단일 개체에 대해 패키지를 생성하려면 먼저 Model하여 패키지에 제거나중에 패키지를 손쉽게 액세스할 수 있습니다.

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

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. 새 창에서 패키지 세부 정보를 채우십시오. 특히, 그룹에서 작업하는 경우 소유권을 적절한 그룹으로 설정하여 그룹 경험을 생성/편집할 수 있는 권한을 부여합니다.

  3. 클릭 하십시오 제출하기 .

  4. 변환이 완료되면 개체에 탐색기 창에 있는 "체인 연결" 기호가 표시되어 패키지로 식별됩니다. 또한 개체에 대한 새로운 패키지Link 개체를 볼 수 있습니다.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (옵션) PackageLink 개체를 선택하고 AutoUpdate를 속성 창에서 활성화하십시오. 패키지가 자동으로 업데이트되도록 설정된 경우 아이콘이 변경되어 업데이트를 나타냅니다.

    A maple tree model in the Explorer window with the auto-update package icon next to it.

패키지 삽입

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

  • 크리에이터 스토어에서 게시하거나 얻은 패키지를 위한 내 패키지로 이동하고, 친구가 소유하고 있으며 사용자에게 권한을 부여하는 패키지를 위해 내 패키지로 이동합니다.
  • 그룹 팩 게시자의 패키지(예: 자신)를 위한 전용 크리처 패키지 그룹 패키지에서 이동합니다.
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
도구 상자 → 인벤토리 → 내 패키지
A close up view of the Toolbox with the Creations tab highlighted.
도구 상자 → 생성 → 그룹 패키지

플레이스데이터 모델에 패키지를 삽입한 후 Packages 폴더에 나타나며 자산 관리자의 모든 복사본을 삭제한 후에도 유지됩니다. 그러나 플레이스게시할 때 폴더가 업데이트되어 자산 관리자의 모든 복사본만 반영됩니다.

The Asset Manager window with a few example packages.
자산 관리자의 패키지

패키지 변경 사항 게시

패키지에 적용하는 변경 사항을 새 버전으로 게시하여 장소와 모든 경험에 대해 패키지의 다른 복사본에 사용할 수 있습니다. 패키지를 게시하기 전에 수정된 패키지를 게시하는 것이 좋습니다( 이전 버전 이 장소와 모든 경험에 저장되어 있습니다).

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

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

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. 패키지 복사본에 자동 업데이트가 켜져 있으면 해당 장소를 열 때마다 업데이트된 버전을 즉시 가져옵니다. 다른 복사본은 패키지 아이콘에 백점을 표시하여 업데이트가 가능하다는 것을 나타냅니다. 필요에 따라 개별적으로 업데이트 또는 대량

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (옵션) 변경 사항에 대한 설명 추가:

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

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

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

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

  1. In the 탐색기 창에서, package 아이콘화이트 도트로 업데이트되지 않은 복사본을 찾습니다. 3D 뷰포트에서 업데이트되지 않은 복사본을 선택할 수도 있지만, 이 방법은 더 어려울 수 있습니다.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. 오래된 복사본을 마우스 오른쪽 버튼으로 클릭하고 최신 패키지 받기 를 선택합니다. 여러 패키지, 마우스 오른쪽 버튼 및 선택한 패키지에 대해 최신 패키지 받기 를 선택할 수도 있습니다.

대량 업데이트

패키지 사용을 확장하면 경험의 여러 장소에 대해 많은 패키지 복사본이 생성될 수 있습니다. 개별 동기화 및 자동 업데이트 외에도 마이그레이션 마이그레이션 및 자동 업데이트를 통해 모든 패키지 복사본을 업데이트할 수 있습니다.

  1. (권장) 경험의 장소가 열려있는 다른 Studio 인스턴스를 닫으십시오; 이렇게 하면 장소의 다른 미저장 인스턴스가 귀하의 업데이트를 덮어씁니다.

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

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

    A view of the mass update window, showing two places.

    의도적인 오버런을 방지하기 위해 대량 업데이트는 패키지의 변경된 버전에 영향을 주지 않습니다. 대량 업데이트가 완료되면 Studio에서 경고를 표시하고, 업데이트하지 않은 패키지의 수를 표시합니다(如果有).

자동 업데이트

동기화를 더 쉽게 하려면 패키지 복사본을 업데이트할 때마다 자동으로 업데이트할 수 있습니다. 패키지 복사본 자동 업데이트는 Studio에서 장소를 열 때 수행됩니다.

  1. 탐색기 창에서 패키지의 계층 구조를 확장하고 패키지 연결 개체를 선택합니다.In the Explorer window, expand the package's hierarchy tree and select its PackageLink object.

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. In the 속성 window, enable the 자동 업데이트 property. If you have 압도 패키지 , this property only applies to the highest-level parent package, meaning automatic updates only occur when the 1>부모1> package is updated.

공유 및 액세스 수준

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

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

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

    • 그룹 소유 패키지의 경우 역할 트리를 확장한 다음 각 역할에 대한 권한 수준을 선택합니다. 권한이 이미 구성되었음을 나타내는 선택 상자가 비활성화되어 있습니다.

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      권한설명
      편집하기 역할 구성원은 현재 및 이전 패키지 버전을 사용, 보고 편집할 수 있으며, 변경 사항을 게시하는 등의 편집 액세스를 부여하는 역할에 대한 액세스만 부여됩니다. 이 창에서 역할에 대한 편집 액세스를 부여하는 경우에만 특정 패키지 에 액세스할 수 있습니다.
      액세스 불가 역할의 구성원은 장소에 삽입된 현재 버전에 액세스할 수 없지만, 장소에 삽입된 새 버전에는 액세스할 수 있습니다.
    • 사용자 소유 패키지의 경우 검색 필드에서 친구를 검색하고, 사용자 이름을 클릭하고, 권한 레벨선택하십시오.

      권한설명
      사용 및 보기 사용자는 현재 및 이전 패키지 버전을 사용하고 보고 수정할 수 없습니다(하지만 사용자에게 이 기능을 제공하면 경험에 삽입한 복사본에 대한 액세스를 다시 부여할 수 없습니다). 사용자에게 이 기능을 제공하면 복사본을 다시 삽입하거나 패키지 업데이트를 재개할 수 없지만, 데이터 모델의 복사
      편집하기 사용자는 변경 내용을 게시하여 현재 및 이전 패키지 버전을 사용, 보고 편집할 수 있습니다.

패키지 수정

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

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

대부분의 편집은 패키지를 수정된 패키지로 표시하지만 다음과 같은 변경 내용은 패키지 수정 으로 간주되지 않습니다.

  • 루트 노드의 이름 을 변경합니다.
  • Class.BasePart 패키지의 루트 노드 위치 또는 회전을 변경하는 경우 Class.GuiObject 또는 BasePart 또는 1>Class.GuiObject1> 입니다.
  • Class.GuiObject 또는 Class.ScreenGui 또는 1>Class.SurfaceGui1> 또는 4>Class.BillboardGui4>와 같은 루트 노드의 0>활성화된 0> 속성을 변경하는 경우.
  • 패키지 외부의 인스턴스에 대한 참조를 포함하는 내 Weld 의 부분 참조를 변경하는 경우.

게시되지 않은 변경 내용을 가진 패키지는 탐색기 창에 수정된 아이콘을 가집니다.

The Explorer window with an icon that identifies unpublished package changes.

구성 추가 또는 업데이트

패키지의 뿌리에 인스턴스 특성을 포함하여 패키지의 동작을 사용자 정의, 예를 들어 배포된 차량의 최대 속도 또는 배포된 버튼의 대기 시간.

패키지를 게시하면 현재 속성/값 집합이 패키지의 기본 구성 이 됩니다. 패키지의 모든 복사본에 대해 구성은 강조 글자 로 표시되며, 이 속성 값은 인스턴스별로 변경할 수 있습니다. 패키지 복사본이 업데이트되면 변경된 구성

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

중첩된 패키지

다른 패키지 내에 패키지를 중첩하여 복잡한 계층을 유지하고 공동 작업할 수 있습니다. 여기에는 차량 메커닉 시리즈와 같은 복잡한 계층을 수정하고 부모 패키지를 통해 공동 작업할 수 있는 자동차 패키지가 포함됩니다. 이 예에서는 차량 패키지에 4개의 차량 휠 패키지를 수정한 복사본이 포

An expanded hierarchy in the Explorer window showing how packages can contain packages.

패키지 스크립트

변경되지 않은 패키지 내의 각 스크립트는 읽기 전용이며 스크립트 잠금을 해제하려는 하이퍼링크가 표시됩니다.

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

하이퍼링크 클릭:

  • 스크립트를 편집하든 패키지를 수정한 것으로 플래그를 설정합니다.
  • 제거 알림/하이퍼링크 다른 스크립트 내에서 other 패키지의 스크립트.

패키지가 게시되고 변경되지 않은 상태로 이동하면 해당 하이퍼링크를 통해 스크립트를 읽기 전용으로 만듭니다.

패키지 변경 사항 되돌리기

전체 패키지 변경 내용을 하나씩 실행하는 대신 단일 액션미게시된 변경 내용을 되돌릴 수 있습니다.패키지를 이전 버전으로 복원하거나 특정 2>구성2>으로 변경 내용을 되돌릴 수 있습니다.2>

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

전체 연속의 변경 사항을 되돌리려면:

  1. 탐색기 창에서 이름 옆에 있는 제한 점에 의해 수정된 복사본을 찾습니다. 3D 뷰포트에서 수정된 복사본을 선택하는 것도 좋습니다.

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

버전으로 복원

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

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

  2. 자산 구성 창에서 버전 을 선택합니다. 창은 게시된 각 버전에 대한 세부 정보를 표시하며, 변경 내용에 대한 모든 설명을 포함하여 게시 날짜와 시간을 포함합니다.

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

    The pop-up window for a chandelier asset. It displays multiple versions.

구성 변경 취소

모든 구성 특성을 기본으로 되돌리려면 장비 메뉴의 초기화 옵션을 선택하십시오. 속성 섹션의 초기화 옵션을 선택하십시오.

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

패키지 버전 비교

패키지에 여러 버전이 있으면 차이를 비교하기 위해 버전 관리자를 사용하여 버전 간의 변경 사항을 비교할 수 있습니다. 이 도구는 패키지 업데이트를 검토하고, 로컬 변경 사항을 최신 버전과 비교하고, 복원하기 전에 이전 버전의 콘텐츠를 확인할 수 있습니다.

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

  • 시각적 개요 는 다양한 카메라 위치에서 3D 렌더링의 시각적 차이를 보여줍니다. 이것은 3D 개체(모델, 부품)가 기본 개체(루트 개체)로 있을 때의 시각적 차이입니다. 현재 이 시각적 개요는 루트 개체에만 해당됩니다.

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • 속성 은 속성 및 특성의 변경 내용을 표시합니다. 이 는 3D 개체가 아닌 개체(스크립트, 조명, 2D 개체)가 기본 개체인 경우 속성 및 특성의 변경 내용을 표시하는 기본 보기입니다. 이 개체는 모든 인스턴스에 대해 사용할 수 있습니다.

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • 스크립트 는 스크립트 변경 내용을 줄 별로 표시합니다. 스크립트가 루트 개체인지 여부에 관계없이 스크립트 패키지에 사용할 수 있습니다.

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

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

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

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

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. 버전을 선택한 후:

    • 루트 모델의 시각적 렌더링을 비교하려면, 적용할 수 있으면, 시각적 개요 탭을 선택하고 카메라 컨트롤을 조정하여 원하는 각도를 조정하십시오. 컨트롤은 뷰 간에 동기화됩니다.

      • 왼쪽 마우스 클릭으로 카메라를 팬.
      • 오른쪽 마우스 클릭으로 카메라를 회전합니다.
      • 마우스 휠로 카메라를 확대하고 축소합니다.
      • 키보드 단축키를 사용하여 다시 센터화하십시오 -F.
    • 인스턴스의 속성 및 특성을 비교하려면 인스턴스 및 속성 탭을 선택합니다.

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

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

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