> 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\&token=71fd423f-0c54-469d-bada-131804b26403) ## **.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": "테니스 샷", "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\&token=4d75a294-a0ae-49d0-b9bb-9a41d334bbb4) 회전하고, 확대 또는 축소하고, 위아래로 이동하세요. 도구를 사용해 애니메이션의 가장 좋은 장면을 잡으세요! ## 에디터 썸네일을 설정하면 편집기가 열립니다. 여기에서 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\&token=d6a661dc-2687-4d43-ab22-d30c7bb15360) 왼쪽 아래 아이콘을 클릭하면 아바타를 편집할 수 있습니다. 오른쪽 아래의 실린더 아이콘을 클릭해 애니메이션이 높이와 공간의 경계 안에 유지되는지 확인하세요. ![](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\&token=273855be-7958-4b1a-b33a-0a5af9719446) 왼쪽 아래 아이콘으로 아바타를 편집할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-11896efd5c2c154ba0d5312d62934805dd043d4e%2Fboundaries.gif?alt=media\&token=c5e8ac87-3454-46c3-a81d-c35a6116f1b5) 실린더 아이콘은 애니메이션의 경계를 보여줍니다. 에모트의 이름, 썸네일, 카테고리, 희귀도, 재생 모드를 편집할 수 있으며 애니메이션 설명을 추가하고 태그를 추가할 수도 있습니다. 다음을 클릭하세요 ***저장*** 작업이 끝나면. * **설명:** 마켓플레이스에 표시될, 아이템을 설명하는 짧은 문구입니다. * **유틸리티** 웨어러블 또는 에모트의 인게임 활용도를 설명하세요. * **태그:** 태그는 사용자가 아이템을 검색하거나 필터링할 때 사용할 수 있는 설명 단어입니다. 대회나 이벤트와 관련이 있습니다! ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0a271b0b5a36f74b74d8d3ab5ddc7ede8baa474e%2Feditor2.png?alt=media\&token=ad669dad-b368-448a-ad1c-9477d7feca1a) ## 월드에서 테스트하기 편집기에서 애니메이션을 테스트한 뒤에도, 실제로 Decentraland에서 어떻게 보이고 동작할지 확인하는 것이 중요합니다. 월드에서 테스트하려면 컬렉션 탭으로 가서 원하는 컬렉션을 선택하면 그 안의 모든 아이템이 표시됩니다. Decentraland에서 보기(See in 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\&token=669a0f67-eb78-44f2-87c5-bd191ee78616) \ \\ {% hint style="info" %} 빈 구역(Empty Parcel) 또는 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\&token=fed0a02f-dbab-45f2-94f9-3e82d3a52d1a) \ \\ {% 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\&token=61e340c2-308f-4e67-9cf4-2d64be2c2b37) \ \\ {% hint style="info" %} 그다음 Decentraland Explorer를 열겠냐는 팝업이 표시됩니다. Explorer가 실행되면 Jump Into 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\&token=7417df06-e281-4a9d-a46e-8b9b652d842d) \ \\ {% 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\&token=c7d53b30-ca16-46ff-bad6-4967e9b51f53) \ \\ ## **게시하기 전** 꼭 좋은 설명을 추가하고 모든 정보와 설정이 올바른지 확인하세요. 썸네일도 다시 확인하세요. 필요한 모든 정보를 입력했다면 아이템 상태에 Ready to Submit가 표시됩니다. 이제 에모트를 게시할 준비가 되었습니다! ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c105d607825d869d5061e244bc3f2c1b1d054629%2Flast.png?alt=media\&token=00630669-f541-4698-89fa-7aa8ae65e9b9) Ready to Submit 상태는 파일이 게시할 준비가 되었다는 뜻입니다! --- # 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-emotes.md?ask=&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.