> 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/wearables/linked-wearables.md).

# 연결된 웨어러블

3rd Party 토큰을 웨어러블로 표현한 것

## 소개

다음에 따라 [Linked Wearables에 대한 초기 DAO 제안](https://governance.decentraland.org/proposal/?id=14e76cc0-2bc7-11ec-ac84-77607720a240) (이전 명칭: Third Party Wearables)의 [최종 정의가 포함된 초안 제안서](https://governance.decentraland.org/proposal/?id=f69c4d40-aaaf-11ec-87a7-6d2a41508231) 및 [Linked Wearables 재설계 제안](https://decentraland.org/governance/proposal/?id=65caf8d1-8601-49a5-ae11-b0b99d7fdd3c)이 문서는 Linked Wearables 기능과 관련된 모든 세부 사항을 다루는 문서로 사용됩니다.

이 문서는 주로 Decentraland를 돌아다닐 때 사용자에게 NFT를 웨어러블로 표현할 수 있는 기능을 제공하고자 하는 NFT 커뮤니티 대표를 대상으로 합니다.

## Linked Wearables란 무엇인가요?

Linked Wearables는 Decentraland 외부에서 유래한 NFT의 3D 표현으로, 월드 내에서 웨어러블로 사용할 수 있고, 아바타에 장착할 수 있으며, 백팩에서 찾을 수 있습니다. 이는 [일반 웨어러블이 아닙니다](https://github.com/decentraland/docs/blob/main/creator/wearables-and-emotes/wearables/README.md#what-are-wearables). 외형은 같고 일반 웨어러블의 [가이드라인을 따르지만](/creator/content-creator-ko/wearables-and-emotes/wearables/creating-wearables.md) 의미는 완전히 다릅니다.

Linked Wearables는 기존 웨어러블 컬렉션 안에 존재하지 않으며(특별한 유형의 컬렉션에 속함), 희소성이 없고, [primary](https://market.decentraland.org/browse?assetType=item\&section=wearables) 또는 [secondary](https://market.decentraland.org/browse?assetType=nft\&section=wearables\&vendor=decentraland\&page=1\&sortBy=recently_listed\&onlyOnSale=true\&viewAsGuest=false\&onlySmart=false) 마켓에서 판매할 수 없습니다. 이는 오직 **외부 NFT와 연결된 월드 내 표현일 뿐입니다.**

> ‘Cryptojackets’라는 NFT 프로젝트가 있다고 상상해 보세요. 각 NFT는 서로 다른 종류의 2D 재킷이며, 사용자가 Decentraland 백팩에서 자신의 재킷을 3D로 볼 수 있기를 원한다고 해봅시다. Linked Wearables를 사용하면 Decentraland에서 NFT의 3D 표현을 웨어러블로 제출할 수 있습니다. 새 토큰을 민팅할 필요가 없으며, 기존 NFT 프로젝트에 새로운 즉시 사용 가능한 기능을 제공할 수 있습니다!

모든 Linked Wearables는 **Linked Wearable Collection**안에 정의됩니다. 아래에서 이를 어떻게 만드는지 살펴보겠습니다.

## Linked Wearables는 NFT를 어떻게 표현하나요?

웨어러블은 [Builder 사이트](https://decentraland.org/builder) 에서 Linked Wearable Collection을 생성하고, 웨어러블 생성 시 NFT가 어떻게 표현될지 설정하여 NFT와 연결됩니다.

웨어러블을 NFT와 연결하는 데 4가지 메커니즘을 지원합니다. 이 모든 메커니즘은 NFT의 토큰 ID를 사용해 일치시킵니다.

다음 표는 언급된 메커니즘을 보여줍니다:

| 일치     |                                                                                                                                                                      |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 모든 NFT | 컬렉션의 NFT 중 하나라도 소유한 사용자는 해당 웨어러블을 소유하게 됩니다.                                                                                                                          |
| 단일 NFT | TOKEN ID로 지정된 NFT를 소유한 사용자는 해당 웨어러블을 소유하게 됩니다. *예: 123456. 사용자가 TOKEN ID: 123456인 NFT를 소유하고 있다면 해당 웨어러블을 소유합니다.*                                                     |
| 여러 NFT | 콤마로 구분된 TOKEN ID로 지정된 여러 NFT 중 하나를 소유한 사용자는 해당 웨어러블을 소유하게 됩니다. *예: 123456, 123457, 123458. 사용자가 TOKEN ID: 123456 또는 123457 또는 123458인 NFT를 소유하고 있다면 해당 웨어러블을 소유합니다.* |
| NFT 범위 | TOKEN ID 범위에 지정된 여러 NFT 중 하나를 소유한 사용자는 해당 웨어러블을 소유하게 됩니다. *예: \[1, 1000]. 사용자가 TOKEN ID 1 또는 2 또는 3 또는 4 또는 5 ... 또는 100인 NFT를 소유하고 있다면 해당 웨어러블을 소유합니다.*             |

## Linked Wearables Collection의 유형

일반적으로 NFT 컬렉션에는 두 가지 유형이 있습니다:

* **수작업 제작:** 각 토큰 자산이 자동화 과정 없이 맞춤 제작되거나 수작업으로 만들어진 경우입니다.
* **프로그램 방식:** 각 토큰 자산이 개별적으로 수작업 제작된 것이 아니라, 코드로 자동 생성되며, 여러 경우 이전에 설계 및 모델링된 특성(traits)에서 만들어진 경우입니다. 예를 들면: [CryptoPunks](https://opensea.io/collection/cryptopunks) 및 [BAYC](https://opensea.io/collection/boredapeyachtclub) 는 프로그램 방식으로 생성된 2D PFP NFT 컬렉션의 예입니다.

Decentraland에서도 Linked Wearables Collection에 동일한 원칙을 따릅니다. 수작업 컬렉션용 Standard Linked Wearable Collection과 자동 생성 컬렉션용 Programmatic Linked Wearable Collection이 있습니다. 두 컬렉션은 웨어러블에 부과되는 게시 수수료의 비용이 다릅니다. 게시 수수료에 대한 자세한 내용은 [비용 섹션](#costs) 을 확인하세요.

## Linked Wearables 만들기

## Linked Wearable Collection 만들기

Linked Wearable Collection을 만드는 것은 Linked Wearables를 만드는 첫 단계입니다.

Linked Wearables는 소유자가 생성, 편집, 삭제할 수 있는 컬렉션으로 그룹화됩니다. 각 컬렉션에는 임의의 수의 Linked Wearables가 포함될 수 있습니다. 각 컬렉션은 NFT 컬렉션과 연결되므로, **Linked Wearable Collection을 만들려면 NFT 계약(ERC721 또는 ERC1155 호환)이 필요합니다.**

새 Linked Wearable을 만들려면 다음 단계를 따르세요:

1. 컬렉션 섹션에서 **컬렉션 만들기** 버튼.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f6f408ed6382176b8194907770cbef0d4165dece%2Fcollections-page.png?alt=media)
2. 를 클릭한 다음 **컬렉션 만들기** 버튼 아래의 Linked Collections 섹션에서 Linked Wearable Collection 옵션을 선택합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0191af2f0e332c24b95148303a58922a8a6a32c4%2Fcollection-creation-selector-modal.png?alt=media)
3. 컬렉션의 이름을 정하고, 계약 주소와 네트워크를 설정하여 컬렉션을 NFT 컬렉션과 연결합니다. **해당 계약이 NFT 계약 표준을 준수하는지 확인하기 위해 검증됩니다.**

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-608cdda08288c205acc5e95e136df320622971c0%2Flinkedw-collection-creation.png?alt=media)
4. 다음을 클릭하세요. **만들기** 버튼을 눌러 컬렉션을 생성합니다.

## Linked Wearables Collection에 웨어러블 추가 - 개별 추가

기존의 일반 웨어러블과 마찬가지로, 웨어러블의 3D 모델을 하나씩 업로드할 수 있습니다.

다음 단계를 따르세요:

1. 다음을 클릭하세요. **새 항목** 버튼.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5013abd38364205ff8da8149255a64f7050ff24d%2Flinkedw-empty-collection.png?alt=media)
2. 다음 **단일 항목** 옵션을 제공합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c38efcbd892737249ffb461d29773b3a175bd428%2Fmultiple-items-upload.png?alt=media)
3. 다음에 설명된 대로 웨어러블을 업로드하고 설정하는 단계를 따르세요. [웨어러블 생성 가이드라인](/creator/content-creator-ko/wearables-and-emotes/wearables/creating-wearables.md) 을 참고하여 웨어러블이 NFT와 어떻게 연결될지 설정합니다. 설정 방법에 대한 자세한 내용은 "[Linked Wearables는 NFT를 어떻게 표현하나요?](#how-do-linked-wearables-represent-nfts)" 섹션을 확인하세요.

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

## Linked Wearables Collection에 웨어러블 추가 - 일괄

Linked Wearable 컬렉션에는 많은 수의 항목이 포함될 수 있으므로, 3D 모델과 웨어러블 정보를 일괄로 업로드할 수 있습니다. 이 과정에는 각 항목에 필요한 모든 자산을 포함한 zip 파일을 만드는 작업이 포함됩니다. **웨어러블을 일괄 업로드하는 것은 프로그램 방식 컬렉션에만 권장됩니다**.

### 웨어러블 ZIP 만들기

각 항목에는 다음 자산을 포함한 ZIP 파일이 필요합니다:

* 그 **필수** 웨어러블의 3D 모델 파일(GLB, GLTFs, 텍스처 파일 등).
* 하나의 **필수** `wearable.json` 웨어러블 정보를 담은 파일.
* 다음은 **선택** `thumbnail.png` Builder와 월드에서 보이는 웨어러블의 썸네일이 담긴 파일입니다. 제공되지 않으면 3D 모델을 사용해 생성됩니다.

3D 모델과 선택적인 `thumbnail.png` 는 [커스텀 썸네일 섹션](/creator/content-creator-ko/wearables-and-emotes/manage-collections/uploading-wearables.md#custom-thumbnails) 의 웨어러블 업로드 문서에서 커스텀 썸네일을 만드는 방법을 따르세요.

그 `wearable.json` 웨어러블 콘텐츠와 함께 제공되는 내용은 다음 형식이며(Typescript 기준 표기):

```typescript
type WearableConfiguration = {
  /** 웨어러블의 URN */
  id?: string
  /** 웨어러블 이름 */
  name: string
  /** 웨어러블 설명 */
  description?: string
  data: {
    /** 웨어러블을 장착할 때 대체할 웨어러블 */
    replaces: WearableCategory[]
    /** 웨어러블을 장착할 때 숨길 웨어러블 */
    hides: WearableCategory[]
    /** 웨어러블 식별 태그 */
    tags: string[]
    /** 웨어러블의 표현 */
    representations: WearableRepresentation[]
    /** 웨어러블의 카테고리 */
    category: WearableCategory
  },
  /** NFT와의 웨어러블 매핑 정의 */
  mapping: Mapping
}

type WearableRepresentation = {
  /** 표현의 바디 셰이프 */
  bodyShapes: BodyShape[];
  /** 표현의 मुख्य(main) 파일 경로(GLB, GLTF 등) */
  mainFile: string;
  /** 표현에 속한 파일들의 경로 목록 */
  contents: string[];
  /** 이 표현을 장착할 때 숨길 웨어러블 */
  overrideHides: WearableCategory[];
  /** 이 표현을 장착할 때 대체할 웨어러블 */
  overrideReplaces: WearableCategory[];
}

enum WearableCategory = {
  EYEBROWS = 'eyebrows',
  EYES = 'eyes',
  FACIAL_HAIR = 'facial_hair',
  HAIR = 'hair',
  HEAD = 'head',
  BODY_SHAPE = 'body_shape',
  MOUTH = 'mouth',
  UPPER_BODY = 'upper_body',
  LOWER_BODY = 'lower_body',
  FEET = 'feet',
  EARRING = 'earring',
  EYEWEAR = 'eyewear',
  HAT = 'hat',
  HELMET = 'helmet',
  MASK = 'mask',
  TIARA = 'tiara',
  TOP_HEAD = 'top_head',
  SKIN = 'skin'
}

enum WearableBodyShape = {
  MALE = 'urn:decentraland:off-chain:base-avatars:BaseMale',
  FEMALE = 'urn:decentraland:off-chain:base-avatars:BaseFemale'
}

type Mapping = SingleMapping | AnyMapping | RangeMapping | MultipleMapping

enum MappingType = {
  SINGLE = 'single',
  ANY = 'any',
  MULTIPLE = 'multiple',
  RANGE = 'range'
}

type SingleMapping = {
  type: MappingType.SINGLE
  id: string
}

type AnyMapping = {
  type: MappingType.ANY
}

type RangeMapping = {
  type: MappingType.RANGE
  from: string
  to: string
}

type MultipleMapping = {
  type: MappingType.MULTIPLE
  ids: string[]
}
```

다음은 `wearable.json` 각 바디 셰이프에 대한 모델이 포함된 파일의 예입니다:

```json
{
  "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1",
  "name": "특별한 모자",
  "description": "웨어러블에 대한 설명",
  "data": {
    "replaces": [],
    "hides": ["hair"],
    "tags": ["special", "new", "hat"],
    "representations": [
      {
        "bodyShapes": ["urn:decentraland:off-chain:base-avatars:BaseMale"],
        "mainFile": "aMaleModelFile.glb",
        "contents": ["aMaleModelFile.glb", "aTextureFile.png"],
        "overrideHides": [],
        "overrideReplaces": []
      },
      {
        "bodyShapes": ["urn:decentraland:off-chain:base-avatars:BaseFemale"],
        "mainFile": "aFemaleModelFile.glb",
        "contents": ["aFemaleModelFile.glb", "anotherTextureFile.png"],
        "overrideHides": [],
        "overrideReplaces": []
      }
    ],
    "category": "hat",
    "mapping": {
      "type": "single",
      "id": "123"
    }
  }
}
```

이 파일은 함께 압축되어 `aMaleModelFile.glb`, `aTextureFile.png`, `aFemaleModelFile.glb` 및 `anotherTextureFile.png`.

웨어러블에 커스텀 썸네일을 추가하려면 `thumbnail.png` 파일을 추가할 수 있습니다.

다음은 `wearable.json` 파일에 대해 고려할 몇 가지 사항입니다:

* 웨어러블 카테고리와 어떤 것을 선택해야 하는지에 대한 모든 정보는 [웨어러블 생성 가이드라인](/creator/content-creator-ko/wearables-and-emotes/wearables/creating-wearables.md).
* representations 배열에는 각 바디 셰이프가 어떻게 보일지에 대한 정보가 포함됩니다. 각 웨어러블은 최소 하나의 representation을 반드시 포함해야 하며(하나 또는 두 개 모두 가질 수 있음), 즉 현재 우리가 보유한 바디 셰이프를 고려할 때 `urn:decentraland:off-chain:base-avatars:BaseMale` 또는 `urn:decentraland:off-chain:base-avatars:BaseFemale`중 하나를 포함해야 합니다. 각 representation은 각 바디 셰이프에 어떤 모델이 사용될지 설명합니다.
* mapping 객체는 "[Linked Wearables는 NFT를 어떻게 표현하나요?](#how-do-linked-wearables-represent-nfts)" 섹션에 따라 NFT를 웨어러블에 연결하는 데 사용할 수 있는 메커니즘 중 하나로 설정되어야 합니다.

**항목에 대한 사용자 지정 ID 또는 URN 설정**

그 `id` 필드는 선택 사항이며, 향후 일괄 작업으로 업데이트할 특정 ID를 가진 웨어러블을 만들 때 사용할 수 있습니다(자세한 내용은 [웨어러블 일괄 편집](#editing-wearables-in-bulk) 섹션에서 설명합니다).

만약 `id` 필드를 사용한다면, 웨어러블의 전체 ID를 포함해야 합니다. 웨어러블의 ID(또는 URN)는 다음과 같이 작성됩니다 `urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id:item-id`. 여기서 `urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id` 는 컬렉션 페이지에서 확인할 수 있으며 `item-id` 는 사용하려는 항목의 사용자 지정 식별자입니다.

ID 또는 URN은 특정 형식을 따르며, 허용되는 것은 다음과 같습니다:

* 소문자 문자, `a` 가 `부터`.
* z
* 모든 숫자입니다. 다른 종류의 문자나 공백은 포함할 수 없습니다. 공백은 `-`

다음 단계를 따라 컬렉션 페이지에서 ID(또는 URN)를 가져올 수 있습니다:

1. URN을 복사하려는 컬렉션 보기로 들어가 옵션 메뉴에서 URN 편집 옵션을 클릭합니다:

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

2. 텍스트 필드 아래에 있는 식별자를 복사합니다:

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

예를 들어, 컬렉션의 UI에서 가져온 URN 또는 ID가 `urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection` 이고, 웨어러블을 숫자로 식별하고 있다면, 예시의 URN은 `urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1`이 되며, `1` 여기서

### 업로드 과정

모든 파일이 준비되면 웨어러블을 일괄 업로드하려면 다음 단계를 따르세요:

1. 다음을 클릭하세요. **새 항목** 버튼.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5013abd38364205ff8da8149255a64f7050ff24d%2Flinkedw-empty-collection.png?alt=media)
2. 다음 **여러 항목** 옵션을 제공합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c38efcbd892737249ffb461d29773b3a175bd428%2Fmultiple-items-upload.png?alt=media)
3. 다음을 클릭하세요. **컴퓨터 찾아보기** 링크를 열어 파일 관리자를 실행한 뒤 웨어러블이 들어 있는 모든 zip 파일을 선택합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2e7a04adf757ac9de5174c7bf2a73ca38c51db72%2Fmultiple-files-select-in-bulk.png?alt=media)
4. 모든 파일이 올바른지 또는 수정이 필요한지 확인합니다. 이 경우 웨어러블의 모델이 설정되지 않았거나 `wearable.json` 파일의 representation 설정이 잘못된 것입니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0f4f100da1c3b6f826c13b5aabaec4d3a4d6719c%2Fmultiple-files-with-errors.png?alt=media)
5. " **더 추가** " 버튼을 클릭하여 오류를 수정하고, 같은 이름으로 실패한 파일을 다시 업로드하거나 모달 오른쪽 상단의 휴지통 아이콘을 사용해 오류를 무시합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e6630a7a0d76cddeae7b0170a406edd74209172b%2Fmultiple-files-upload-correct-file.png?alt=media)
6. "을 클릭하여 모든 웨어러블을 업로드합니다. **항목 업로드**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6b6458acfd804c22e3fb69c3fa47ff6c87e5afba%2Fmultiple-files-without-errors.png?alt=media)
7. 잠시만 기다려 주세요. 시간이 좀 걸릴 수 있습니다!

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6ffeaa87f107990a7b2846b93f8350976510d7b5%2Fmultiple-files-uploading.png?alt=media)
8. 성공! 이제 항목이 컬렉션에서 사용 가능합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3ca1cce6a55722039e5ba1eb9a8d2f7b50e79b8d%2Fmultiple-files-upload-success.png?alt=media)
9. 컬렉션이 프로그램 방식인지 표준인지 선택합니다. 올바르게 설정하려는 컬렉션 유형은 [NFT Collections & Linked Wearables Collections](#nft-collections--linked-wearables-collections) 섹션을 확인하세요.

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

### 배치 항목 업로드 시 흔한 오류

* 그 `id` 필드에 이미 다른 웨어러블에서 사용 중인 값이 설정되어 있습니다.
* 그 `id` 필드에 유효하지 않은 ID 값이 설정되어 있습니다. 예를 들어, third party id 또는 collection id가 다른 third party나 컬렉션에 속해 있습니다.
* ZIP 파일에 `wearable.json` 파일이 없습니다.
* ZIP 파일의 루트 디렉터리에 `wearable.json` 파일을 추가할 수 있습니다.
* 그 `wearable.json` 형식이나 값이 올바르지 않습니다.
* 파일 크기가 3MB를 초과합니다. Linked Wearables는 크기 면에서 일반 웨어러블과 동일한 제한이 적용됩니다.
* 사용자 지정 선택 썸네일 이미지가 png 파일이 아닙니다.

## Decentraland에서 웨어러블 보기

Linked Wearables는 게시 및 승인 후 모델이 어떻게 동작하는지 검토할 수 있도록 월드에서 볼 수 있습니다.

월드에서 웨어러블을 보려면 다음 단계를 따르세요:

1. 월드에서 보고 싶은 항목 오른쪽의 미트볼 메뉴(가로 점 3개)를 클릭합니다. 드롭다운이 나타나면 **Decentraland에서 보기**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ea9190efc273444d0c6e753c63cab63648e3ec6%2Fsee-in-world-button.png?alt=media)
2. 를 선택하세요. Decentraland 월드가 열립니다. 백팩으로 이동하여 웨어러블을 확인합니다.

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

{% hint style="warning" %}
**⚠️ 주의**: 월드 내 미리보기는 Decentraland 클라이언트의 구버전 웹 버전에서 작동합니다. 아직 Decentraland Desktop Client 2.0에서는 테스트할 수 없습니다.
{% endhint %}

## Linked Wearables 편집

## 컬렉션 이름 편집

컬렉션은 생성자만 이름을 변경할 수 있습니다 **단, 컬렉션에 게시된 웨어러블이 없는 경우에만 가능합니다**.

Linked Wearable Collection의 이름을 편집하려면 다음 단계를 따르세요:

1. 컬렉션 이름을 클릭합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-53f2c4a5ebc0308045c8fb13d9fddfac17ec5584%2Fedit-collection-name.png?alt=media)
2. 컬렉션의 새 이름을 정하고 저장 버튼을 클릭합니다.

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

## 컬렉션 삭제

컬렉션은 소유자만 삭제할 수 있습니다 **단, 컬렉션에 게시된 웨어러블이 없는 경우에만 가능합니다**.

Linked Wearable Collection을 삭제하려면 다음 단계를 따르세요:

1. 버튼 세트의 맨 오른쪽에 있는 미트볼 메뉴(가로 점 3개)를 클릭합니다. 드롭다운이 나타나면 **삭제**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-86fb218ae8d3c35d3b4fe7a943684ef05a5f0334%2Fcollection-options-menu.png?alt=media)
2. 확인 모달이 나타납니다. 계속하려면 **확인**을 클릭하고, 그렇지 않으면 **취소**.

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

## 단일 웨어러블 편집

### 웨어러블 속성 편집

단일 웨어러블을 편집하려면 다음 단계를 따르세요:

1. 월드에서 보고 싶은 항목 오른쪽의 미트볼 메뉴(가로 점 3개)를 클릭합니다. 드롭다운이 나타나면 **편집기에서 열기**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1b0fa60cbd4a3c62662657a6fd9a84f82253db81%2Fedit-single-wearable.png?alt=media)
2. 일반 웨어러블을 편집하는 방식으로 웨어러블을 편집합니다. 다음을 따르세요 **항목 편집** 섹션을 참고하여 [웨어러블 생성 가이드라인](/creator/content-creator-ko/wearables-and-emotes/wearables/creating-wearables.md) 커스텀 썸네일을 만드는 방법을 확인하세요.

### 웨어러블 연결 편집

웨어러블과 NFT 컬렉션의 연결은 Linked Wearable의 가장 중요한 속성 중 하나입니다. NFT와 어떻게 연결되는지 편집하려면 다른 페이지로 이동할 필요 없이 컬렉션 보기에서 연결 값을 빠르게 변경할 수 있습니다.

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

"[Linked Wearables는 NFT를 어떻게 표현하나요?](#how-do-linked-wearables-represent-nfts)" 섹션을 확인하여 웨어러블을 연결하는 방법에 대한 자세한 내용을 보세요.

## 웨어러블 일괄 편집

앞서 [웨어러블 일괄 생성](#creating-linked-wearables-in-bulk) 섹션에서 본 동일한 아이디어를 따라, 제3자 관리자는 웨어러블을 일괄로 변경할 수 있습니다.

웨어러블을 일괄로 변경하려면 변경될 각 웨어러블에 대한 ZIP 파일을 만들어야 합니다.

이 ZIP 파일들은 [웨어러블 일괄 생성](#creating-linked-wearables-in-bulk) 에서 설명한 형식으로 만들어야 하며, 한 가지 예외가 있습니다. 즉, `wearable.json` 파일에서 `id` 속성은 **반드시** 변경될 웨어러블의 `id` 또는 URN으로 설정되어야 합니다. 이는 변경할 웨어러블을 식별할 수 있는 유일한 방법이므로 필수입니다. 만약 당신이 웨어러블을 일괄로 생성할 때 `wearable.json` 파일, 그들의 것을 재사용할 수 있습니다 `wearable.json` 업데이트하기 위한 파일입니다.

에서의 예시를 고려하면 [웨어러블 일괄 생성](#creating-linked-wearables-in-bulk) 섹션에서, 웨어러블의 일부 속성을 변경하고 싶다면, 예를 들어 이름에 숫자를 추가하는 것을 잊었다면, 다음을 포함해야 합니다 `wearable.json` 다음 예시처럼 ZIP 파일 안에 파일을 포함해야 합니다:

```json
{
  "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1",
  "name": "A hat 1",
  "description": "웨어러블에 대한 설명",
  "data": {
    "replaces": [],
    "hides": ["hair"],
    "tags": ["special", "new", "hat"],
    "representations": [
      {
        "bodyShapes": ["urn:decentraland:off-chain:base-avatars:BaseMale"],
        "mainFile": "aMaleModelFile.glb",
        "contents": ["aMaleModelFile.glb", "aTextureFile.png"],
        "overrideHides": [],
        "overrideReplaces": []
      },
      {
        "bodyShapes": ["urn:decentraland:off-chain:base-avatars:BaseFemale"],
        "mainFile": "aFemaleModelFile.glb",
        "contents": ["aFemaleModelFile.glb", "anotherTextureFile.png"],
        "overrideHides": [],
        "overrideReplaces": []
      }
    ],
    "category": "hat"
  },
  "mapping": {
    "type": "single",
    "id": "123"
  }
}
```

여기서 `id` 필드는 다음 값으로 설정됩니다 `id` 변경될 웨어러블의 ID 또는 URN이며, 그리고 `name` 필드는 웨어러블의 새 이름으로 설정됩니다.

ZIP 파일이 준비되면, 다음 단계에 따라 항목을 일괄 편집하세요:

1. 버튼 세트의 맨 오른쪽에 있는 미트볼 메뉴(가로 점 3개)를 클릭합니다. 드롭다운이 나타나면 **일괄 편집**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-92a54cf11dbf7cc3560bd7b87326481c5d47edc6%2Fedit-multiple-files-bulk-button.png?alt=media)
2. 다음의 것과 유사한 모달이 **모델 일괄 업로드** 가 나타납니다. 다음을 클릭하세요: **컴퓨터에서 찾아보기** 링크를 눌러 파일 관리자를 여세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-632e6dda7ef79574f47b36314b19a34ab9c1139d%2Fedit-multiple-files-modal.png?alt=media)
3. 편집할 항목의 ZIP 파일을 모두 선택하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2e7a04adf757ac9de5174c7bf2a73ca38c51db72%2Fmultiple-files-select-in-bulk.png?alt=media)
4. 모든 파일이 올바른지 또는 수정이 필요한지 확인합니다. 이 경우 웨어러블의 모델이 설정되지 않았거나 `wearable.json` 파일의 representation 설정이 잘못된 것입니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-37fb56bae1874771c0ddeb6bdc7327a68341fac9%2Fedit-multiple-files-with-errors.png?alt=media)
5. " **더 추가** " 버튼을 클릭하여 오류를 수정하고, 같은 이름으로 실패한 파일을 다시 업로드하거나 모달 오른쪽 상단의 휴지통 아이콘을 사용해 오류를 무시합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e6630a7a0d76cddeae7b0170a406edd74209172b%2Fmultiple-files-upload-correct-file.png?alt=media)
6. "을 클릭하여 모든 웨어러블을 업로드합니다. **항목 업로드**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cf54f10416748daf8178f71712bed800156d7e71%2Fedit-multiple-files-without-errors.png?alt=media)
7. 잠시만 기다려 주세요. 시간이 좀 걸릴 수 있습니다!

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f57c7946cc54105787d801e702de42f2833dcfb4%2Fedit-multiple-files-uploading.png?alt=media)
8. 성공! 이제 항목이 컬렉션에서 이용 가능합니다. 큐레이터의 업데이트는 포럼 게시물을 확인하세요.

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

## 링크된 웨어러블 게시하기

Linked Wearables도 일반 웨어러블과 마찬가지로 게시 및 큐레이션 과정을 거쳐야 합니다. 게시 및 큐레이션 과정은 일반 웨어러블의 것과 동일하진 않지만, 절차는 같습니다. 모든 항목은 먼저 게시되어야 하며, 이후 지정된 큐레이터가 큐레이션합니다.

다음 섹션에서는 큐레이션을 위해 Linked Wearables를 게시하는 방법을 보여드립니다.

## 비용

Linked Wearables를 만드는 데는 선택한 Linked Wearable 컬렉션 유형에 따라 비용이 듭니다:

1. **표준**: 게시된 각 웨어러블은 일반 웨어러블과 동일하게 비용이 듭니다: MANA로 지불하는 100달러.
2. **프로그래매틱**: 게시할 모든 웨어러블에 대해 한 번만 지불하는 고정 수수료입니다. 이 수수료는 일반 웨어러블 20개를 게시하는 것과 동일하며: MANA로 지불하는 2000달러입니다.

만들고 있는 컬렉션 유형에 대한 자세한 정보는 다음을 확인하세요: [NFT Collections & Linked Wearables Collections](#nft-collections--linked-wearables-collections) 섹션.

## 검토용 웨어러블 게시

웨어러블이 준비되면 큐레이션을 위해 게시해야 합니다. 웨어러블은 항목 그룹 단위로 게시되며, 항목을 선택하고 다음 버튼을 클릭하여 어떤 항목을 큐레이션 대상으로 준비할지 선택할 수 있습니다 `게시` 버튼을 클릭하세요. 항목을 게시한 후에는 이미 게시된 항목이 큐레이션될 때까지 추가 게시가 차단됩니다.

웨어러블을 게시하려면 다음이 필요합니다:

1. 옆의 체크박스를 클릭하여 게시할 항목을 선택하세요. 다음을 클릭하세요: **게시** 선택이 준비되면 버튼을 클릭하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d6ff4f16536142b4e8d0e3f2a4aa36c18a975ffc%2Fselecting-to-publish.png?alt=media)
2. 컬렉션 이름을 확인하세요. 항목을 게시한 후에는 컬렉션 이름을 변경할 수 없으므로, 꼼꼼히 확인하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d6ff4f16536142b4e8d0e3f2a4aa36c18a975ffc%2Fselecting-to-publish.png?alt=media)
3. 게시할 항목을 다시 확인하세요. 다음을 클릭하세요: **항목 확인** 준비가 되면 버튼을 클릭하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c4e06dd3118b9db516cfe7c50d83f6640c65653c%2Fcheck-items-to-publish.png?alt=media)
4. 지갑에서 항목 게시 확인에 서명하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-05756a581c1cc16fd53353cfb3890b1de4a95d11%2Fsign-items-confirmation.png?alt=media)
5. 이용 약관을 읽고 확인하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-72eeed77275882fcf42a45d1cb41b5e5959d9794%2Fterms-and-conditions.png?alt=media)
6. 게시 수수료를 확인하세요. 웨어러블 게시에 필요한 수수료는 다음에 설명되어 있습니다 [비용 섹션](#costs).

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b41d5ba9de7d2c3df68a723acbff33c919730e3e%2Fpublishing-payment.png?alt=media)
7. Linked Wearables를 처음 게시하는 경우, Linked Wearables 스마트 계약이 대신 MANA를 사용할 수 있도록 승인해야 합니다. 이 단계는 게시 수수료를 지불하는 데 사용되는 MANA를 지갑에서 차감하기 위해 필요합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f4f2bd4d4e7ccf6d1a4bedc4c5899377b69e7ed4%2Ffirst-time-publishing.png?alt=media)
8. 거래를 실행하여 게시 수수료를 지불하고 게시를 완료하세요. 네트워크 혼잡도에 따라 시간이 걸릴 수 있습니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0e7101b504baf509c46c1f2c2a79c323d290a1fd%2Fcomplete-publishing.png?alt=media)
9. 성공! 항목을 게시했습니다. 항목은 일반 컬렉션과 마찬가지로 큐레이션 과정을 거칩니다. 포럼 게시물을 통해 큐레이터와 소통할 수 있습니다.

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

## 검토를 위해 변경 사항 적용

게시 및 승인된 웨어러블을 수정한 경우 큐레이션 과정을 다시 거쳐야 합니다. 걱정하지 마세요. 이미 게시된 웨어러블에는 추가 수수료가 적용되지 않습니다.

큐레이션을 받도록 변경 사항을 적용하려면 다음이 필요합니다:

1. 옆의 체크박스를 클릭하여 변경된 항목을 선택하세요. 다음을 클릭하세요: **변경 사항 적용** 선택이 준비되면 버튼을 클릭하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1375216f6de37075cdba87cfaf7a4c5e63828e7d%2Fselect-push-changes-items.png?alt=media)
2. 변경 사항 적용 절차를 진행하세요. 모달에 표시되듯이, 이러한 변경 사항은 다시 한 번 큐레이션 단계를 거쳐야 합니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c0b29b0e5a396f327efa5a180dade51f99f8916f%2Fconfirm-push-changes.png?alt=media)
3. 이용 약관을 읽고 확인하세요. 이를 수락하면 항목이 다시 큐레이션 준비 상태가 됩니다.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2f5e15844216656bd51bde9c3be4034c47cca82%2Faccept-push-changes-terms-and-conditions.png?alt=media)

## 큐레이션

일반 웨어러블과 마찬가지로 3D 모델도 큐레이터 위원회의 승인을 받아야 합니다. Decentraland의 미적 요소와 게임플레이도 여전히 보호되어야 하므로, 이 규칙에서 제외되지 않습니다.

큐레이션 과정은 웨어러블을 생성하는 데 사용된 방식에 따라 달라집니다. Linked Wearables 컬렉션은 수작업으로 제작된 웨어러블과 프로그램으로 생성된 웨어러블을 허용합니다.

### 수작업 웨어러블

자동화된 과정 없이 개별적으로 제작된 3D 모델의 경우(대부분의 일반 웨어러블에서 사용하는 일반적인 방식), 큐레이터는 컬렉션의 모든 항목을 하나씩 검토하여 모두 다음 사항을 준수하는지 확인해야 합니다 [웨어러블 가이드라인](/creator/content-creator-ko/wearables-and-emotes/wearables/creating-wearables.md).

### 프로그램 생성 컬렉션

프로그램 생성 컬렉션의 경우 모든 항목을 개별적으로 큐레이션할 필요는 없습니다. 각 컬렉션에서 큐레이션해야 하는 항목 수는 컬렉션 규모에 따라 달라지며, 이는 DAO에 의해 다음에서 정의되었습니다 [이 제안](https://governance.decentraland.org/proposal/?id=f69c4d40-aaaf-11ec-87a7-6d2a41508231).


---

# 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/wearables/linked-wearables.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.
