> 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-pt/wearables-e-emotes/wearables/linked-wearables.md). # Wearables Vinculados Representações de Wearables de tokens de terceiros ## Sobre Em conformidade com a [proposta inicial da DAO para Linked Wearables](https://governance.decentraland.org/proposal/?id=14e76cc0-2bc7-11ec-ac84-77607720a240) (anteriormente chamado: Third Party Wearables), a [Rascunho da proposta com definições finais](https://governance.decentraland.org/proposal/?id=f69c4d40-aaaf-11ec-87a7-6d2a41508231) quanto a [proposta de redesenho de Linked Wearables](https://decentraland.org/governance/proposal/?id=65caf8d1-8601-49a5-ae11-b0b99d7fdd3c), este documento servirá como documentação para cobrir todos os detalhes relevantes sobre o recurso Linked Wearables. Este documento é destinado principalmente aos representantes de comunidades de NFT que desejam dar aos seus usuários a capacidade de representar seus NFTs como wearables ao passear por Decentraland. ## O que são Linked Wearables? Linked Wearables são representações 3D de NFTs que têm origem fora de Decentraland e podem ser usados como wearables no mundo, podem ser equipados no avatar e são encontrados na backpack. Eles não são [wearables regulares](https://github.com/decentraland/docs/tree/main/creator/wearables-and-emotes/wearables/README.md#what-are-wearables). Eles têm a mesma aparência e seguem as diretrizes dos wearables regulares [diretrizes](/creator/content-creator-pt/wearables-e-emotes/wearables/creating-wearables.md) mas têm um significado completamente diferente. Linked Wearables não existem dentro de coleções tradicionais de wearables (eles pertencem a um tipo especial de coleção), não têm raridade e não podem ser vendidos em [primary](https://market.decentraland.org/browse?assetType=item\§ion=wearables) ou [secondary](https://market.decentraland.org/browse?assetType=nft\§ion=wearables\&vendor=decentraland\&page=1\&sortBy=recently_listed\&onlyOnSale=true\&viewAsGuest=false\&onlySmart=false) mercados. Eles são apenas **representações no mundo ligadas a NFTs externos.** > Imagine que você tem um projeto de NFT chamado ‘Cryptojackets’, no qual cada NFT é um tipo diferente de jaqueta 2D e você quer que seus usuários tenham uma representação 3D da sua jaqueta na backpack do Decentraland. Linked Wearables permite que você envie representações 3D dos seus NFTs como wearables no Decentraland. Não há necessidade de mintar um novo token, e seu projeto NFT atual terá um novo recurso pronto para uso a oferecer! Todos os Linked Wearables são definidos dentro de uma **Linked Wearable Collection**. Veremos como criar uma mais adiante no artigo. ## Como os Linked Wearables representam NFTs? Os wearables são vinculados aos seus NFTs criando uma Linked Wearable Collection no [site do Builder](https://decentraland.org/builder) e definindo como seus NFTs serão representados no momento da criação dos wearables. Oferecemos suporte a 4 mecanismos para vincular seus wearables aos NFTs. Todos esses mecanismos usam o token id dos NFTs para fazer a correspondência entre 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 possuirá o wearable | | NFT único | Um usuário que possua um NFT especificado pelo TOKEN ID possuirá o wearable. *por exemplo, 123456. O usuário possuirá o wearable se possuir o NFT com TOKEN ID: 123456* | | NFTs múltiplos | Um usuário que possua um dos vários NFTs especificados por TOKEN IDs, descritos separados por vírgula, possuirá o wearable. *por exemplo, 123456, 123457, 123458. O usuário possuirá o wearable se possuir o NFT com TOKEN ID: 123456 ou 123457 ou 123458* | | Faixa de NFTs | Um usuário que possua um dos vários NFTs especificados na faixa de TOKEN IDs possuirá o wearable. *por exemplo, \[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 Linked Wearables Collections Normalmente há dois tipos de coleções de NFT: * **Artesanais:** em que cada ativo do token é feito sob medida, ou feito à mão, sem nenhum processo de automatização. * **Programáticas:** em que cada ativo do token não foi criado individualmente à mão, mas gerado automaticamente com código, muitas vezes a partir de atributos que foram previamente projetados e modelados. Por exemplo: [CryptoPunks](https://opensea.io/collection/cryptopunks) e [BAYC](https://opensea.io/collection/boredapeyachtclub) são exemplos de NFT Collections de pfp 2D que foram criadas programaticamente. Seguimos o mesmo princípio em Decentraland com as Linked Wearables Collections também; pode haver Standard Linked Wearable Collections para as coleções artesanais e Programmatic Linked Wearable Collections para as geradas automaticamente. Ambas as coleções diferem nos custos das taxas de publicação que o wearable tem. Consulte a [seção de Custos](#costs) para mais informações sobre as taxas de publicação. ## Criando Linked Wearables ## Criando uma Linked Wearable Collection Criar uma Linked Wearable Collection é 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 isso, **é necessário um contrato de NFT (compatível com ERC721 ou ERC1155) para criar uma Linked Wearable Collection.** Para criar um novo Linked Wearable, siga estas etapas: 1. Na seção da Collection, clique no **Create Collection** botão. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f6f408ed6382176b8194907770cbef0d4165dece%2Fcollections-page.png?alt=media\&token=1431d5a4-aa8a-4efe-bba0-72fb4b1b0001) 2. Selecione a opção Linked Wearable Collection clicando no **Create Collection** botão na seção Linked Collections. ![](https://2402076176-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\&token=574fb93f-fe5c-4850-a8b0-9401c9520bb6) 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 ela está. **O contrato será validado para garantir que esteja em conformidade com os padrões de contratos de NFT.** ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-608cdda08288c205acc5e95e136df320622971c0%2Flinkedw-collection-creation.png?alt=media\&token=b0fa67f5-0ffa-4ad1-905a-66def3e95b8c) 4. Clique no **Criar** botão para criar a coleção. ## Adicionando wearables à Linked Wearable Collection - Um por um É possível, como já acontece com os wearables padrão, enviar os modelos 3D dos seus wearables um por um. Para fazer isso, siga estas etapas: 1. Clique no **Novos itens** botão. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5013abd38364205ff8da8149255a64f7050ff24d%2Flinkedw-empty-collection.png?alt=media\&token=b917bb6a-4e14-450d-a96a-66088c1f240e) 2. Selecione o **Itens individuais** opção. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c38efcbd892737249ffb461d29773b3a175bd428%2Fmultiple-items-upload.png?alt=media\&token=60a36f76-3923-4fc1-b813-482cd0605d8a) 3. Siga as etapas para enviar e configurar seu wearable conforme descrito nas [diretrizes de criação de wearables](/creator/content-creator-pt/wearables-e-emotes/wearables/creating-wearables.md) e configure como ele será vinculado aos seus NFTs. Consulte a "[Como os Linked Wearables representam NFTs?](#how-do-linked-wearables-represent-nfts)" seção para mais informações sobre como configurá-lo. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cd2eeb30ae76bfea4546cf536050b015858c30b5%2Flinkedw-mapping.png?alt=media\&token=26369b88-3448-4e3b-ba68-b321ae553518) ## Adicionando wearables à Linked Wearable Collection - Em massa Como as Linked Wearable collections podem conter um grande número de itens, é possível enviar os modelos 3D e as informações dos wearables em massa. Esse processo envolve criar um arquivo zip com todos os assets de que um item precisa para cada um dos itens. **O envio de wearables em massa é recomendado apenas para coleções programáticas**. ### Montando o ZIP do Wearable Cada item exigirá que seja criado um arquivo ZIP incluindo os seguintes assets: * O **obrigatório** arquivos de modelo 3D do wearable (GLB, GLTFs, arquivos de textura etc). * Um **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 fornecida, uma será gerada usando o modelo 3D. Os modelos 3D e a opcional `thumbnail.png` seguem a [seção de Miniaturas personalizadas](/creator/content-creator-pt/wearables-e-emotes/gerir-colecoes/uploading-wearables.md#custom-thumbnails) no artigo Uploading Wearables sobre como criar uma miniatura personalizada. O `wearable.json` que acompanha o conteúdo dos wearables tem o seguinte formato (tipado como o TypeScript faria): ```typescript type WearableConfiguration = { /** O URN do wearable */ id?: string /** Nome do wearable */ name: string /** Descrição do wearable */ description?: string data: { /** Wearables a substituir ao equipar o wearable */ replaces: WearableCategory[] /** Wearables a ocultar ao equipar o wearable */ hides: WearableCategory[] /** Tags para identificar o wearable */ tags: string[] /** Representações do wearable */ representations: WearableRepresentation[] /** Categoria do wearable */ category: WearableCategory }, /** A definição de mapeamento do wearable com NFTs */ mapping: Mapping } type WearableRepresentation = { /** Formato corporal da representação */ bodyShapes: BodyShape[]; /** Caminho do arquivo para o arquivo principal da representação (GLB, GLTF, etc) */ mainFile: string; /** Uma lista dos caminhos dos arquivos que pertencem à representação */ contents: string[]; /** Wearables a ocultar ao equipar esta representação */ overrideHides: WearableCategory[]; /** Wearables a substituir ao equipar esta representação */ 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 formato corporal: ```json { "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1", "name": "Special hat", "description": "A description of the 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 em zip 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. Alguns pontos a considerar sobre o `wearable.json` arquivo: * Todas as informações sobre as categorias de wearables e quais escolher podem ser encontradas na [diretrizes de criação de wearables](/creator/content-creator-pt/wearables-e-emotes/wearables/creating-wearables.md). * O array representations conterá as informações sobre como cada formato corporal ficará. Cada wearable DEVE conter pelo menos uma representação (pode ter uma ou ambas), ou seja, levando em consideração os formatos corporais que temos atualmente, seja `urn:decentraland:off-chain:base-avatars:BaseMale` ou `urn:decentraland:off-chain:base-avatars:BaseFemale`. Cada representação descreverá quais modelos serão usados para cada formato corporal. * 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?](#how-do-linked-wearables-represent-nfts)" seção. **Definindo um ID ou URN personalizado para os itens** O `id` campo é opcional e pode ser usado para criar um wearable com um ID específico para ser atualizado no futuro em massa (o que é explicado mais adiante na [Edição de wearables em massa](#editing-wearables-in-bulk) seção). No caso de o `id` campo ser usado, ele deve conter o ID completo do wearable. O ID (ou URN) do wearable é escrito como `urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id:item-id`. Em que, `urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id` pode ser recuperado na 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; aceitam: * Caracteres em minúsculas, de `a` à `z`. * Todos os números. * Eles não podem conter outros tipos de caracteres nem espaços em branco. Sugerimos que você substitua os espaços em branco por `-` Você pode recuperar o ID (ou URN) na página da coleção seguindo estas etapas: 1. Acessando a visualização da coleção da qual você deseja copiar o URN e clicando na opção Edit URN no menu de opções: ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-86fb218ae8d3c35d3b4fe7a943684ef05a5f0334%2Fcollection-options-menu.png?alt=media\&token=05a13110-8a74-4340-9f0e-384926b54b2d) 2. Copiando o identificador que está abaixo do campo de texto: ![](https://2402076176-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\&token=b725c1e6-baf5-43e9-8b30-e061e5d06726) Por exemplo, se o URN ou ID recuperado da UI da coleção for `urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection` e você estiver identificando seus wearables numericamente, o URN do exemplo seria `urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1`, sendo `1` o número do wearable. ### O processo de envio Quando todos os arquivos estiverem prontos, para enviar os wearables em massa, siga estas etapas: 1. Clique no **Novos itens** botão. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5013abd38364205ff8da8149255a64f7050ff24d%2Flinkedw-empty-collection.png?alt=media\&token=b917bb6a-4e14-450d-a96a-66088c1f240e) 2. Selecione o **Vários itens** opção. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c38efcbd892737249ffb461d29773b3a175bd428%2Fmultiple-items-upload.png?alt=media\&token=60a36f76-3923-4fc1-b813-482cd0605d8a) 3. Clique no **Navegue no seu computador** link para abrir o gerenciador de arquivos e selecionar todos os zips contendo seus wearables. ![](https://2402076176-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\&token=4b398549-90d8-4943-aaa4-29ae21b40da0) 4. Verifique se todos os arquivos estão corretos ou se precisam ser corrigidos. Nesse caso, o modelo do wearable não está definido ou o `wearable.json` arquivo tem uma representação configurada incorretamente. ![](https://2402076176-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\&token=0315d50a-0672-4f31-8049-de4e210d34c4) 5. Corrija quaisquer erros clicando no **Add more** botão e reenviando os arquivos com falha com o mesmo nome ou descartando os erros usando o ícone de lixeira na seção superior direita do modal. ![](https://2402076176-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\&token=c027ac68-dc2d-4ddf-b5bf-fb5cacf5aceb) 6. Envie todos os wearables clicando em **Upload items**. ![](https://2402076176-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\&token=a917c042-758d-4243-ae5e-808c388da914) 7. Tenha paciência, isso pode demorar um pouco! ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6ffeaa87f107990a7b2846b93f8350976510d7b5%2Fmultiple-files-uploading.png?alt=media\&token=22b0dae1-99c4-4e61-9ac4-06b17b1cda33) 8. Sucesso! Seus itens agora estão disponíveis na sua coleção. ![](https://2402076176-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\&token=02e4e986-10f8-46b4-a0e3-389a7354548f) 9. Selecione se sua coleção é programática ou padrão. Consulte a [NFT Collections & Linked Wearables Collections](#nft-collections--linked-wearables-collections) seção para definir corretamente para qual tipo de coleção você está criando itens. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bf612b69f8feb7f6b38669827fca2a2b3b08db67%2Fcollection-type-selector.png?alt=media\&token=fcc0cedd-bb2f-41f8-b7e8-d80d026cb8d2) ### Erros comuns ao enviar itens em lote * O `id` campo está definido com um valor que já está sendo usado por outro wearable. * O `id` campo está definido com 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á nenhum `wearable.json` arquivo no zip. * O arquivo ZIP não tem no seu diretório raiz o `wearable.json` arquivo. * O `wearable.json` tem um formato ou valores incorretos. * O arquivo é maior que 3 MB. Linked Wearables têm a mesma limitação que os wearables regulares em termos de tamanho, assim como os padrão. * A imagem opcional de miniatura personalizada não é um arquivo png. ## Visualizando os wearables em Decentraland Os Linked Wearables podem ser vistos no mundo para revisar como o modelo funcionará uma vez publicado e aprovado. Para conseguir ver um wearable no mundo, siga estas etapas: 1. Clique no menu de meatballs (três pontos horizontais) à direita do item que você deseja ver no mundo. Um dropdown aparecerá. Selecione **See in Decentraland**. ![](https://2402076176-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\&token=bde688a0-2b92-4e89-9617-71f388cc0968) 2. O Decentraland World será aberto. Navegue até a sua backpack para ver o wearable. ![](https://2402076176-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\&token=42697620-d89b-44be-9be9-bb57df7e8881) {% hint style="warning" %} **⚠️ Aviso**: A pré-visualização no mundo funciona com a Versão Web desatualizada do Decentraland Client. Ainda não é possível testá-los no Decentraland Desktop Client 2.0. {% endhint %} ## Editando Linked Wearables ## Editando o nome da coleção Uma coleção pode ter seu nome alterado pelo seu criador **somente se a coleção não tiver wearables publicados**. Para editar o nome de uma Linked Wearable Collection, siga estas etapas: 1. Clique no nome da coleção. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-53f2c4a5ebc0308045c8fb13d9fddfac17ec5584%2Fedit-collection-name.png?alt=media\&token=cce7b8c3-d62a-42a4-882a-da0839e906e8) 2. Escolha um novo nome para a coleção e clique no botão de salvar. ![](https://2402076176-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\&token=cf468eca-e9f2-4793-a1a2-083200a940eb) ## Excluindo a coleção Uma coleção pode ser excluída pelo seu proprietário **somente se a coleção não tiver wearables publicados**. Para excluir uma Linked Wearable Collection, siga estas etapas: 1. Clique no menu de meatballs (três pontos horizontais) no extremo direito do conjunto de botões. Um dropdown aparecerá. Selecione **Delete**. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-86fb218ae8d3c35d3b4fe7a943684ef05a5f0334%2Fcollection-options-menu.png?alt=media\&token=05a13110-8a74-4340-9f0e-384926b54b2d) 2. Um modal de confirmação aparecerá; se desejar prosseguir, clique em **Ok**, caso contrário clique em **Cancelar**. ![](https://2402076176-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\&token=8c4d9b22-2353-463a-a01a-00af5b495973) ## Editando um wearable individual ### Editando propriedades do wearable Para editar um wearable individual, siga estas etapas: 1. Clique no menu de meatballs (três pontos horizontais) à direita do item que você deseja ver no mundo. Um dropdown aparecerá. Selecione **Abrir no editor**. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1b0fa60cbd4a3c62662657a6fd9a84f82253db81%2Fedit-single-wearable.png?alt=media\&token=fbfbbb38-93d3-4519-9b1e-042b7b15c708) 2. Edite o wearable como os wearables padrão são editados. Siga a seção **Editing items** em [diretrizes de criação de wearables](/creator/content-creator-pt/wearables-e-emotes/wearables/creating-wearables.md) sobre como criar uma miniatura personalizada. ### Editando a vinculação do wearable A vinculação dos wearables com a coleção de NFT é uma das propriedades mais importantes de um Linked Wearable. Para editar como eles são vinculados aos NFTs, você pode alterar rapidamente o valor de vinculação na visualização da coleção, sem precisar navegar para outra página. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-786c5a855561444ce9303b20406d99c8a277b5a2%2Fedit-wearable-mapping.png?alt=media\&token=482f4a12-b141-48c5-965f-72f6844c0933) Consulte a "[Como os Linked Wearables representam NFTs?](#how-do-linked-wearables-represent-nfts)" seção para mais informações sobre como vincular seus wearables. ## Edição de wearables em massa Seguindo a mesma ideia vista anteriormente na seção [Criação de wearables em massa](#creating-linked-wearables-in-bulk) seção, os gerentes de terceiros podem fazer alterações nos wearables em massa. Para fazer alterações em massa nos wearables, é necessário criar um arquivo ZIP para cada um dos wearables que será alterado. Esses arquivos ZIP devem ser criados seguindo o formato descrito em [Criação de wearables em massa](#creating-linked-wearables-in-bulk) com uma exceção, no `wearable.json` arquivo, o `id` propriedade **DEVE** ser definida como 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 massa fornecendo um id no `wearable.json` ficheiro, pode reutilizar os seus `wearable.json` ficheiros para os atualizar. Tendo em consideração o exemplo na [Criação de wearables em massa](#creating-linked-wearables-in-bulk) secção, se quisermos alterar algumas das propriedades de um wearable, por exemplo, o nome ao qual nos esquecemos de adicionar um número, devemos incluir um `wearable.json` ficheiro no ZIP como no exemplo seguinte: ```json { "id": "urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1", "name": "Um chapéu 1", "description": "A description of the 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 `name` campo está definido para o novo nome do wearable. Quando os ficheiros ZIP estiverem prontos, siga estes passos para editar os itens em massa: 1. Clique no menu de meatballs (três pontos horizontais) no extremo direito do conjunto de botões. Um dropdown aparecerá. Selecione **Editar em massa**. ![](https://2402076176-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\&token=cf490d97-6ee0-4a8c-84cb-2b244f1f3e49) 2. Um modal semelhante ao da **Carregamento de modelos em massa** será apresentado. Clique na **Procurar no seu computador** ligação para abrir o seu gestor de ficheiros. ![](https://2402076176-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\&token=9e6c5751-a4e0-4ba2-826f-212f9be2094e) 3. Selecione todos os ficheiros ZIP dos itens que serão editados. ![](https://2402076176-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\&token=4b398549-90d8-4943-aaa4-29ae21b40da0) 4. Verifique se todos os arquivos estão corretos ou se precisam ser corrigidos. Nesse caso, o modelo do wearable não está definido ou o `wearable.json` arquivo tem uma representação configurada incorretamente. ![](https://2402076176-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\&token=f877a959-c168-460d-be50-6a62099ad6a6) 5. Corrija quaisquer erros clicando no **Add more** botão e reenviando os arquivos com falha com o mesmo nome ou descartando os erros usando o ícone de lixeira na seção superior direita do modal. ![](https://2402076176-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\&token=c027ac68-dc2d-4ddf-b5bf-fb5cacf5aceb) 6. Envie todos os wearables clicando em **Upload items**. ![](https://2402076176-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\&token=cf350f9a-030f-4b1b-8bfb-cd62c30a816f) 7. Tenha paciência, isso pode demorar um pouco! ![](https://2402076176-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\&token=640dc1a8-9676-4201-ac82-ac06708db540) 8. Sucesso! Os seus itens estão agora disponíveis na sua coleção. Consulte a publicação no fórum para quaisquer atualizações do curador. ![](https://2402076176-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\&token=dd585d8f-57e0-4f70-9cc2-dd1a3827a4b6) ## Publicar os seus Linked Wearables Os seus Linked Wearables precisam de passar por um processo de publicação e curadoria, tal como os wearables normais. Embora o processo de publicação e curadoria não seja o mesmo dos wearables normais, mantém os mesmos passos; todos os itens têm de ser primeiro publicados para depois serem curados por um curador atribuído. As secções seguintes irão mostrar-lhe como publicar os seus Linked Wearables para serem curados. ## Custos Criar Linked Wearables tem um custo que depende do tipo de Coleção de Linked Wearables que escolheu criar: 1. **Standard**: cada wearable publicado custa o mesmo que um wearable normal: 100 USD pagáveis em MANA. 2. **Programmatic**: uma taxa fixa, paga uma vez por todos os wearables que irá publicar. Esta taxa equivale à publicação de 20 wearables normais: 2000 USD pagáveis em MANA. Para mais informações sobre o tipo de coleção que está a criar, consulte o [NFT Collections & Linked Wearables Collections](#nft-collections--linked-wearables-collections) seção. ## Publicar wearables para revisão Quando os seus wearables estiverem prontos, têm de ser publicados para curadoria. Os seus wearables são publicados em grupos de itens; pode escolher quais os itens que estão prontos para serem curados, selecionando-os e clicando no `Publish` botão. Depois de publicar os itens, a publicação ficará bloqueada até que os que já estão publicados sejam curados. Para publicar os seus wearables, precisa de: 1. Selecione os itens a publicar clicando na caixa de seleção ao lado deles. Clique no **Publish** botão quando estiver pronto com a sua seleção. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d6ff4f16536142b4e8d0e3f2a4aa36c18a975ffc%2Fselecting-to-publish.png?alt=media\&token=134ffa1b-827d-4a33-8afe-1d3dff110bb6) 2. Confirme o nome da sua coleção. Depois de publicar os seus itens, alterar o nome da coleção não é possível, por isso certifique-se de o verificar cuidadosamente. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d6ff4f16536142b4e8d0e3f2a4aa36c18a975ffc%2Fselecting-to-publish.png?alt=media\&token=134ffa1b-827d-4a33-8afe-1d3dff110bb6) 3. Faça uma verificação dos itens que vai publicar. Clique no **Confirmar itens** botão quando estiver pronto. ![](https://2402076176-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\&token=72e0f378-e63d-48ac-a3ef-0169be0f6939) 4. Assine a confirmação da publicação dos seus itens na sua wallet. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-05756a581c1cc16fd53353cfb3890b1de4a95d11%2Fsign-items-confirmation.png?alt=media\&token=c1f2196a-c788-44de-816c-73809df9ea37) 5. Leia e verifique os Termos e Condições. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-72eeed77275882fcf42a45d1cb41b5e5959d9794%2Fterms-and-conditions.png?alt=media\&token=6c3aa17a-81d2-4975-9632-4c7e31bbc472) 6. Verifique as suas taxas de publicação. As taxas necessárias para publicar os wearables estão descritas no [seção de Custos](#costs). ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b41d5ba9de7d2c3df68a723acbff33c919730e3e%2Fpublishing-payment.png?alt=media\&token=3c70cd2d-5a68-4e25-9b81-2f4635dcf796) 7. Se for a primeira vez que publica Linked Wearables, terá de autorizar o smart contract dos Linked Wearables a operar MANA em seu nome. Este passo é necessário para deduzir o MANA usado para pagar as taxas de publicação da sua wallet. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f4f2bd4d4e7ccf6d1a4bedc4c5899377b69e7ed4%2Ffirst-time-publishing.png?alt=media\&token=3317c52e-9b3f-4a95-9ecf-63612c14ce6b) 8. Pague a taxa de publicação e conclua a publicação realizando a transação. Dependendo do congestionamento da rede, isto pode demorar algum tempo. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0e7101b504baf509c46c1f2c2a79c323d290a1fd%2Fcomplete-publishing.png?alt=media\&token=3ae49053-d66a-46dd-bc37-aec4348df0f5) 9. Sucesso! Publicou os seus itens. Os seus itens passarão pelo processo de curadoria tal como as coleções normais. Pode comunicar com o curador através da publicação no fórum. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2a5391baab37e69e5bda4a1b4ee911201484a931%2Fpublication-success.png?alt=media\&token=340e66af-9e7b-438b-bcb1-080e81e9df43) ## Enviar alterações para revisão Os wearables publicados e aprovados que forem editados têm de passar novamente pelo processo de curadoria. Não se preocupe, não serão aplicadas quaisquer taxas aos wearables já publicados. Para enviar alterações para que sejam curadas, precisa de: 1. Selecione os itens com alterações clicando na caixa de seleção ao lado deles. Clique no **Enviar alterações** botão quando estiver pronto com a sua seleção. ![](https://2402076176-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\&token=18a10dcb-6cd9-49ad-b236-ecd68333f75d) 2. Prossiga com o processo de envio de alterações. Como o modal indica, estas alterações terão de passar novamente pela fase de curadoria. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c0b29b0e5a396f327efa5a180dade51f99f8916f%2Fconfirm-push-changes.png?alt=media\&token=9d9356e9-055d-4774-9128-afad2691448f) 3. Leia e verifique os Termos e Condições. Ao aceitá-los, os itens estarão prontos para serem novamente curados. ![](https://2402076176-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\&token=9c31b818-d03e-4fc2-83f1-4959eee73fb2) ## Curadoria Tal como acontece com os wearables normais, os seus modelos 3D terão de obter a aprovação do Comité de Curadores. Não está excluído desta regra, uma vez que a estética e a jogabilidade de Decentraland ainda precisam de ser salvaguardadas. O processo de curadoria diferirá de acordo com o processo usado para gerar os wearables. As 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 habitual para a maioria dos wearables normais), o Curador terá de analisar todos os itens da coleção individualmente para garantir que todos estão em conformidade com as [Wearable Guidelines](/creator/content-creator-pt/wearables-e-emotes/wearables/creating-wearables.md). ### coleções programáticas Para coleções programáticas, nem todos os itens têm de ser curados individualmente. O número de itens a curar em cada coleção depende do tamanho da coleção; isto foi definido pela DAO na [esta proposta](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 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-pt/wearables-e-emotes/wearables/linked-wearables.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.