> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/wearables-and-emotes/manage-collections/uploading-wearables.md).

# 웨어러블 업로드

에디터에 웨어러블을 업로드하는 가이드라인

웨어러블을 내보낸 후에는 빌더에 업로드해야 합니다. 이 문서에서는 웨어러블 업로드 과정을 다룹니다.

## 파일 업로드하기

파일을 업로드하기 전에 컬렉션을 만들어야 한다는 점을 기억하세요. 방법을 모른다면 다음을 확인하세요 [컬렉션 만들기](https://docs.decentraland.org/creator/wearables-and-emotes/manage-collections/creating-a-collection). 웨어러블을 업로드하려면 파일을 ***새 아이템*** 창에 끌어다 놓거나 컴퓨터에서 찾아보세요. 파일이 이모트인지 웨어러블인지 자동으로 감지합니다. **컬렉션의 최대 파일 크기는 3MB라는 점을 기억하세요**.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6e60c7fe27f0300b0cee4e8e6078e06001aeb7b3%2F01_new_item%20\(2\).png?alt=media)

파일을 업로드하면 바디 셰이프를 선택하고, 이름을 입력한 뒤 희귀도와 카테고리를 정의하라는 요청이 표시됩니다. 웨어러블의 썸네일도 추가할 수 있습니다.

### **바디 셰이프**

웨어러블이 의도한 아바타에 착용될 수 있도록, 각 바디 셰이프별로 별도의 GLB 파일을 업로드해야 합니다. 남성과 여성용으로 나뉜 웨어러블 버전이 두 개 있다면, 업로드 과정에서 그중 하나의 대표본을 추가한 다음 나중에 에디터를 사용해 다른 하나를 추가할 수 있습니다. 웨어러블이 남녀공용이라면 남성과 여성 버전에 모두 맞도록 설계된 단일 GLB 파일을 업로드하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-942291bec6f750cdb75a9dce28a052a2092c0617%2F03_body_shape.png?alt=media\&token=063a27ac-6cef-4b58-ba37-e315c90812e2)

### **희귀도**

아이템의 희귀도를 선택하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ad71004bc4c60a151d6fa656cbd02d76c877af5%2F04_rarity.png?alt=media\&token=fa8d3478-529e-4039-a551-fa090f3926be)

| 희귀도  | 아이템 수   |
| ---- | ------- |
| 유니크  | 1       |
| 미스틱  | 10      |
| 이그조틱 | 50      |
| 레전더리 | 100     |
| 에픽   | 1,000   |
| 레어   | 5,000   |
| 언커먼  | 10,000  |
| 커먼   | 100,000 |

### **카테고리**

웨어러블은 아바타의 어느 부분을 수정하는지에 따라 여러 카테고리로 구분됩니다. 아이템에 맞는 카테고리를 선택하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-55b2338e231d54e2071cb8f04ee5a584438c65d3%2F05_category.png?alt=media\&token=2ee5921d-9312-47ff-806d-6732670237f0)

### **사용자 지정 썸네일**

카메라 아이콘을 클릭하고 컴퓨터에서 찾아보면 직접 만든 사용자 지정 썸네일을 추가할 수 있습니다. **썸네일은 투명 배경의 256px 정사각형 .png 파일이어야 합니다.** 투명 배경이 없는 썸네일이 포함된 컬렉션은 큐레이션 위원회에서 승인되지 않습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a2d98d4b9b4e4f9bdbe88fe77fee12098668d2e1%2F06_thumbnail%20\(1\).png?alt=media)

{% hint style="warning" %}
⚠️ 웨어러블의 렌더링이 좋게 보이는 것은 마켓플레이스에서 잠재 사용자에게 더 매력적으로 보이게 하는 데 매우 중요합니다. **웨어러블 자체 외의 그래픽을 추가하지 않는 것이 중요합니다. 그렇지 않으면 큐레이션 위원회에서 거부할 수 있습니다.**

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2ef5a8a57c7ba9f22e28270ee9f2a1940962afd%2F07_thumbnail%20(1).png?alt=media" alt="" data-size="original">
{% endhint %}

### **스프링 본**

웨어러블에 `springbone` 가 이름에 포함된 뼈가 있다면, 빌더가 이를 자동으로 감지하고 **스프링 본** 구성 패널을 표시합니다. 이 패널에서 각 스프링 본 체인에 대해 강성, 중력, 드래그 같은 물리 파라미터를 조정할 수 있습니다. 자세한 설정 방법은 [스프링 본](https://docs.decentraland.org/creator/wearables-and-emotes/wearables/spring-bones) 을 참고하세요.

### **속성**

썸네일 아래에서 웨어러블의 속성, 모델의 삼각형 수, 재질 수, 텍스처 수를 확인할 수 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bc42f36e88f5a96678e2a703897104b85ec5cfaf%2F08_properties%20\(1\).png?alt=media)

## **입, 눈, 눈썹 업로드하기**

입, 눈, 눈썹 카테고리는 .png 파일만 사용하기 때문에 에디터에서 동작 방식이 다릅니다. 업로드하려면 PNG 파일을 투명 이미지(256X256 픽셀)로 끌어다 놓기만 하면 됩니다. 입은 피부색으로 자동 틴팅되며, 눈썹은 머리카락 색으로 틴팅됩니다.

{% hint style="warning" %}
에셋을 마스킹하여 입이나 눈썹의 일부가 틴팅의 영향을 받지 않게 하려면, png 파일과 마스크 파일을 모두 포함한 zip 파일을 업로드하세요. 마스크 파일이 작동하려면 접미사 "\\\_mask"가 있어야 한다는 점을 기억하세요.
{% endhint %}

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-59b06bc1e09cccd097ed688a5a9e76dd935bc266%2F02_mouth_wearable%20\(1\).png?alt=media)

그 후 웨어러블을 업로드하면 컬렉션의 아이템을 보여주는 다음과 같은 화면이 나타납니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-351d65cea2c597e23d6ba80271f5c15bdd10a39c%2F11_list_wearables%20\(1\).png?alt=media)

## **웨어러블 가격 설정하기**

컬렉션을 게시하고 승인을 받으면, 컬렉션의 판매를 활성화할 수 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2c0894af1d879b320be62d3c3d129dabd5ce5e52%2F25_enable_sales.png?alt=media\&token=60a47a3c-1f36-4e3d-8018-322e9acaa4c1)

웨어러블의 가격은 ***판매 등록***&#xC744; 클릭하여 설정할 수 있습니다. 이 모든 것은 언제든지 수정할 수 있으니, 나중에 바꾸고 싶어도 걱정하지 마세요. 가격은 MANA로 설정됩니다. 웨어러블을 민팅하면 Matic/Polygon에서 직접 민팅된다는 점을 기억하세요. 사용자가 아이템을 구매하면 거래는 Matic/Polygon MANA로 진행됩니다.

또는 ***무료로 설정***, 이는 가격이 0 MANA로 설정되고 수혜자 주소가 null이 된다는 뜻입니다. 무료로 설정(1차 판매)했다고 해서 2차 판매에서 어떤 가격으로도 판매되는 것을 막지는 않습니다.

판매로 발생한 MANA를 받을 수혜자 주소를 설정하는 것을 잊지 마세요. 원하는 Ethereum 주소를 사용할 수 있습니다. 현재 로그인한 계정의 주소를 자동으로 입력하려면 ***제가 수혜자입니다.***

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1eb53ad2b2cc00b9646b690fb6f269a1469fc859%2F12_set_price%20\(1\).png?alt=media)

아이템을 판매 등록하면 컬렉션의 웨어러블 목록으로 돌아갑니다. 아이템을 클릭하면 일반 정보를 볼 수 있습니다. 버튼 ***미리보기*** 을 클릭해 에디터에서 확인하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f65935855a4863b147f44ecdb63c141b9e207e37%2F13_click_item%20\(1\).png?alt=media)

## 에디터

를 클릭하면 ***미리보기***&#xC5D0;디터가 열립니다. 설명, 태그, 오버라이드 같은 새 정보도 추가할 수 있고, 웨어러블의 모든 정보를 수정할 수 있습니다. 또한 웨어러블에 다른 바디 셰이프 대표본을 추가하는 곳이기도 합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c17bf51a41c7e24c95ce4ff934aecbb253c6b1bf%2F14_editor%20\(1\).png?alt=media)

## **설명**

마켓플레이스에 표시될, 아이템을 설명하는 짧은 문구입니다.

## **오버라이드**

오버라이드는 아이템이 숨길 웨어러블 카테고리 또는 아바타 신체 부위를 결정합니다. 예를 들어, 머리카락이 달린 모자는 *머리카락* 카테고리를 숨겨야 할 수 있습니다. 심해 잠수부 헬멧은 귀걸이, 안경, 티아라 등 보이지 않게 될 머리 액세서리를 숨겨야 할 수 있습니다. 각 오버라이드마다 여러 옵션을 선택할 수 있습니다.

* **기본 신체**: 이는 *머리* 과 *손*과 같은 아바타의 핵심 부위를 의미합니다. 예를 들어 **손 착용** 아이템을 만들고 있다면, 예를 들어 로봇 정비공 손 같은 경우 *손* 가 필요할 가능성이 높습니다. 그래야 겹침과 클리핑을 방지할 수 있습니다.
* **웨어러블**: 여기에는 다른 웨어러블 카테고리도 포함됩니다. 여러 카테고리를 숨길 수 있습니다. 각 카테고리와 아이템 간 상호작용에 대한 자세한 내용은 [**웨어러블 만들기**](https://docs.decentraland.org/creator/wearables/creating-wearables/).

{% hint style="warning" %}
참고: 선택한 오버라이드는 웨어러블의 권장 기본 설정이 됩니다. 하지만 사용자는 백팩에서 어떤 웨어러블을 숨기거나 표시할지 직접 사용자 지정할 수 있습니다.
{% endhint %}

## **태그**

태그는 사용자가 아이템을 검색하거나 필터링할 때 사용할 수 있는 설명 단어입니다. 대회나 이벤트와 관련이 있습니다!

## **VRM 내보내기 권한**

이 속성을 활성화하면 해당 아이템의 소유자가 이를 VRM 아바타 내보내기에 포함하여 Decentraland 밖에서도 보여줄 수 있습니다.

## **윤곽선**

윤곽선 토글은 웨어러블이 Decentraland의 윤곽선 렌더링 시스템(중간/높음 품질 설정에서 사용됨)과 호환되는지 여부를 제어합니다. 기본적으로 이 옵션은 모든 새 웨어러블에 활성화되어 있습니다.

다음과 같은 경우 이 옵션을 비활성화해야 합니다:

* 모델에 수동으로 만든 윤곽선이 있는 경우
* 반전 노멀을 사용하는 경우
* 윤곽선 효과가 적용될 때 시각적 아티팩트가 나타나는 경우

대부분의 웨어러블은 기본 설정(활성화)으로도 잘 작동합니다. 웨어러블에 윤곽선 관련 시각적 문제가 보일 때만 비활성화하세요. 윤곽선을 비활성화한 뒤에는 ***저장***.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ad0cd85609f95bc95bbd3baf49dc071e8a97723%2F26_outline.png?alt=media\&token=9c8b744c-705e-43bd-97b5-755c204ac99b)

## **다른 대표본 추가하기**

웨어러블에 남성과 여성용으로 다른 대표본이 있다면 다른 파일도 업로드해야 합니다. 지금까지는 하나만 업로드된 상태입니다. 예시에서는 크람푸스 스웨터의 여성 버전이었습니다. 다른 대표본을 추가하려면 오른쪽 상단의 세 개의 점(*…*)을 클릭한 다음 ***속성*** 를 선택한 다음 ***남성/여성 추가*** 대표본. 아래 예시에서는 남성 버전이 필요했습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ea0b6faf6026da46c57f48ee1136bc538fba7f7b%2F15_add_variation.png?alt=media\&token=d9e2dc97-d292-446f-ad5c-43be8bad16c5)

클릭하면 남성/여성 대표본 추가 창이 열리며, 다른 대표본 파일을 끌어다 놓아 업로드하면 됩니다. 업로드가 완료되면 웨어러블을 보여주는 다른 창이 나타나고, 모든 것이 정상이라면 저장을 클릭하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a73d583c8dfb295752dd7b179acc19accbf4985b%2F16_add_male_representation_01.png?alt=media\&token=ac00748a-8650-441a-b774-1005f0aa2474) ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-699f661d68ff93dded1c678bde99934c8ce88a81%2F17_add_male_representation_02.png?alt=media\&token=e283dfef-0c75-4e5b-a4dc-5cba4c85d330)

## **미리보기**

웨어러블을 미리 보려면 왼쪽 상단의 웨어러블 아이콘 위에 마우스를 올리고 눈 모양 아이콘을 클릭하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-426eba088ec699c3e5d288c570c67cc15e3201ba%2F18_preview_wearables_03.gif?alt=media\&token=3f4afc3f-fab5-460d-b439-40c8d127ec95)

왼쪽 아래의 아이콘을 클릭하면 아바타를 편집할 수 있습니다. 웨어러블의 남성 버전과 여성 버전이 있을 경우 특히 유용하므로, 에디터에서 두 버전이 어떻게 보이는지 확인하고 다양한 이모트를 테스트해 스키닝 문제가 있는지 확인한 뒤 다른 웨어러블과 함께 매치해 여러 의상과 어떻게 어울리는지도 살펴보세요. 웨어러블 편집이 끝나면 ***저장***.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0700d378196aa6c29b0fe645d8d78d43f6a00093%2F19_edit_avatar_wearable_03%20\(1\).gif?alt=media)

## **월드에서 테스트하기**

에디터에서 웨어러블을 테스트한 뒤에도 실제로 Decentraland에서 어떻게 보이고 동작하는지 확인하는 것이 중요합니다. 월드에서 테스트하려면 컬렉션 탭으로 이동하세요. 원하는 컬렉션을 선택한 다음 버튼 ***월드에서 보기***.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-633c01259bf7f72aca1ea31db7122bf4629b2bdc%2F20_test_in_world_01%20\(1\).png?alt=media)

을 클릭하면 다음 팝업이 나타납니다. ***빈 파셀*** 을 선택하면 콘텐츠가 많지 않아 더 빨리 로드되는 장소로 이동합니다.  ***제네시스 플라자*** 를 선택하면 메인 광장으로 이동합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-46534979a901b97538abac8791605a7647528e03%2F23_see_in_world%20\(1\).png?alt=media)

월드에서 보기를 선택하면 브라우저에서 새 탭이 열리고, 다음 메시지가 표시됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-63685950aa7db40e537a08467d800653639c97ea%2F27_wearable_preview.png?alt=media\&token=c60042d6-4104-4baf-9655-05aef4b10e53)

다음을 클릭하세요 ***TRUST PEER-TESTING.DECENTRALAND.ORG*** 라는 팝업이 나타납니다. 그냥 Decentraland 열기를 클릭하세요. 웨어러블을 테스트하려면 백팩으로 가서 착용하면 됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e785372ba4a92942d3017dcbe5f16fd4a00ef4f5%2F28_wearable_world.gif?alt=media\&token=cc8345b0-9901-4cf3-924e-6c4c099de660)

## **게시하기 전**

가격을 제대로 설정하고, 설명을 멋지게 추가하고, 모든 정보와 설정이 올바른지 다시 확인하세요. 필요한 모든 정보를 입력했다면 ***완료*** 가 아이템의 상태로 표시됩니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/wearables-and-emotes/manage-collections/uploading-wearables.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
