Wearables Vinculados

Representações Wearable de Tokens de Terceiros

Sobre

De acordo com o proposta inicial do DAO para Linked Wearables (anteriormente chamado: Third Party Wearables), o Rascunho de Proposta com definições finais quanto a proposta de Redesign de Linked Wearables, este documento servirá como documentação para cobrir todos os detalhes relevantes sobre o recurso Linked Wearables.

Este documento é direcionado principalmente a representantes de comunidades de NFTs que desejam dar aos seus usuários a capacidade de representar seus NFTs como wearables ao caminhar por Decentraland.

O que são Linked Wearables?

Linked Wearables são representações 3D de NFTs que se originam fora do Decentraland que podem ser usadas como wearables in-world, podem ser equipadas no avatar e são encontradas na mochila. Elas não são wearables regulares. Eles parecem iguais e seguem as diretrizes mas carregam um significado completamente diferente.

Linked Wearables não existem dentro de coleções tradicionais de wearables (pertencem a um tipo especial de coleção), não têm raridade e não podem ser vendidas em primary ou secondary mercados. Elas são apenas representações in-world vinculadas a NFTs externas.

Imagine que você tem um projeto NFT chamado ‘Cryptojackets’ onde cada NFT é um tipo diferente de jaqueta 2D e você quer que seus usuários tenham uma representação 3D de sua jaqueta na mochila do Decentraland. Linked Wearables permite que você envie representações 3D dos seus NFTs como wearables em Decentraland. Não há necessidade de cunhar um novo token, e seu projeto NFT atual terá um novo recurso pronto para uso para oferecer!

Todos os Linked Wearables são definidos dentro de uma Coleção de Linked Wearables. Veremos como criar uma mais adiante no artigo.

Como os Linked Wearables representam NFTs?

Wearables são vinculados aos seus NFTs criando uma Linked Wearable Collection no site do Builder e definindo como seus NFTs serão representados no momento de criar os wearables.

Suportamos 4 mecanismos para vincular seus wearables aos NFTs. Todos esses mecanismos usam o token id dos NFTs para corresponder a eles.

A tabela a seguir mostra os mecanismos mencionados:

Correspondência
Todos os NFTs	Um usuário que possua qualquer um dos NFTs da coleção possuídra o wearable
NFT único	Um usuário que possua um NFT especificado pelo TOKEN ID possuirá o wearable. ex.: 123456. O usuário possuirá o wearable se possuir o NFT com TOKEN ID: 123456
Múltiplos NFTs	Um usuário que possua um dos muitos NFTs especificados por TOKEN IDs, descritos como separados por vírgula, possuirá o wearable. ex.: 123456, 123457, 123458. O usuário possuirá o wearable se possuir o NFT com TOKEN ID: 123456 ou 123457 ou 123458
Intervalo de NFTs	Um usuário que possua um dos muitos NFTs especificados no intervalo de TOKEN IDs possuirá o wearable. ex.: [1, 1000]. O usuário possuirá o wearable se possuir o NFT com TOKEN ID 1 ou 2 ou 3 ou 4 ou 5 ... ou 100

Tipos de Coleções de Linked Wearables

Normalmente há dois tipos de coleções de NFT:

• Feitas à mão: onde cada ativo de token é feito sob medida, ou feito à mão, sem qualquer processo de automatização.

• Programáticas: onde cada ativo de token não foi criado individualmente à mão, mas gerado automaticamente com código, muitas vezes a partir de traits que foram previamente desenhados e modelados. Por exemplo: CryptoPunks e BAYC são exemplos de coleções de NFT pfp 2D que foram criadas programaticamente.

Seguimos o mesmo princípio em Decentraland com as Coleções de Linked Wearables também, podem existir Coleções Padrão de Linked Wearables para as coleções feitas à mão e Coleções Programáticas de Linked Wearables para as geradas automaticamente. Ambas as coleções diferem nos custos de publicação que o wearable possui. Consulte a seção de Custos para mais informações sobre as taxas de publicação.

Criando Linked Wearables

Criando uma Linked Wearable Collection

Criar uma coleção de Linked Wearables é o primeiro passo para criar nossos Linked Wearables.

Linked Wearables são agrupados em coleções que podem ser criadas, editadas e excluídas por seus proprietários. Cada coleção pode conter um número arbitrário de Linked Wearables. Cada coleção será vinculada a uma coleção de NFT, por esse motivo, um contrato NFT (compatível com ERC721 ou ERC1155) é necessário para criar uma Linked Wearable Collection.

Para criar um novo Linked Wearable siga estes passos:

1. Na seção de Coleções, clique no Criar Coleção botão.

   

   
   
2. Selecione a opção Linked Wearable Collection clicando no Criar Coleção botão na seção Linked Collections.

   

   
   
3. Escolha um nome para a coleção e vincule a coleção à sua coleção de NFT definindo seu endereço de contrato e a rede em que está. O contrato será validado para ter certeza de que cumpre os padrões de contratos NFT.

   

   
   
4. Clique no Criar botão para criar a coleção.

Adicionando Wearables à Linked Wearables Collection - Um a Um

É possível, como já acontece com wearables padrão, enviar os modelos 3D dos seus wearables um a um.

Para isso, siga estes passos:

1. Clique no Novos itens botão.

   

   
   
2. Selecione a opção Single items .

   

   
   
3. Siga os passos para enviar e configurar seu wearable conforme descrito nas diretrizes para criação de wearables e configure como ele será vinculado aos seus NFTs. Verifique a "Como os Linked Wearables representam NFTs?" seção para mais informações sobre como configurá-lo.

   

   
   

Adicionando Wearables à Linked Wearables Collection - Em Lote

Como coleções de Linked Wearables podem conter um grande número de itens, é possível enviar os modelos 3D e as informações dos wearables em lote. Esse processo envolve criar um arquivo zip com todos os assets que um item precisa para cada um dos itens. Enviar wearables em lote é recomendado apenas para coleções programáticas.

Construindo o ZIP do Wearable

Cada item exigirá um arquivo ZIP a ser criado incluindo os seguintes assets:

• O obrigatório Arquivos de modelo 3D do wearable (GLB, GLTFs, arquivos de textura, etc).

• A obrigatório wearable.json arquivo contendo as informações do wearable.

• Um opcional thumbnail.png arquivo contendo a miniatura do wearable que será vista no Builder e no mundo. Se não for fornecido, uma será gerada usando o modelo 3D.

Os modelos 3D e o opcional thumbnail.png seguem a seção Custom Thumbnails no artigo Uploading Wearables sobre como criar uma miniatura personalizada.

O wearable.json acompanhando o conteúdo dos wearables tem o seguinte formato (digitado como o Typescript faria):

type WearableConfiguration = {
  /** The URN of the wearable */
  id?: string
  /** Name of the wearable */
  name: string
  /** Description of the wearable */
  description?: string
  data: {
    /** Wearables to replace when equipping the wearable */
    replaces: WearableCategory[]
    /** Wearables to hide when equipping the wearable */
    hides: WearableCategory[]
    /** Tags to identify the wearable */
    tags: string[]
    /** Representations of the wearable */
    representations: WearableRepresentation[]
    /** Category of the wearable */
    category: WearableCategory
  },
  /** The mapping definition of the wearable with NFTs */
  mapping: Mapping
}

type WearableRepresentation = {
  /** Body shape of the representation */
  bodyShapes: BodyShape[];
  /** File path to the main file of the representation (GLB, GLTF, etc) */
  mainFile: string;
  /** A list of the file paths of the files that belong to the representation */
  contents: string[];
  /** Wearables to hide when equipping this representation */
  overrideHides: WearableCategory[];
  /** Wearables to replace when equipping this representation */
  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[]
}

O seguinte é um exemplo de um wearable.json arquivo que contém um modelo para cada body shape:

{
  "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1",
  "name": "Chapéu especial",
  "description": "Uma descrição do wearable",
  "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"
    }
  }
}

Este arquivo será compactado junto com o aMaleModelFile.glb, aTextureFile.png, aFemaleModelFile.glb e anotherTextureFile.png.

Para adicionar uma miniatura personalizada ao wearable, você pode adicionar um thumbnail.png arquivo.

Algumas considerações sobre o wearable.json arquivo:

• Todas as informações sobre as categorias de wearable e qual escolher podem ser encontradas em diretrizes para criação de wearables.

• O array representations conterá a informação sobre como cada body shape irá se parecer. Cada wearable DEVE conter pelo menos uma representation (pode ter uma ou as duas), isto é, levando em consideração os body shapes que atualmente temos, ou urn:decentraland:off-chain:base-avatars:BaseMale ou urn:decentraland:off-chain:base-avatars:BaseFemale. Cada representation descreverá quais modelos serão usados para cada body shape.

• O objeto mapping deve ser configurado como um dos mecanismos disponíveis para vincular seu NFT ao seu wearable, seguindo a "Como os Linked Wearables representam NFTs?" seção.

Definindo um ID personalizado ou URN para os itens

O id o campo é opcional e pode ser usado para criar um wearable com um ID específico para ser atualizado no futuro em Lote (o que é explicado mais adiante na Editar wearables em lote seção).

Caso o id campo seja usado, ele deve conter todo o ID do wearable. O ID (ou URN) do wearable é escrito como urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id:item-id. Onde, urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id pode ser recuperado a partir da página da coleção e o item-id é o identificador personalizado do item que você gostaria de usar.

IDs ou URNs seguem um formato específico, eles aceitam:

• Caracteres em minúsculo, de a até z.

• Todos os números.

• Eles não podem conter outro tipo de caracteres ou espaços em branco. Sugerimos que você substitua espaços em branco pelo -

Você pode recuperar o ID (ou URN) a partir da página da coleção seguindo os próximos passos:

1. Entrando na visualização da coleção da qual você quer copiar o URN e clicando na opção Edit URN no menu de opções:

1. Copiando o identificador que está abaixo do campo de texto:

Por exemplo, se o URN ou ID recuperado da UI para a coleção for urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection e você está identificando seus wearables numericamente, o URN para o exemplo seria urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1, sendo 1 o número do wearable.

O processo de upload

Uma vez que todos os arquivos estejam prontos, para enviar os wearables em lote, siga estes passos:

1. Clique no Novos itens botão.

   

   
   
2. Selecione a Múltiplos itens .

   

   
   
3. Clique no Procurar no seu computador link para abrir seu gerenciador de arquivos e selecionar todos os zips contendo seus wearables.

   

   
   
4. Revise se todos os arquivos estão corretos ou se precisam ser corrigidos. Neste caso, o modelo do wearable não está definido ou o wearable.json arquivo tem uma representation configurada incorretamente.

   

   
   
5. Corrija quaisquer erros clicando no Adicionar mais botão e reenviando os arquivos que falharam com o mesmo nome ou descartando os erros usando o ícone de lixeira na seção superior direita do modal.

   

   
   
6. Envie todos os wearables clicando em Upload items.

   

   
   
7. Seja paciente, isso pode demorar um pouco!

   

   
   
8. Sucesso! Seus itens agora estão disponíveis em sua coleção.

   

   
   
9. Selecione se sua coleção é programática ou padrão. Verifique a NFT Collections & Linked Wearables Collections seção para definir corretamente para qual tipo de coleção você está criando itens.

   

   
   

Erros comuns ao enviar itens em lote

• O id o campo está definido para um valor que já está sendo usado por outro wearable.

• O id o campo está definido para um valor que não é um ID válido. Por exemplo, o third party id ou collection id pertencem a outro third party ou coleção.

• Não há wearable.json arquivo no zip.

• O arquivo ZIP não tem em seu diretório raiz o wearable.json arquivo.

• O wearable.json tem um formato ou valores incorretos.

• O arquivo é maior que 3MB. Linked Wearables têm a mesma limitação que os wearables regulares em termos de tamanho que os padrão.

• A imagem miniatura opcional personalizada não é um arquivo png.

Visualizando os wearables em Decentraland

Linked Wearables podem ser vistas no mundo para revisar como o modelo funcionará uma vez publicado e aprovado.

Para poder ver um wearable no mundo, siga estes passos:

1. Clique no menu de opções (três pontos horizontais) à direita do item que você deseja ver no mundo. Um dropdown aparecerá. Selecione Ver em Decentraland.

   

   
   
2. O Decentraland World será aberto. Navegue até sua mochila para ver o wearable.

   

   
   

⚠️ Aviso: A pré-visualização in world funciona com a Versão Web Desatualizada do Cliente Decentraland. Não é possível testá-las ainda no Decentraland Desktop Client 2.0.

Editando Linked Wearables

Editando o nome da coleção

Uma coleção pode ser renomeada por seu criador somente se a coleção não tiver wearables publicados.

Para editar o nome de uma Linked Wearable Collection siga estes passos:

1. Clique no nome da coleção.

   

   
   
2. Escolha um novo nome para a coleção e clique no botão salvar.

   

   
   

Excluindo a coleção

Uma coleção pode ser excluída por seu proprietário somente se a coleção não tiver wearables publicados.

Para excluir uma Linked Wearable Collection siga estes passos:

1. Clique no menu de opções (três pontos horizontais) à extrema direita do conjunto de botões. Um dropdown aparecerá. Selecione Excluir.

   

   
   
2. Um modal de confirmação aparecerá, se você desejar prosseguir, clique em Ok, caso contrário clique em Cancelar.

   

   
   

Editando um único wearable

Editando propriedades do wearable

Para editar um único wearable, siga estes passos:

1. Clique no menu de opções (três pontos horizontais) à direita do item que você deseja ver no mundo. Um dropdown aparecerá. Selecione Abrir no editor.

   

   
   
2. Edite o wearable como os wearables padrão são editados. Siga o Editando itens seção em diretrizes para criação de wearables sobre como criar uma miniatura personalizada.

Editando o vínculo do wearable

O vínculo dos wearables com a coleção NFT é uma das propriedades mais importantes de um Linked Wearable. Para editar como eles estão vinculados aos NFTs, você pode alterar rapidamente o valor de vinculação a partir da visualização da coleção, sem a necessidade de navegar para outra página.

Verifique a "Como os Linked Wearables representam NFTs?" seção para mais informações sobre como vincular seus wearables.

Editar wearables em lote

Seguindo a mesma ideia vista anteriormente na Criando wearables em lote seção, os gerentes third party podem fazer alterações nos wearables em lote.

Para fazer alterações em lote nos wearables, é necessário criar um arquivo ZIP para cada um dos wearables que serão alterados.

Esses arquivos ZIP devem ser criados seguindo o formato descrito em Criando wearables em lote com uma exceção, no wearable.json arquivo, a id propriedade DEVE ser definida para o id ou URN do wearable que será alterado. Isso é obrigatório, pois é a única maneira de identificar o wearable a ser alterado. Se você criou seus wearables em lote fornecendo um id no wearable.json arquivo, você pode reutilizar seus wearable.json arquivos para atualizá-los.

Levando em consideração o exemplo na Criando wearables em lote seção, se quisermos alterar algumas das propriedades de um wearable, por exemplo, o nome onde esquecemos de adicionar um número a ele, devemos incluir um wearable.json arquivo no zip como no próximo exemplo:

{
  "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1",
  "name": "Um chapéu 1",
  "description": "Uma descrição do wearable",
  "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"
  }
}

Onde o id campo está definido para o id ou URN do wearable que será alterado e o campo name está definido para o novo nome do wearable.

Uma vez que os arquivos ZIP estejam prontos, siga estes passos para editar os itens em lote:

1. Clique no menu de opções (três pontos horizontais) à extrema direita do conjunto de botões. Um dropdown aparecerá. Selecione Editar em lote.

   

   
   
2. Um modal similar ao do Uploading models in bulk aparecerá. Clique no Procurar no seu computador link para abrir seu gerenciador de arquivos.

   

   
   
3. Selecione todos os arquivos ZIP dos itens que serão editados.

   

   
   
4. Revise se todos os arquivos estão corretos ou se precisam ser corrigidos. Neste caso, o modelo do wearable não está definido ou o wearable.json arquivo tem uma representation configurada incorretamente.

   

   
   
5. Corrija quaisquer erros clicando no Adicionar mais botão e reenviando os arquivos que falharam com o mesmo nome ou descartando os erros usando o ícone de lixeira na seção superior direita do modal.

   

   
   
6. Envie todos os wearables clicando em Upload items.

   

   
   
7. Seja paciente, isso pode demorar um pouco!

   

   
   
8. Sucesso! Seus itens agora estão disponíveis em sua coleção. Verifique o post do fórum para quaisquer atualizações do curador.

   

   
   

Publicando seus Linked Wearables

Seus Linked Wearables precisam passar por um processo de publicação e curadoria como os wearables regulares. Embora o processo de publicação e curadoria não seja o mesmo do aplicado aos wearables regulares, ele mantém as mesmas etapas: todos os itens devem primeiro ser publicados para depois serem curados por um curador designado.

As seções a seguir mostrarão como publicar seus Linked Wearables para serem curados.

Custos

Criar Linked Wearables tem um custo dependendo do tipo de Linked Wearable Collection que você escolheu construir:

1. Padrão: cada wearable publicado custa o mesmo que um wearable regular: USD 100 pagável em MANA.

2. Programático: uma taxa fixa, paga uma vez para todos os wearables que você publicará. Essa taxa equivale à publicação de 20 wearables regulares: 2000 USD pagáveis em MANA.

Para mais informações sobre o tipo de coleção que você está criando, verifique a NFT Collections & Linked Wearables Collections seção.

Publicando wearables para revisão

Quando seus wearables estiverem prontos, eles devem ser publicados para curadoria. Seus wearables são publicados em grupos de itens; você pode escolher quais itens estão prontos para serem curados selecionando-os e clicando no Publicar botão. Após publicar itens, a publicação ficará bloqueada até que os já publicados sejam curados.

Para publicar seus wearables, você precisa:

1. Selecione os itens a serem publicados clicando na caixa de seleção ao lado deles. Clique no Publicar botão quando estiver pronto com sua seleção.

   

   
   
2. Confirme o nome da sua coleção. Uma vez publicados seus itens, alterar o nome da coleção não será possível, portanto verifique-o cuidadosamente.

   

   
   
3. Revise os itens que você está publicando. Clique no Confirm items botão quando estiver pronto.

   

   
   
4. Assine a confirmação de publicação dos seus itens na sua carteira.

   

   
   
5. Leia e marque os Termos e Condições.

   

   
   
6. Verifique suas taxas de publicação. As taxas exigidas para publicar os wearables estão descritas em seção de Custos.

   

   
   
7. Se for sua primeira vez publicando Linked Wearables, você precisará autorizar o contrato inteligente de Linked Wearables a operar MANA em seu nome. Esta etapa é necessária para deduzir o MANA usado para pagar as taxas de publicação da sua carteira.

   

   
   
8. Pague a taxa de publicação e complete a publicação realizando a transação. Dependendo da congestionamento da rede, isso pode demorar um pouco.

   

   
   
9. Sucesso! Você publicou seus itens. Seus itens passarão pelo processo de curadoria como as coleções regulares. Você pode comunicar-se com o curador via o post do fórum.

   

   
   

Enviar alterações para revisão

Wearables publicados e aprovados que forem editados precisam passar pelo processo de curadoria novamente. Não se preocupe, não serão aplicadas taxas aos wearables já publicados.

Para enviar alterações para que sejam curadas, você precisa:

1. Selecione os itens com alterações clicando na caixa de seleção ao lado deles. Clique no Push changes botão quando estiver pronto com sua seleção.

   

   
   
2. Prossiga com o processo de enviar alterações. Como o modal diz, essas alterações precisarão passar pela fase de curadoria mais uma vez.

   

   
   
3. Leia e marque os Termos e Condições. Ao aceitá-los, os itens estarão prontos para serem curados novamente.

   

   
   

Curadoria

Como com os wearables regulares, seus modelos 3D precisarão da aprovação do Comitê de Curadores. Você não está excluído dessa regra, pois a estética e a jogabilidade do Decentraland ainda precisam ser resguardadas.

O processo de curadoria diferirá de acordo com o processo usado para gerar os wearables. Coleções de Linked Wearables admitem wearables feitos à mão e gerados programaticamente.

Wearables feitos à mão

Para modelos 3D que foram feitos individualmente sem qualquer processo automatizado (o método usual para a maioria dos wearables regulares) o Curador precisará revisar todos os itens da coleção individualmente para garantir que todos estejam em conformidade com as Wearable Guidelines.

Coleções programáticas

Para coleções programáticas, nem todos os itens precisam ser curados individualmente. O número de itens a serem curados em cada coleção depende do tamanho da coleção, isso foi definido pelo DAO em esta proposta.