> 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-emotes.md).

# 이모트 업로드

에디터에 이모트를 업로드하는 지침

이모트를 내보낸 후에는 빌더에 업로드해야 합니다. 이 문서는 이모트를 업로드하는 과정을 다룹니다.

## **파일 업로드하기**

파일을 업로드하려면 먼저 컬렉션을 만들어야 한다는 점을 기억하세요. 방법을 모르겠다면 [컬렉션 만들기](https://docs.decentraland.org/creator/wearables-and-emotes/manage-collections/creating-a-collection). 이모트를 업로드하려면 파일을 ***새 항목*** 창에 드래그 앤 드롭하거나 컴퓨터에서 찾아보세요. 파일에 애니메이션이 있으면 자동으로 감지되어 이모트로 식별됩니다.

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

애니메이션 파일을 드래그 앤 드롭하여 업로드하세요.

이모트의 이름을 입력하고, 희귀도, 카테고리, 플레이 모드를 지정하라는 메시지가 표시됩니다. 썸네일 아래에는 파일 내 애니메이션 클립 수, 애니메이션 길이(초), 길이(프레임), 프레임 속도가 표시됩니다.

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

## **.zip 파일을 사용하여 이모트 업로드하기**

이모트에 사운드가 있는 경우(*mp3* 또는 *ogg*) 다음과 `.glb`같이 압축해야 합니다. 그다음에는 `.zip` 파일을 빌더에 드래그 앤 드롭하기만 하면 됩니다. 또한 `.json` 파일을 다른 에셋들과 함께 같은 `.zip` 에 넣어 이름, 설명, 희귀도, 카테고리, 플레이 모드 및/또는 태그를 추가할 수 있습니다. 각 항목의 정의는 다음과 같습니다:

* `name`: 이모트의 이름
* `설명`: 이모트의 설명(공백을 포함하여 총 64자 이내)
* `카테고리`: 이모트의 카테고리("dance", "stunt", "greetings", "fun", "poses", "reactions", "horror", "miscellaneous")
* `희귀도`: 아이템의 희귀도("unique", "mythic", "legendary", "epic", "rare", "exotic", "uncommon", "common")
* `play_mode`: 단일 또는 반복 애니메이션("simple", "loop")
* `태그`: 마켓플레이스에서 쉽게 찾을 수 있도록 하는 태그입니다.

이 정의들을 이모트에 추가하려면 텍스트 파일을 만들고 이름을 **emote.json** 으로 지정한 뒤 다음 줄을 예시처럼 추가하세요:

```
{
  "name": "Tennis Shot",
  "description": "테니스 동작을 보여줘",
  "category": "fun",
  "rarity":"epic",
  "play_mode": "simple",
  "tags":["tennis", "emote", "shot"]

}

```

이렇게 하면 빌더가 모든 .json 정보를 가져와 자동으로 이모트에 적용합니다.

**희귀도**

희귀도 차트를 확인하세요: [여기](https://docs.decentraland.org/creator/wearables-and-emotes/manage-collections/creating-a-collection#rarity).

## **카테고리**

이모트를 가장 잘 설명하는 카테고리를 선택하세요.

* 댄스
* 스턴트
* 인사
* 재미
* 포즈
* 반응
* 호러
* 기타

## **재생 모드**

현재 두 가지 플레이 모드가 있습니다:

* ***한 번 재생***: 이모트가 한 번만 재생된다는 뜻입니다. 그 후 아바타는 *대기* 자세로 돌아갑니다.
* ***루프***: 이모트가 사용자가 다른 동작을 입력할 때까지 반복 재생됩니다.

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

이모트의 경우 편집기에 이미 썸네일을 만들 수 있는 내장 도구가 있으므로 이미지를 업로드할 필요가 없습니다. 동작을 가장 잘 나타내는 프레임을 선택하기만 하면 됩니다.

사람들이 썸네일만 보고 애니메이션이 무엇을 뜻하는지 알아볼 수 있어야 합니다. 정면 샷만으로 충분하지 않다면 모델을 회전하거나, 확대 또는 축소하거나, 위아래로 이동하거나, 클립의 아무 프레임이나 선택해 보세요. 가장 좋은 샷을 선택하는 것이 정말 중요합니다!

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

회전, 확대 또는 축소, 위아래 이동을 해보세요. 도구를 사용해 애니메이션의 가장 좋은 장면을 얻으세요!

## 에디터

썸네일을 설정하면 편집기가 열립니다. 3D 아바타가 해당 동작을 수행하므로 여기서 애니메이션이 잘 재생되는지 확인할 수 있습니다.

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

왼쪽 아래 아이콘을 클릭하면 아바타를 편집할 수 있습니다. 오른쪽 아래의 원통 아이콘을 클릭하여 애니메이션이 높이와 공간의 경계 안에 유지되는지 확인하세요.

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

왼쪽 아래의 아이콘을 통해 아바타를 편집할 수 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-11896efd5c2c154ba0d5312d62934805dd043d4e%2Fboundaries.gif?alt=media)

원통 아이콘은 애니메이션의 경계를 보여줍니다.

이모트의 이름, 썸네일, 카테고리, 희귀도, 플레이 모드를 편집할 수 있으며 애니메이션 설명과 태그도 추가할 수 있습니다. 완료하면 ***저장*** 을 클릭하세요.

* **설명:** 마켓플레이스에 표시될 아이템을 간단히 설명하는 문구입니다.
* **유용성** 웨어러블 또는 이모트의 세계 내 활용도를 설명하세요.
* **태그:** 태그는 사용자가 아이템을 검색하거나 필터링할 때 사용할 수 있는 설명용 단어입니다. 이는 대회나 이벤트에 유용합니다!

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

## 월드에서 테스트하기

편집기에서 애니메이션을 테스트한 후에도 실제로 Decentraland에서 어떻게 보이고 동작할지 확인하는 것이 중요합니다. 월드에서 테스트하려면 컬렉션 탭으로 가서 원하는 컬렉션을 선택하면 그 안에 있는 모든 아이템이 표시됩니다. Decentraland에서 보기를 클릭하세요.

\
\\\\

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

\
\\\\

{% hint style="info" %}
빈 구역 또는 Genesis Plaza에서 테스트할지 선택하라는 메시지가 표시됩니다. 빈 구역을 선택하면 콘텐츠가 많지 않은 곳으로 이동되어 더 빨리 로드됩니다. Genesis Plaza를 선택하면 메인 광장으로 이동합니다.
{% endhint %}

\
\\\\

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

\
\\\\

{% hint style="info" %}
선택하면 브라우저에 새 탭이 열리고 사용자 지정 Catalyst를 사용하려는 중이라는 메시지가 표시됩니다. 계속하려면 TRUST PEER-TESTING.DECENTRALAND.ORG를 클릭하세요.
{% endhint %}

\
\\\\

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

\
\\\\

{% hint style="info" %}
그다음 Decentraland Explorer를 열지 묻는 팝업이 표시됩니다. Explorer가 실행되면 Decentraland로 들어가기를 클릭하세요.
{% endhint %}

\
\\\\

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

\
\\\\

{% hint style="info" %}
월드에 들어가면 I를 눌러 백팩을 열고, 이모트 탭에서 테스트할 이모트를 선택하세요.
{% endhint %}

\
\\\\

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-74738e0c9646bcbad4ebe95221e475f7b06f938d%2Ftesting.gif?alt=media)

\
\\\\

## **게시하기 전**

멋진 설명을 추가하고 모든 정보와 설정이 올바른지 확인하세요. 썸네일도 다시 한번 확인하세요. 필요한 모든 정보를 입력했다면 아이템 상태가 제출 준비 완료로 표시됩니다. 이제 이모트를 게시할 준비가 되었습니다!

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

제출 준비 완료 상태는 파일이 게시될 준비가 되었다는 뜻입니다!


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
