Wearables vinculados
Representaciones de wearables de tokens de terceros
Acerca de
De conformidad con el propuesta inicial del DAO para Linked Wearables (anteriormente llamado: Third Party Wearables), el Borrador de la Propuesta con definiciones finales como las propuesta de Rediseño de Linked Wearables, este documento servirá como documentación para cubrir todos los detalles relevantes sobre la funcionalidad Linked Wearables.
Este documento está mayormente orientado a representantes de comunidades NFT que desean dar a sus usuarios la capacidad de representar sus NFTs como wearables mientras pasean por Decentraland.
¿Qué son los Linked Wearables?
Linked Wearables son representaciones 3D de NFTs que se originan fuera de Decentraland y que pueden usarse como wearables en el mundo, pueden equiparse en el avatar y se encuentran en la mochila. No son wearables regulares. Se ven igual y siguen las directrices de los wearables, pero tienen un significado completamente diferente.
Los Linked Wearables no existen dentro de colecciones tradicionales de wearables (pertenecen a un tipo especial de colección), no tienen rareza y no pueden venderse en primary o secondary mercados. Solo son representaciones en el mundo vinculadas a NFTs externos.
Imagina que tienes un proyecto NFT llamado ‘Cryptojackets’ donde cada NFT es un tipo diferente de chaqueta 2D y quieres que tus usuarios tengan una representación 3D de su chaqueta en su mochila de Decentraland. Linked Wearables te permite enviar representaciones 3D de tus NFTs como wearables en Decentraland. No es necesario acuñar un nuevo token, ¡y tu proyecto NFT actual tendrá una nueva función lista para usar!
Todos los Linked Wearables se definen dentro de una Colección de Linked Wearables. Veremos cómo crear una más adelante en el artículo.
¿Cómo representan los Linked Wearables a los NFTs?
Los wearables se vinculan a tus NFTs creando una Colección de Linked Wearables en el sitio Builder y configurando cómo se representarán tus NFTs en el momento de crear los wearables.
Admitimos 4 mecanismos para vincular tus wearables a NFTs. Todos estos mecanismos usan el id del token de los NFTs para emparejarlos.
La siguiente tabla muestra los mecanismos mencionados:
Todos los NFTs
Un usuario que posea cualquiera de los NFTs de la colección poseerá el wearable
NFT único
Un usuario que posea un NFT especificado por TOKEN ID poseerá el wearable. p. ej. 123456. El usuario poseerá el wearable si posee el NFT con TOKEN ID: 123456
Múltiples NFTs
Un usuario que posea uno de varios NFTs especificados por TOKEN IDs, descritos como separados por comas, poseerá el wearable. p. ej. 123456, 123457, 123458. El usuario poseerá el wearable si posee el NFT con TOKEN ID: 123456 o 123457 o 123458
Rango de NFTs
Un usuario que posea uno de varios NFTs especificados en el rango de TOKEN IDs poseerá el wearable. p. ej. [1, 1000]. El usuario poseerá el wearable si posee el NFT con TOKEN ID 1 o 2 o 3 o 4 o 5 ... o 100
Tipos de Colecciones de Linked Wearables
Usualmente hay dos tipos de colecciones NFT:
Hechas a mano: donde cada activo de token está hecho a medida, o hecho a mano, sin ningún proceso de automatización.
Programáticas: donde cada activo de token no fue creado individualmente a mano, sino generado automáticamente con código, muchas veces a partir de rasgos que fueron previamente diseñados y modelados. Por ejemplo: CryptoPunks y BAYC son ejemplos de colecciones NFT pfp 2D que fueron creadas programáticamente.
Seguimos el mismo principio en Decentraland con las Colecciones de Linked Wearables también; puede haber Colecciones de Linked Wearables Estándar para las colecciones hechas a mano y Colecciones de Linked Wearables Programáticas para las generadas automáticamente. Ambas colecciones difieren en los costos de publicación que tienen los wearables. Consulta la sección de Costos para más información sobre las tarifas de publicación.
Creando Linked Wearables
Creando una Colección de Linked Wearables
Crear una colección de Linked Wearables es el primer paso para crear nuestros Linked Wearables.
Los Linked Wearables se agrupan en colecciones que pueden ser creadas, editadas y eliminadas por sus propietarios. Cada colección puede contener un número arbitrario de Linked Wearables. Cada colección estará vinculada a una colección NFT, por esa razón, se requiere un contrato NFT (compatible con ERC721 o ERC1155) para crear una Colección de Linked Wearables.
Para crear un nuevo Linked Wearable sigue estos pasos:
En la sección de Colecciones, haz clic en el botón Crear Colección .
Selecciona la opción Colección de Linked Wearables haciendo clic en el botón Crear Colección botón bajo la sección Linked Collections.
Elige un nombre para la colección y vincula la colección a tu colección NFT configurando su dirección de contrato y la red en la que se encuentra. El contrato será validado para asegurarse de que cumple con los estándares de contratos NFT.
Haz clic en el botón Crear para crear la colección.
Agregar Wearables a la Colección de Linked Wearables - Uno por Uno
Es posible, como ya ocurre con los wearables estándar, subir los modelos 3D de tus wearables uno por uno.
Para hacerlo, sigue estos pasos:
Haz clic en el Nuevos ítems .
Selecciona la opción Single items .
Sigue los pasos para subir y configurar tu wearable tal como se describe en las directrices para crear wearables y configura cómo se vinculará a tus NFTs. Revisa la "¿Cómo representan los Linked Wearables a los NFTs?" sección para más información sobre cómo configurarlo.
Agregar Wearables a la Colección de Linked Wearables - En Masa
Como las colecciones de Linked Wearables pueden contener un gran número de ítems, es posible subir los modelos 3D y la información de los wearables en masa. Este proceso implica crear un archivo zip con todos los assets que necesita cada ítem. Subir wearables en masa se recomienda solo para colecciones programáticas.
Construyendo el ZIP del Wearable
Cada ítem requerirá que se arme un archivo ZIP que incluya los siguientes assets:
El requerido Archivos del modelo 3D del wearable (GLB, GLTFs, archivos de textura, etc).
A requerido
wearable.jsonarchivo que contiene la información del wearable.Un opcional
thumbnail.pngarchivo que contiene la miniatura del wearable que se verá en el Builder y en el mundo. Si no se proporciona, se generará una utilizando el modelo 3D.
Los modelos 3D y el thumbnail.png opcional siguen la sección Custom Thumbnails en el artículo Uploading Wearables sobre cómo crear una miniatura personalizada.
El wearable.json el contenido que acompaña a los wearables tiene el siguiente formato (tipado como lo haría Typescript):
Lo siguiente es un ejemplo de un wearable.json archivo que contiene un modelo para cada body shape:
Este archivo se comprimirá junto con el aMaleModelFile.glb, aTextureFile.png, aFemaleModelFile.glb y anotherTextureFile.png.
Para agregar una miniatura personalizada al wearable, puedes añadir un thumbnail.png archivo.
Algunas cosas a considerar sobre el wearable.json archivo:
Toda la información sobre las categorías de wearables y cuál elegir se puede encontrar en la directrices para crear wearables.
El array representations contendrá la información sobre cómo se verá cada body shape. Cada wearable DEBE contener al menos una representación (puede tener una o las dos), es decir, tomando en cuenta los body shapes que actualmente tenemos, ya sea
urn:decentraland:off-chain:base-avatars:BaseMaleourn:decentraland:off-chain:base-avatars:BaseFemale. Cada representación describirá qué modelos se usarán para cada body shape.El objeto mapping debe configurarse como uno de los mecanismos disponibles para vincular tu NFT a tu wearable, siguiendo la "¿Cómo representan los Linked Wearables a los NFTs?" sección.
Establecer un ID o URN personalizado para los items
El id el campo es opcional y puede usarse para crear un wearable con un ID específico que pueda actualizarse en el futuro en Bulk (lo cual se explica más adelante en la Editing wearables in bulk sección).
En caso de que el id campo se use, debe contener el ID completo del wearable. El ID (o URN) del wearable se escribe como urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id:item-id. Donde, urn:decentraland:matic:collections-thirdparty:third-party-id:collection-id puede recuperarse desde la página de la collection y el item-id es el identificador personalizado del item que te gustaría usar.
Los IDs o URNs siguen un formato específico, aceptan:
Caracteres en minúscula, desde la
ahasta laz.Todos los números.
No pueden contener otro tipo de caracteres ni espacios en blanco. Te sugerimos reemplazar los espacios en blanco con el
-
Puedes recuperar el ID (o URN) desde la página de la collection siguiendo estos pasos:
Entrar en la vista de la collection de la que quieres copiar el URN y hacer clic en la opción Edit URN en el menú de opciones:
Copiar el identificador que está debajo del campo de texto:
Por ejemplo, si el URN o ID obtenido desde la UI para la collection es urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection y estás identificando tus wearables numéricamente, el URN para el ejemplo sería urn:decentraland:matic:collections-thirdparty:my-third-party:my-collection:1, siendo 1 el número del wearable.
El proceso de subida
Una vez que todos los archivos estén listos, para subir los wearables en bulk, sigue estos pasos:
Haz clic en el Nuevos ítems .
Selecciona la Múltiples items .
Haz clic en el Explorar tu ordenador enlace para abrir tu gestor de archivos y seleccionar todos los zips que contienen tus wearables.
Revisa si todos los archivos son correctos o si necesitan ser arreglados. En este caso, el modelo del wearable no está establecido o el
wearable.jsonarchivo tiene una representación configurada incorrectamente.
Corrige cualquier error haciendo clic en el Add more botón y volviendo a subir los archivos fallidos con el mismo nombre o descartando los errores usando el icono de la papelera en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Upload items.
¡Ten paciencia, esto puede tardar un rato!
¡Éxito! Tus items ahora están disponibles en tu collection.
Selecciona si tu collection es programática o estándar. Revisa la NFT Collections & Linked Wearables Collections sección para configurar correctamente para qué tipo de collection estás creando items.
Errores comunes al subir items por lotes
El
idel campo está configurado con un valor que ya está siendo usado por otro wearable.El
idel campo está configurado con un valor que no es un ID válido. Por ejemplo, el third party id o collection id pertenecen a otro third party o collection.No existe
wearable.jsonarchivo en el zip.El archivo ZIP no tiene en su directorio raíz el
wearable.jsonarchivo.El
wearable.jsontiene un formato o valores incorrectos.El archivo es más grande de 3MB. Los Linked Wearables tienen la misma limitación que los wearables regulares en términos de tamaño que los estándar.
La imagen miniatura opcional personalizada no es un archivo png.
Ver los wearables en Decentraland
Los Linked Wearables pueden verse en el mundo para revisar cómo funcionará el modelo una vez publicado y aprobado.
Para poder ver un wearable en el mundo, sigue estos pasos:
Haz clic en el menú de tres puntos a la derecha del item que quieres ver en el mundo. Aparecerá un desplegable. Selecciona See in Decentraland.
El Decentraland World se abrirá. Navega a tu mochila para ver el wearable.
⚠️ Aviso: La vista previa en el mundo funciona con la Outdated Web Version del Decentraland Client. Aún no es posible probarlos en el Decentraland Desktop Client 2.0.
Editar Linked Wearables
Editar el nombre de la collection
Una collection puede ser renombrada por su creador solo si la collection no tiene wearables publicados.
Para editar el nombre de una Linked Wearable Collection sigue estos pasos:
Haz clic en el nombre de la collection.
Elige un nuevo nombre para la collection y haz clic en el botón de guardar.
Eliminar la collection
Una collection puede ser eliminada por su owner solo si la collection no tiene wearables publicados.
Para eliminar una Linked Wearable Collection sigue estos pasos:
Haz clic en el menú de tres puntos a la derecha del conjunto de botones. Aparecerá un desplegable. Selecciona Delete.
Aparecerá un modal de confirmación; si deseas continuar, haz clic en Ok, de lo contrario haz clic en Cancel.
Editar un solo wearable
Editar las propiedades del wearable
Para editar un solo wearable, sigue estos pasos:
Haz clic en el menú de tres puntos a la derecha del item que quieres ver en el mundo. Aparecerá un desplegable. Selecciona Open in editor.
Edita el wearable como se editan los wearables estándar. Sigue la Editing items sección en directrices para crear wearables sobre cómo crear una miniatura personalizada.
Editar el enlace del wearable
El linking de los wearables con la collection de NFT es una de las propiedades más importantes de un Linked Wearable. Para editar cómo están vinculados a los NFTs, puedes cambiar rápidamente el valor del linking desde la vista de la collection, sin necesidad de navegar a otra página.
Consulta la "¿Cómo representan los Linked Wearables a los NFTs?" sección para más información sobre cómo vincular tus wearables.
Editing wearables in bulk
Siguiendo la misma idea vista previamente en la Creating wearables in bulk sección, los gestores third party pueden hacer cambios a los wearables en bulk.
Para hacer cambios en bulk a wearables, es necesario crear un archivo ZIP para cada uno de los wearables que serán cambiados.
Estos archivos ZIP deben crearse siguiendo el formato descrito en Creating wearables in bulk con una excepción, en el wearable.json archivo, la id propiedad MUST debe estar configurada al id o URN del wearable que será cambiado. Esto es obligatorio ya que es la única manera de identificar el wearable a cambiar. Si creaste tus wearables en bulk proporcionando un id en el wearable.json archivo, puedes reutilizar sus wearable.json archivos para actualizarlos.
Tomando en consideración el ejemplo en la Creating wearables in bulk sección, si quisiéramos cambiar algunas de las propiedades de un wearable, por ejemplo, el nombre al que olvidamos añadir un número, deberíamos incluir un wearable.json archivo en el zip como el siguiente ejemplo:
Donde el id campo está configurado con el id o URN del wearable que será cambiado y el name campo está configurado con el nuevo nombre del wearable.
Una vez que los archivos ZIP estén listos, sigue estos pasos para editar los items en bulk:
Haz clic en el menú de tres puntos a la derecha del conjunto de botones. Aparecerá un desplegable. Selecciona Edit in bulk.
Aparecerá un modal similar al de la Uploading models in bulk Haz clic en el Browse your computer enlace para abrir tu gestor de archivos.
Selecciona todos los archivos ZIP de los items que serán editados.
Revisa si todos los archivos son correctos o si necesitan ser arreglados. En este caso, el modelo del wearable no está establecido o el
wearable.jsonarchivo tiene una representación configurada incorrectamente.
Corrige cualquier error haciendo clic en el Add more botón y volviendo a subir los archivos fallidos con el mismo nombre o descartando los errores usando el icono de la papelera en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Upload items.
¡Ten paciencia, esto puede tardar un rato!
¡Éxito! Tus items ahora están disponibles en tu collection. Revisa el post del foro para cualquier actualización del curator.
Publicar tus Linked Wearables
Tus Linked Wearables necesitan pasar por un proceso de publicación y curación al igual que los wearables regulares. Aunque el proceso de publicación y curación no es el mismo que el de los wearables regulares, mantiene los mismos pasos: todos los items deben primero publicarse para luego ser curados por un curator asignado.
Las secciones siguientes te mostrarán cómo publicar tus Linked Wearables para ser curados.
Costos
Crear Linked Wearables tiene un costo dependiendo del tipo de Linked Wearable Collection que elijas construir:
Standard: cada wearable publicado cuesta lo mismo que un wearable regular: USD 100 pagaderos en MANA.
Programmatic: una tarifa fija, pagada una sola vez por todos los wearables que vas a publicar. Esta tarifa equivale a publicar 20 wearables regulares: 2000 USD pagaderos en MANA.
Para más información sobre el tipo de collection que estás creando, revisa la NFT Collections & Linked Wearables Collections sección.
Publicar wearables para revisión
Una vez que tus wearables estén listos, deben publicarse para curación. Tus wearables se publican en grupos de items; puedes elegir qué items están listos para ser curados seleccionándolos y haciendo clic en el Publish button. Después de publicar items, la publicación quedará bloqueada hasta que los que ya están publicados sean curados.
Para publicar tus wearables, necesitas:
Selecciona los items a publicar haciendo clic en la casilla junto a ellos. Haz clic en el Publish button cuando estés listo con tu selección.
Confirma el nombre de tu collection. Una vez que publiques tus items, no será posible cambiar el nombre de la collection, así que asegúrate de revisarlo cuidadosamente.
Revisa los items que estás publicando. Haz clic en el Confirm items botón cuando estés listo.
Firma la confirmación de publicación de tus items en tu wallet.
Lee y acepta los Terms and Conditions.
Revisa tus tarifas de publicación. Las tarifas requeridas para publicar los wearables se describen en la sección de Costos.
Si es la primera vez que publicas Linked Wearables, necesitarás autorizar al smart contract de Linked Wearables para operar MANA en tu nombre. Este paso es necesario para deducir el MANA usado para pagar las tarifas de publicación desde tu wallet.
Paga la tarifa de publicación y completa la publicación realizando la transacción. Dependiendo de la congestión de la network, esto puede tardar un rato.
¡Éxito! Has publicado tus items. Tus items pasarán por el proceso de curación que hacen las regular collections. Puedes comunicarte con el curator vía el post del foro.
Enviar cambios para revisión
Los wearables publicados y aprobados que sean editados necesitan pasar por el proceso de curación nuevamente. No te preocupes, no se aplicarán tarifas a los wearables ya publicados.
Para enviar cambios para su curación, necesitas:
Selecciona los items con cambios haciendo clic en la casilla junto a ellos. Haz clic en el Push changes button cuando estés listo con tu selección.
Procede con el proceso de push changes. Como dice el modal, estos cambios necesitarán pasar por la fase de curación nuevamente.
Lee y acepta los Terms and Conditions. Al aceptarlos, los items estarán listos para ser curados otra vez.
Curación
Como con los wearables regulares, tus modelos 3D necesitarán la aprobación del Curators Committee. No estás exento de esta regla ya que la estética y la jugabilidad de Decentraland aún deben protegerse.
El proceso de curación variará según el proceso usado para generar los wearables. Las Linked Wearables collections admiten wearables hechos a mano y generados programáticamente.
Handcrafted wearables
Para modelos 3D que fueron hechos individualmente sin ningún proceso automatizado (el método habitual para la mayoría de los wearables regulares) el Curator necesitará revisar todos los items de la collection individualmente para asegurar que todos cumplan con las Wearable Guidelines.
Programmatic collections
Para las collections programáticas, no todos los items tienen que ser curados individualmente. El número de items a curar en cada collection depende del tamaño de la collection; esto fue definido por la DAO en esta propuesta.
Última actualización