> 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/contributor/contributor-ko/content/entity-types/wearables.md).
# 착용 아이템
웨어러블은 [엔티티입니다](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) 플레이어가 착용하고 아바타를 꾸밀 수 있는 아이템이 들어 있는
이 `착용 아이템` 플레이어의 [프로필](https://github.com/decentraland/docs/blob/main/contributor/entity-types/profiles/README.md) 현재 착용 중인 아이템을 가리키는 포인터 목록을 포함합니다.
모든 웨어러블은 하나의 *카테고리*, 아바타 몸에서 차지하는 위치를 나타내며, 다른 카테고리를 숨기거나 대체할 수 있습니다(예를 들어, 긴 드레스는 상의로 입을 수 있지만 다리를 완전히 가릴 수 있습니다).
다양한 메타데이터 필드에서 참조되는 웨어러블 카테고리는 18개입니다: `체형`, `머리카락`, `눈`, `눈썹`, `수염`, `입`, `상체`, `하체`, `발`, `모자`, `헬멧`, `가면`, `티아라`, `머리 위`, `귀걸이`, `안경`, `피부` 및 `손 착용`.
웨어러블 엔터티에는 서로 다른 체형에 대한 GLB 형식 파일이 포함됩니다.
### 포인터
웨어러블에는 정확히 하나의 관련 [포인터](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md), 이는 [collection](https://github.com/decentraland/docs/blob/main/contributor/entity-types/collections/README.md) 그들이 속한 컬렉션과 그 안의 식별자를 나타냅니다.
웨어러블이 온체인 자산인 경우, 포인터는 다음 형식의 URN입니다:
```
urn:decentraland::collections-v2::-
```
예를 들면, 다음 `pointers` 온체인 웨어러블의 배열은 다음과 같습니다:
```json
{
"pointers": [
"urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0"
],
// ... 기타 엔티티 속성
}
```
웨어러블이 오프체인 자산인 경우, 예를 들어 새 아바타의 기본 웨어러블처럼, 다음 형식이 됩니다:
```
urn:decentraland:off-chain::
-
```
이 경우 컬렉션은 주소가 아니라 이름이며, 아이템 식별자 역시 인덱스가 아니라 이름입니다.
이 `pointers` 오프체인 웨어러블의 배열은 다음과 같습니다:
```json
{
"pointers": [
"urn:decentraland:off-chain:base-avatars:BaseFemale"
],
// ... 기타 엔티티 속성
}
```
### 메타데이터 필드
웨어러블은 기본 필드 대부분을 [감정 표현](https://github.com/decentraland/docs/blob/main/contributor/entity-types/emotes/README.md). 이 `데이터` 프로퍼티에는 웨어러블 전용 정보가 위치합니다.
| 필드 | 값 |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `id` | 이 [포인터](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) 이 웨어러블을 가리키는(또는 가리키던). |
| `이름` | 다음에서 이 웨어러블의 표시 제목 [collection](https://github.com/decentraland/docs/blob/main/contributor/collections/README.md). |
| `설명` | 이 웨어러블에 대한 확장 설명. |
| `이미지` | 이 [내부 파일 이름](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) 이 웨어러블 그림의 |
| `썸네일` | 이 [내부 파일 이름](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) 다음의 256x256 버전의 `이미지`. |
| `희귀도` | 다음 중 하나입니다 `일반`, `비일반`, `희귀`, `영웅`, `전설`, `이국적`, `신화` 또는 `고유`. |
| `i18n` | 다음에 대한 번역 배열 `이름` 필드. |
| `collectionAddress` | 이 웨어러블이 포함된 컬렉션의 이더리움 주소. |
| `metrics` | 애니메이션에 대한 유용한 측정값 몇 가지(아래 참조). |
| `데이터` | 이 웨어러블에 대한 확장 메타데이터(아래 참조). |
일반적인 JSON 형태로:
```json
{
"id": "urn:decentraland:matic:collections-v2:0x11a6879861f36cbad632b4e7226816a16139fb33:0",
"name": "예쁜 드레스",
"description": "입기에 아주 좋은",
"image": "image.png",
"thumbnail": "thumbnail.png",
"rarity": "비일반",
"i18n": [
{ "code": "es", "text": "Vestido Lindo" }
],
"collectionAddress": "0x11a6879861f36cbad632b4e7226816a16139fb33",
"metrics": {
// 측정 객체(아래 참조).
},
"data": {
// 확장 메타데이터(아래 참조).
}
}
```
### 측정값
에서 `metadata.metrics` 객체에서는 이 웨어러블에 포함된 모델에 대한 몇 가지 간단한 측정값을 찾을 수 있습니다. 예:
```json
{
"entities": 1,
"bodies": 12,
"materials": 2,
"meshes": 12,
"textures": 2,
"triangles": 3321
}
```
### 데이터
이 `metadata.data` 객체에는 웨어러블 관련 속성이 위치합니다.
| 필드 | 값 |
| ------ | --------------------------- |
| `카테고리` | 위에 나열된 웨어러블 카테고리 중 하나. |
| `표현` | 서로 다른 체형에 연결된 파일 배열(아래 참조). |
| `숨김` | 이 웨어러블이 숨기는 카테고리 배열. |
| `대체하면` | 이 웨어러블이 완전히 대체하는 카테고리 배열. |
| `tags` | 이 웨어러블을 설명하는 문자열 레이블 배열. |
#### 표현
representations 배열의 각 항목은 체형을 모델 컬렉션과 연결하며, 각 카테고리에 어떤 웨어러블이 표시되는지에 관한 규칙을 추가할 수 있습니다.
| 필드 | 값 |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `bodyShapes` | 다음의 배열입니다 [pointers](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) 체형 엔터티에. |
| `mainFile` | 렌더링을 시작할 3D 모델 파일. |
| `contents` | 파일 이름 배열(최상위 [`콘텐츠` 필드](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#properties))에서 사용되는 `mainFile`. |
| `overrideHides` | 다음을 대체합니다 `숨김` 이 표현에 대한 위 목록을. |
| `overrideReplaces` | 다음을 대체합니다 `대체하면` 이 표현에 대한 위 목록을. |
다음은 전형적인 `표현` 항목:
```json
{
"bodyShapes": [
"urn:decentraland:off-chain:base-avatars:BaseFemale"
],
"mainFile": "male/190.glb",
"contents": [
"male/190.glb"
],
"overrideHides": [ "lower_body" ],
"overrideReplaces": []
}
```
---
# 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/contributor/contributor-ko/content/entity-types/wearables.md?ask=&goal=
```
`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.