자산 관리자는 스튜디오의 창 메뉴 또는 홈 탭에서 액세스할 수 있으며, 장소를 관리하고 이미지, 메시, 패키지, 오디오, 모델을 포함하여 게임에 자산을 대량으로 가져올 수 있게 해줍니다.
현재
다음 섹션에서는 현재 자산 관리자에 대해 설명합니다. V2 베타에 대한 문서는 아래에 있습니다.
자산 폴더
자산은 유형에 따라 폴더로 구성됩니다. 보기 전환 버튼을 클릭하여 격자 보기와 목록 보기 간에 전환할 수 있습니다.
자산 가져오기
레거시 대량 가져오기 도구는 한 번에 최대 50개의 파일을 가져오는 데 이상적입니다. 가져온 자산은 승인 대기열에 들어가며, 해당하는 폴더 내와 툴박스의 인벤토리 탭에서만 볼 수 있습니다. 이 대량 가져오기 도구는 현재 자산 관리자 버전에서만 사용할 수 있습니다. 최신 자산 관리자 버전은 스튜디오 가져오기 도구를 사용합니다.
| 자산 유형 | 세부 사항 |
|---|---|
| 이미지 | 부품의 텍스처/데칼로 사용하거나, 이미지 레이블, 메시 텍스처, 사용자 정의 재료에 대한 텍스처, 특수 효과를 포함한 다양한 용도로 .png, .jpg, .gif, .tga, 또는 .bmp 형식의 이미지를 가져올 수 있습니다. |
| 메시 | fbx 또는 obj 형식의 메시를 대량으로 가져올 수 있지만, 이 작업 흐름은 리깅, 스키닝, 또는 애니메이션 데이터가 포함된 복잡한 메시를 지원하지 않습니다. 복잡한 메시의 경우 가져오기 도구를 사용하는 것이 좋습니다. |
| 오디오 | .ogg, .mp3, .flac, 또는 .wav 형식의 오디오 자산을 가져올 수 있으며, 해당 파일을 사용할 권한이 확실한 경우에만 가능합니다. 사용할 권한이 불확실한 오디오 파일의 경우, 제작자 상점에서는 100,000개 이상의 전문적으로 제작된 오디오 자산을 포함하여 무료로 사용할 수 있는 다양한 오디오 자산을 제공합니다. 자세한 내용은 오디오 자산을 참조하세요. |
자산 삽입
탐색기 창 계층 구조에 자산을 드래그 앤 드롭하거나 자산 이름/타일을 마우스 오른쪽 버튼으로 클릭하고 삽입을 선택하여 삽입할 수 있습니다.
3D 뷰포트에 드래그 앤 드롭 시 자산 유형에 따라 동작이 다릅니다:
| 자산 유형 | 드래그 앤 드롭 동작 |
|---|---|
| 이미지 | 유효한 상위 개체인 BasePart에 마우스를 올리면 해당 상위 개체의 내부에 새 Decal이 생성되며, ColorMapContent 속성이 자산 ID로 설정됩니다. |
| 메시 | 자산을 새 MeshPart로 작업 공간에 삽입하며, MeshId 속성이 자산 ID로 설정됩니다. |
| 오디오 | 자산을 새 Sound 객체로 작업 공간에 생성하며, SoundId 속성이 자산 ID로 설정됩니다. |
| 패키지 | 작업 공간에 패키지의 복사본을 삽입합니다. |
빠른 작업
빠른 작업은 자산 이름/타일을 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 옵션을 선택하여 액세스할 수 있습니다.
| 빠른 작업 | 설명 |
|---|---|
| 이름 바꾸기 | 장소의 새 이름을 입력할 수 있습니다. |
| ID 복사 클립보드에 | 장소 ID를 클립보드에 복사합니다. |
| 버전 기록 보기 | 장소의 버전 기록을 열어 이전 커밋(게시 작업) 및 날짜/시간을 볼 수 있습니다. 필요에 따라 이전 버전으로 롤백할 수 있으며, 이를 위해 선택하고 열기 버튼을 클릭하십시오. |
| 게임에서 제거 | 장소를 게임에서 완전히 제거합니다. 시작 장소에 적용되지 않습니다. |
자산 검사
격자 보기에서 자산의 썸네일 위에 마우스를 올리고 "확대" 아이콘을 클릭하거나, 목록 보기에서 자산 이름을 마우스 오른쪽 버튼으로 클릭하고 자산 미리보기를 선택하여 이미지, 메시, 패키지 또는 오디오 파일을 자세히 확인할 수 있습니다.
메시와 같은 3D 자산을 미리 볼 때는 가상 카메라를 움직여 모든 각도에서 더 좋은 뷰를 얻을 수 있습니다. 비디오의 경우 팝업에서 전체 비디오를 미리 볼 수 있습니다.
| 동작 | 설명 |
|---|---|
| 왼쪽 마우스 버튼 + 드래그 | 물체 주위로 회전합니다. |
| 오른쪽 마우스 버튼 + 드래그 | 왼쪽, 오른쪽, 위 또는 아래로 팬합니다. |
| 마우스 스크롤 휠 | 줌 인 또는 줌 아웃합니다. |
미리 보기 프레임의 오른쪽 하단 모서리에서 구성 버튼을 클릭하면 Scripts, MeshParts, Animations 등을 포함하여 자산의 전체 계층 구조를 확인할 수 있습니다.
V2 베타
인벤토리 정렬
자산은 창 왼쪽의 접이식 메뉴에서 선택된 다양한 인벤토리 기준으로 정렬됩니다. 정렬 목록이 보이지 않으면 창의 왼쪽 하단에 있는 확장/축소 버튼을 클릭하세요.
폴더
폴더를 사용하여 자산 및 기타 폴더를 인벤토리 내에서 계층 구조로 구성할 수 있습니다. 내 인벤토리 내, 폴더 작업을 지원하는 그룹 인벤토리 내, 및 프로젝트 아래의 열려있는 게임의 인벤토리에 폴더를 만들 수 있습니다.
폴더에는 다음과 같은 제한 사항이 있습니다:
- 계정당 또는 루트 인벤토리에 최대 50,000 폴더.
- 단일 폴더 또는 루트 인벤토리 내 최대 100 자식 폴더.
- 폴더당 최대 20,000 자산.
- 최대 20단계의 폴더 중첩.
계정에 대해 폴더가 초기화될 때 첫 번째에는 짧은 설정 기간이 적용될 수 있습니다. 폴더 작업이 아직 사용 가능하지 않으면 사이드바에 경고 아이콘이 표시됩니다. 이를 클릭하여 준비 상태를 새로 고칠 수 있습니다. 설정은 일반적으로 몇 분 안에 완료됩니다.
만들기, 이름 바꾸기 및 삭제
사이드바 또는 주요 보기에서 마우스 오른쪽 버튼을 클릭하여 폴더 작업에 액세스할 수 있습니다.
| 작업 | 설명 |
|---|---|
| 폴더 만들기 | 현재 위치에 새 빈 폴더를 생성합니다. 새 항목이 나타나고 인라인 이름 필드가 표시됩니다. 이름을 입력하고 Enter 키를 눌러 확인하거나 Esc 키를 눌러 취소할 수 있습니다. |
| 선택 그룹화 | 하나 이상의 자산이 선택된 경우 사용할 수 있습니다. 새 폴더를 만들고 선택된 자산을 해당 폴더로 이동합니다. |
| 이름 바꾸기 | 폴더의 이름을 인라인 편집 가능한 필드로 교체하며, 현재 이름으로 미리 채워집니다. Esc 키를 눌러 변경 사항을 커밋하지 않고 취소할 수 있습니다. |
| 폴더 삭제 | 폴더를 제거합니다. 폴더는 삭제되기 전에 비어 있어야 하며, 내용을 먼저 이동하거나 삭제해야 합니다. 여러 개의 빈 폴더가 선택된 경우 메뉴에 폴더 삭제가 표시됩니다. |
폴더 이름에는 \, /, :, *, ?, ", <, >, 또는 |를 포함할 수 없으며, 마침표로 끝날 수 없습니다. 마침표로 시작하는 이름(예: .hidden)은 허용됩니다.
탐색
두 패널에서 폴더 계층 구조를 탐색할 수 있습니다:
- 사이드바 — 확장 화살표를 사용하여 하위 폴더를 표시하거나 폴더를 단일 클릭하여 엽니다.
- 주요 보기 — 폴더를 두 번 클릭하여 그 안으로 들어갈 수 있습니다. 사이드바에서 상위 항목을 클릭하거나 뒤로 화살표를 사용하여 돌아갑니다.
항목 이동
자산과 폴더 모두 이동할 수 있지만 동일한 인벤토리 내에서만 가능합니다. 인벤토리를 초월하는 이동(예: 내 인벤토리에서 그룹 인벤토리로)은 지원되지 않습니다.
| 방법 | 설명 |
|---|---|
| 드래그 앤 드롭 | 선택한 항목을 주요 보기 또는 사이드바 트리의 대상 폴더에 드래그합니다. 유효한 드롭 대상은 마우스를 올리면 강조 표시됩니다. |
| 이동 대화 상자 | 선택을 마우스 오른쪽 버튼으로 클릭하고 이동을 선택하여 폴더 선택기를 엽니다. 드릴 인 화살표를 사용하여 폴더로 들어가고, 뒤로를 눌러 한 단계 위로 올라가고, 대상을 선택한 후 이동을 클릭합니다. 새로 고침은 서버에서 폴더 목록을 다시 가져옵니다. |
여러 항목을 한 번에 이동할 수 있습니다. 폴더를 자기 자신 또는 자신의 하위 항목 중 하나에 이동하는 것은 차단되며, 유효하지 않은 대상은 드롭 대상으로 강조 표시되지 않거나 이동 대화 상자에서 회색으로 표시됩니다.
검색 및 폴더
검색 쿼리를 입력하면 결과에 자산 결과와 함께 일치하는 폴더를 나열하는 별도의 폴더 섹션이 포함됩니다. 폴더 결과를 두 번 클릭하여 검색 모드를 종료하고 해당 폴더로 탐색합니다.
검색 결과를 볼 때 드래그 앤 드롭 및 이동 대화 상자가 비활성화됩니다. 먼저 폴더 또는 인벤토리로 탐색한 다음 재구성하세요.
지원되지 않는 범위
다음 보기에서는 폴더 작업을 사용할 수 없습니다:
- 경험 내 장소 — 장소는 폴더로 구성할 수 없습니다.
- 최근 업로드 — 조직적 목적을 위한 읽기 전용입니다.
자산 표시 옵션
주요 패널에서 선택한 인벤토리에 대한 자산이 표시됩니다. 보기 유형을 전환하려면 보기 유형 버튼을 클릭하고 목록 또는 격자를 선택합니다. 격자 보기에서는 슬라이더 위젯을 통해 자산 타일의 크기를 조정할 수 있습니다.
목록 보기에서는 열 머리글을 클릭하여 해당 세부 정보로 자산을 정렬하고, 열 간의 구분선 바를 드래그하여 열의 크기를 조정할 수 있습니다.
열은 헤더 바 영역에서 마우스 오른쪽 버튼을 클릭하여 켜거나 끌 수 있습니다. 열을 드래그하여 재정렬 할 수는 없지만, 원하는 열을 끈 후 다시 켜면 가장 오른쪽 열로 추가할 수 있습니다.
격자 보기에서는 정렬이 정렬 버튼으로 제어됩니다:
자산 유형 필터
항목 필터 버튼을 사용하여 표시되는 자산을 제어할 수 있습니다.
| 필터 유형 | 옵션 |
|---|---|
| 자산 유형 | 애니메이션 | 오디오 | 데칼 | FontFamily | 이미지 | 메시 | MeshPart | 모델 | 장소 | 플러그인 | 비디오 |
| 제작자 | |
| 출처 | 제작자 상점 | 나와 공유됨 | 업로드됨 |
| 패키지 여부 | |
| 오직 보관됨 |
자산 가져오기
자산 가져오기 버튼을 사용하면 모든 자산 유형의 하나 이상의 자산을 가져올 수 있습니다. 가져온 자산은 승인 대기열에 들어가며, 승인 후 게임을 소유한 사용자/그룹의 인벤토리에 추가됩니다.
지원되는 파일 유형 및 기타 기능에 대한 자세한 내용은 가져오기 도구를 참조하십시오.
삽입 및 빠른 작업
빠른 작업은 자산 이름/타일을 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 옵션을 선택하여 액세스할 수 있습니다. 장소는 다른 자산과는 달리 고유한 작업을 제공합니다.
| 작업 | 설명 |
|---|---|
| 삽입 | 3D 자산의 공간적 특성에 따라 카메라에서 삽입 또는 자산 위치에서 삽입을 선택하여 삽입할 수 있습니다(오디오와 같은 비공간 자산은 단순히 Workspace 또는 현재 선택된 탐색기 인스턴스에 삽입됨). FontFamily 또는 플러그인 자산에 대해서는 표시되지 않습니다. |
| 자산 편집 | 자산 제목, 설명 등의 세부 정보를 편집하기 위한 자산 구성 창을 엽니다. FontFamily 또는 플러그인 자산에 대해서는 표시되지 않습니다. |
| 이동 | 자산을 같은 인벤토리 내의 폴더로 재배치하기 위해 이동 대화 상자를 엽니다. 검색 결과를 보고 있을 때는 비활성화됩니다. |
| 자산 ID 복사 | 자산 ID를 클립보드에 복사하여 AudioPlayer.AssetId 또는 MeshPart.MeshId와 같은 객체의 속성 값에 ID를 붙여넣는 데 편리합니다. |
| 브라우저에서 보기 | 자산 페이지로 브라우저를 엽니다. |
| 설치 / 업데이트 / 신고 | 플러그인 자산에만 적용됩니다. 각각 플러그인을 설치, 업데이트 또는 신고합니다. |
검색 쿼리 언어
자산 관리자 인벤토리에서 자산을 찾는 방법을 간소화하기 위해 검색 쿼리 언어를 사용하세요. 키워드, 연산자 및 태그를 조합하여 결과를 필터링, 우선순위 지정 또는 제외할 수 있습니다.
여러 기능을 결합할 때 검색어는 다음 순서(우선순위가 높은 것부터 낮은 것 순서로)로 처리됩니다: 정확한 검색 → 제외된 용어 → 선택적 용어 → 자산 ID 태그 → 생성 날짜 이전 → 생성 날짜 이후 → 업데이트 날짜 이전 → 업데이트 날짜 이후 → 제작자 이름 → 제작자 ID → 그룹 이름 → 그룹 ID → 숫자 자산 ID → 오디오 유형.
쿼리 기능
다음 기능은 단일 쿼리에서 결합될 수 있습니다:
| 기능 | 구문 | 작동 방식 |
|---|---|---|
| 정확한 검색 | "..." | 정확히 문구와 일치하는 결과를 찾습니다. 정확한 일치는 가장 높은 우선순위를 가지며 다른 태그 처리를 우회합니다. |
| 제외 용어 | -term exclude:term | 특정 용어가 포함된 결과를 제외합니다. |
| 선택적 용어 | term? term! optional:term | 기본적으로 모든 용어는 필수입니다. 선택적 용어는 일치하는 결과를 높이지만 포함되지 않은 결과를 제외하지는 않습니다. |
| 자산 ID 검색 | asset_id:123456 assetId:123456 123456 | 일치하는 자산을 결과의 맨 위에 고정합니다. |
| 날짜 필터 | created_before created_after updated_before updated_after | 생성 또는 업데이트 날짜별로 결과를 필터링합니다. |
| 제작자 필터 | creator_name creator_id group_name group_id | 제작자 사용자 또는 제작자 그룹의 이름이나 ID에 따라 결과를 필터링합니다. 여러 제작자 또는 그룹 필터가 제공될 경우, 이 중 어느 하나와 일치하는 결과가 포함됩니다. |
| 오디오 유형 | music sfx sound effects | 오디오 자산을 유형별로 필터링합니다. 특정 오디오 유형으로 결과를 제한하려면 쿼리 끝에 해당 유형을 추가하세요. |
태그
태그는 검색 방식에 영향을 주지만 자체적으로 검색 용어로 처리되지는 않습니다. 태그는 결과를 필터링하거나 순위를 매기는 데 사용될 뿐입니다. 태그에 오타가 있거나 유효하지 않은 날짜가 포함된 경우 일반 검색어로 처리됩니다.
태그는 tag:value 또는 tag=value 형식으로 사용할 수 있으며 대소문자를 구분하지 않습니다.
일부 태그는 대괄호를 사용할 때 여러 개의 값을 설정할 수 있습니다. 예를 들어, exclude:[rusty, broken] 및 asset_id:[123, 456]과 같습니다.
날짜 형식
날짜 필터는 다음 형식을 지원합니다:
| 형식 | 예시 |
|---|---|
| ISO 8601 | 2026-03-10 |
| 시간이 포함된 ISO | 2026-03-10T14:30:00Z |
| 미국 형식 | 03/10/2026 |
| 자세한 형식(대괄호 필요) | [March 10, 2026] |
| 시간이 포함된 형식(대괄호 필요) | [03/10/2026 2:30 PM] |
예제 쿼리
"wooden crate" asset_id:99887766 created_after:2023-06-01 -damaged optional:painted: "wooden crate"와 정확히 일치하며, 특정 자산을 ID로 고정하고, 날짜로 필터링하며, "damaged"를 제외하고, "painted" 결과의 우선순위를 높입니다.
explosion sfx -loop created_before:[December 31, 2023]: "explosion"이라는 소리 효과를 필터링하고, 루프 변형을 제외하며, 날짜로 결과를 제한합니다.
125447393891114 sword glowing? -rusty: 특정 자산을 ID로 고정하고, "sword"를 검색하며, "glowing"의 우선순위를 높이고 "rusty"를 제외합니다.
tree creator_name:buildmaster group_id:9876543: "tree"를 검색하고, "buildmaster"라는 제작자나 ID 9876543의 그룹 자산으로 필터링합니다.
sword creator_id:1000001,2000002 group_name:[Studio Builders]: "sword"를 검색하고, ID 1000001 또는 2000002의 제작자 자산으로 필터링하거나 "Studio Builders" 그룹 자산으로 필터링합니다.