Wearables

Wearables são os entities que contêm itens para os jogadores usarem e personalizarem seus avatares.

O wearables campo no perfil de um jogador contém uma lista de ponteiros para os itens que ele está usando atualmente.

Todo wearable pertence a uma categoria, indicando o lugar que ocupa no corpo do avatar, e pode esconder ou substituir outras categorias (por exemplo, um vestido longo pode ser usado como roupa superior mas cobrir totalmente as pernas).

Existem 18 categorias de wearables, referenciadas em vários campos de metadados: body_shape, hair, eyes, eyebrows, facial_hair, mouth, upper_body, lower_body, feet, hat, helmet, mask, tiara, top_head, earring, eyewear, skin e hands_wear.

Entidades de wearables incluem arquivos em formato GLB para diferentes body shapes.

Pointers

Wearables têm exatamente um associado pointer, que indica a collection à qual pertencem e seu identificador dentro dela.

Quando o wearable é um ativo on-chain, o ponteiro é um URN desta forma:

urn:decentraland:<blockchain>:collections-v2:<collection address>:<item index>

Para ilustrar, o pointers array para um wearable on-chain se parece com isto:

{
  "pointers": [
    "urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0"
  ],
  // ... other entity properties
}

Quando o wearable é um ativo off-chain, como os wearables padrão para novos avatares, ele terá esta forma:

urn:decentraland:off-chain:<collection>:<item name>

A collection nesse caso é um nome, não um endereço, e o identificador do item também é um nome em vez de um índice.

O pointers array para um wearable off-chain tem esta aparência:

{
  "pointers": [
    "urn:decentraland:off-chain:base-avatars:BaseFemale"
  ],
  // ... other entity properties
}

Campos de Metadata

Wearables compartilham a maioria de seus campos básicos com emotes. O data property é onde a informação específica do wearable está localizada.

Campo	Valor
id	O pointer que resolve (ou costumava resolver) para este wearable.
name	O título exibido para este wearable em um collection.
description	Uma descrição estendida para este wearable.
image	O nome de arquivo interno de uma imagem para este wearable.
thumbnail	O nome de arquivo interno de uma versão 256x256 da image.
rarity	Um de common, uncommon, rare, epic, legendary, exotic, mythic ou unique.
i18n	Um array de traduções para o campo name .
collectionAddress	O endereço Ethereum da collection que contém este wearable.
metrics	Algumas medidas úteis sobre as animações (ver abaixo).
data	Os metadados estendidos para este wearable (ver abaixo).

Em forma JSON típica:

{
  "id": "urn:decentraland:matic:collections-v2:0x11a6879861f36cbad632b4e7226816a16139fb33:0",
  "name": "Pretty Dress",
  "description": "Very nice to wear",
  "image": "image.png",
  "thumbnail": "thumbnail.png",
  "rarity": "uncommon",
  "i18n": [
    { "code": "es", "text": "Vestido Lindo" }
  ],
  "collectionAddress": "0x11a6879861f36cbad632b4e7226816a16139fb33",
  "metrics": {
    // Measurements object (see below).
  },
  "data": {
    // Extended metadata (see below).
  }
}

Métricas

Na metadata.metrics objeto, você encontrará algumas medidas simples para os modelos empacotados com este wearable. Um exemplo:

{
  "entities": 1,
  "bodies": 12,
  "materials": 2,
  "meshes": 12,
  "textures": 2,
  "triangles": 3321
}

Dados

O metadata.data objeto é onde as propriedades específicas do wearable estão localizadas.

Campo	Valor
categoria	Uma das categorias de wearable listadas acima.
representations	Um array de arquivos associados a diferentes body shapes (ver abaixo).
hides	Um array de categorias que este wearable esconde.
replaces	Um array de categorias que este wearable substitui inteiramente.
tags	Um array de rótulos em string descritivos deste wearable.

Representações

Cada item no array representations associa um body shape a uma coleção de modelos, e pode adicionar regras sobre quais wearables são exibidos em cada categoria.

Campo	Valor
bodyShapes	Um array de pointers para entidades de body shape.
mainFile	O arquivo do modelo 3D para iniciar a renderização.
contents	Um array de nomes de arquivos (presentes no nível superior do campo content ) usados pelofield mainFile.
overrideHides	Substitui a lista hides acima para esta representação.
overrideReplaces	Substitui a lista replaces acima para esta representação.

Este é um item típico representations :

{
  "bodyShapes": [
      "urn:decentraland:off-chain:base-avatars:BaseFemale"
  ],
  "mainFile": "male/190.glb",
  "contents": [
      "male/190.glb"
  ],
  "overrideHides": [ "lower_body" ],
  "overrideReplaces": []
}