Wearables vinculados
Representaciones de Wearables de tokens de terceros
Acerca de
De acuerdo con la propuesta inicial del DAO para Linked Wearables (anteriormente llamada: Third Party Wearables), la Propuesta de borrador 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 función Linked Wearables.
Este documento está orientado principalmente a representantes de comunidades de NFT que quieren dar a sus usuarios la capacidad de representar sus NFT como wearables al pasear por Decentraland.
¿Qué son los Linked Wearables?
Los Linked Wearables son representaciones 3D de NFT que provienen de fuera de Decentraland y que pueden usarse como wearables en el mundo, pueden equiparse en el avatar y se encuentran en el backpack. No son wearables regulares. Se ven igual y siguen los wearables regulares guías pero tienen un significado completamente diferente.
Los Linked Wearables no existen dentro de las colecciones tradicionales de wearables (pertenecen a un tipo especial de colección), no tienen rareza y no pueden venderse en primary o secondary marketplaces. Solo son representaciones in-world vinculadas a NFT externos.
Imagina que tienes un proyecto de 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 backpack de Decentraland. Linked Wearables te permite enviar representaciones 3D de tus NFT como wearables en Decentraland. No hace falta mintear un nuevo token, ¡y tu proyecto actual de NFT tendrá una nueva función lista para usar!
Todos los Linked Wearables se definen dentro de una Linked Wearable Collection. Veremos cómo crear una más adelante en el artículo.
¿Cómo representan los Linked Wearables a los NFT?
Los wearables se vinculan a tus NFT creando una Linked Wearable Collection en el sitio Builder y estableciendo cómo se representarán tus NFT en el momento de crear los wearables.
Admitimos 4 mecanismos para vincular tus wearables con NFT. Todos estos mecanismos usan el token id de los NFT para hacer la coincidencia.
La siguiente tabla muestra los mecanismos mencionados:
Todos los NFT
Un usuario que posea cualquiera de los NFT 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 NFT
Un usuario que posea uno de varios NFT especificados por TOKEN IDs, descritos separados por una coma, 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 NFT
Un usuario que posea uno de varios NFT especificados dentro del 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 Linked Wearables Collections
Normalmente hay dos tipos de colecciones de NFT:
Hechas a mano: donde cada token asset está hecho a medida, o hecho a mano, sin ningún proceso de automatización.
Programáticas: donde cada token asset no se elaboró individualmente a mano, sino que se generó automáticamente con código, muchas veces a partir de rasgos que se diseñaron y modelaron previamente. Por ejemplo: CryptoPunks y BAYC son ejemplos de colecciones de NFT de pfp 2D que se crearon de forma programática.
Seguimos el mismo principio en Decentraland con las Linked Wearables Collections también; puede haber Linked Wearable Collections Estándar para las colecciones hechas a mano y Linked Wearable Collections Programáticas para las generadas automáticamente. Ambas colecciones difieren en los costos de las fees de publicación que tiene el wearable. Consulta la sección de Costos para más información sobre las fees de publicación.
Crear Linked Wearables
Crear una Linked Wearable Collection
Crear una Linked Wearable collection 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 de NFT; por esa razón, se requiere un contrato de NFT (compatible con ERC721 o ERC1155) para crear una Linked Wearable Collection.
Para crear un nuevo Linked Wearable, sigue estos pasos:
En la sección de Collection's, haz clic en el Create Collection .
Selecciona la opción Linked Wearable Collection haciendo clic en el Create Collection botón dentro de la sección Linked Collections.
Elige un nombre para la colección y vincula la colección a tu colección de NFT configurando la dirección de su contrato y la red en la que se encuentra. El contrato se validará para asegurarse de que cumple con los estándares de contratos NFT.
Haz clic en el botón Create botón para crear la colección.
Agregar wearables a la Linked Wearables Collection - 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 botón New items .
Selecciona la opción Singe items .
Sigue los pasos para subir y configurar tu wearable tal como se describe en las guías para crear wearables y configura cómo se vinculará a tus NFT. Consulta la sección "¿Cómo representan los Linked Wearables a los NFT?" para más información sobre cómo configurarlo.
Agregar wearables a la Linked Wearables Collection - En lote
Como las colecciones Linked Wearable pueden contener un gran número de elementos, es posible subir los modelos 3D y la información de los wearables en lote. Este proceso implica crear un archivo zip con todos los assets que necesita un item para cada uno de los items. Se recomienda subir wearables en lote solo para colecciones programáticas.
Construir el ZIP del Wearable
Cada item requerirá que se cree 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 usando el modelo 3D.
Los modelos 3D y la opción thumbnail.png siguen la sección Custom Thumbnails en el artículo Uploading Wearables sobre cómo crear una miniatura personalizada.
El wearable.json que acompaña el contenido de los wearables tiene el siguiente formato (escrito como lo haría TypeScript):
A continuación se muestra 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 agregar un thumbnail.png archivo.
Algunas cosas a tener en cuenta sobre el wearable.json archivo:
Toda la información sobre las categorías de wearables y cuál elegir se puede encontrar en la guías 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, teniendo en cuenta los body shapes que tenemos actualmente, 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 con uno de los mecanismos disponibles para vincular tu NFT con tu wearable, siguiendo la sección "¿Cómo representan los Linked Wearables a los NFT?".
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 se actualizará en el futuro en lote (lo cual se explica más adelante en la sección Editing wearables in bulk ).
En caso de que se use el campo id 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 se puede obtener de la página de la colección 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
aaz.Todos los números.
No pueden contener otro tipo de caracteres ni espacios en blanco. Sugerimos reemplazar los espacios en blanco con el
-
Puedes obtener el ID (o URN) de la página de la colección siguiendo estos pasos:
Entrando en la vista de la colección desde la que quieres copiar el URN y haciendo clic en la opción Edit URN del menú de opciones:
Copiando el identificador que está debajo del campo de texto:
Por ejemplo, si el URN o ID obtenido de la UI para la colección 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 lote, sigue estos pasos:
Haz clic en el botón New items .
Selecciona la opción Multiple items .
Haz clic en el botón Browse yor computer 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 corregidos. En este caso, el modelo del wearable no está configurado 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 papelera en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Upload items.
¡Ten paciencia, esto puede tardar un poco!
¡Éxito! Tus items ya están disponibles en tu colección.
Selecciona si tu colección es programática o estándar. Consulta la sección NFT Collections & Linked Wearables Collections para configurar correctamente para qué tipo de colección 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 colección.No hay
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 que 3 MB. Los Linked Wearables tienen la misma limitación que los wearables regulares en cuanto a tamaño que los estándar.
La imagen de miniatura personalizada opcional 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 meatballs (tres puntos horizontales) a la derecha del item que quieres ver en el mundo. Aparecerá un dropdown. Selecciona Ver en Decentraland.
Se abrirá Decentraland World. Navega hasta tu backpack para ver el wearable.
⚠️ Aviso: La vista previa en el mundo funciona con la versión web obsoleta del Decentraland Client. Todavía no es posible probarlos en el Decentraland Desktop Client 2.0.
Editar Linked Wearables
Editar el nombre de la colección
Una colección puede ser renombrada por su creador solo si la colección no tiene wearables publicados.
Para editar el nombre de una Linked Wearable Collection, sigue estos pasos:
Haz clic en el nombre de la colección.
Elige un nuevo nombre para la colección y haz clic en el botón de guardar.
Eliminar la colección
Una colección puede ser eliminada por su propietario solo si la colección no tiene wearables publicados.
Para eliminar Linked Wearable Collection, sigue estos pasos:
Haz clic en el menú de meatballs (tres puntos horizontales) en el extremo derecho del conjunto de botones. Aparecerá un dropdown. Selecciona Delete.
Aparecerá un modal de confirmación; si deseas continuar, haz clic en Ok, de lo contrario haz clic en Cancel.
Editar un wearable individual
Editar propiedades del wearable
Para editar un wearable individual, sigue estos pasos:
Haz clic en el menú de meatballs (tres puntos horizontales) a la derecha del item que quieres ver en el mundo. Aparecerá un dropdown. Selecciona Open in editor.
Edita el wearable como se editan los wearables estándar. Sigue la sección Editing items en guías para crear wearables sobre cómo crear una miniatura personalizada.
Editar el enlace del wearable
El enlace de los wearables con la colección de NFT es una de las propiedades más importantes de un Linked Wearable. Para editar cómo se vinculan a los NFT, puedes cambiar rápidamente el valor de enlace desde la vista de la colección, sin necesidad de navegar a otra página.
Consulta la sección "¿Cómo representan los Linked Wearables a los NFT?" para más información sobre cómo vincular tus wearables.
sección Editing wearables in bulk
Siguiendo la misma idea vista anteriormente en la Crear wearables en lote sección, los managers de terceros pueden hacer cambios a los wearables en lote.
Para hacer cambios en lote a los wearables, es necesario crear un archivo ZIP para cada uno de los wearables que se cambiarán.
Estos archivos ZIP deben crearse siguiendo el formato descrito en Crear wearables en lote con una excepción: en el wearable.json archivo, la id propiedad DEBE configurarse con el id o URN del wearable que se va a cambiar. Esto es obligatorio, ya que es la única manera de identificar el wearable que se cambiará. Si creaste tus wearables en lote proporcionando un id en el archivo wearable.json puedes reutilizar sus wearable.json archivos para actualizarlos.
Tomando en consideración el ejemplo de la sección Crear wearables en lote si quisiéramos cambiar algunas de las propiedades de un wearable, por ejemplo, el nombre al que olvidamos añadirle un número, deberíamos incluir un archivo wearable.json en el zip como en el siguiente ejemplo:
Donde el id campo está configurado con el id o URN del wearable que se cambiará 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 lote:
Haz clic en el menú de meatballs (tres puntos horizontales) en el extremo derecho del conjunto de botones. Aparecerá un dropdown. Selecciona Editar en lote.
Aparecerá un modal similar al de la sección Subir modelos en lote . Haz clic en el Browse your computer enlace para abrir tu gestor de archivos.
Selecciona todos los archivos ZIP de los items que se editarán.
Revisa si todos los archivos son correctos o si necesitan ser corregidos. En este caso, el modelo del wearable no está configurado 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 papelera en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Upload items.
¡Ten paciencia, esto puede tardar un poco!
¡Éxito! Tus items ya están disponibles en tu colección. Consulta la publicación del foro para ver cualquier actualización del curador.
Publicar tus Linked Wearables
Tus Linked Wearables deben pasar por un proceso de publicación y curación, 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 primero deben publicarse para luego ser curados por un curador asignado.
Las siguientes secciones te mostrarán cómo publicar tus Linked Wearables para que sean curados.
Costos
Crear Linked Wearables tiene un costo que depende del tipo de Linked Wearable Collection que hayas elegido construir:
Estándar: cada wearable publicado cuesta lo mismo que un wearable regular: USD 100 pagaderos en MANA.
Programática: una fee fija, pagada una sola vez por todos los wearables que publicarás. Esta fee equivale a publicar 20 wearables regulares: 2000 USD pagaderos en MANA.
Para más información sobre el tipo de colección que estás creando, consulta la NFT Collections & Linked Wearables Collections .
Publicar wearables para revisión
Una vez que tus wearables estén listos, deben publicarse para su 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 botón Publish . 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:
Seleccionar los items que se publicarán haciendo clic en la casilla de verificación junto a ellos. Haz clic en el Publish botón cuando hayas terminado con tu selección.
Confirma el nombre de tu colección. Una vez que publiques tus items, no será posible cambiar el nombre de la colección, así que asegúrate de revisarlo bien.
Revisa los items que vas a publicar. Haz clic en el Confirm items botón cuando estés listo.
Firma en tu wallet la confirmación de publicación de tus items.
Lee y revisa los Términos y Condiciones.
Revisa tus publication fees. Las fees 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 fees de publicación desde tu wallet.
Paga la fee de publicación y completa la publicación realizando la transacción. Dependiendo de la congestión de la red, esto puede tardar un poco.
¡Éxito! Has publicado tus items. Tus items pasarán por el proceso de curación como lo hacen las colecciones regulares. Puedes comunicarte con el curador a través de la publicación del foro.
Enviar cambios para revisión
Los wearables publicados y aprobados que se editen deben pasar por el proceso de curación nuevamente. No te preocupes, no se aplicarán fees a los wearables ya publicados.
Para enviar cambios y que sean curados, necesitas:
Selecciona los items con cambios haciendo clic en la casilla de verificación junto a ellos. Haz clic en el Push changes botón cuando hayas terminado con tu selección.
Continúa con el proceso de envío de cambios. Como indica el modal, estos cambios tendrán que pasar nuevamente por la fase de curación.
Lee y revisa los Términos y Condiciones. Al aceptarlos, los items estarán listos para ser curados de nuevo.
Curación
Como con los wearables regulares, tus modelos 3D necesitarán la aprobación del Comité de Curadores. No estás exento de esta regla, ya que la estética y la jugabilidad de Decentraland siguen necesitando protección.
El proceso de curación diferirá según el proceso usado para generar los wearables. Las Linked Wearables collections admiten wearables hechos a mano y generados de forma programática.
Wearables hechos a mano
Para los modelos 3D que se hicieron individualmente sin ningún proceso automatizado (el método habitual para la mayoría de los wearables regulares), el Curator tendrá que revisar todos los items de la colección individualmente para asegurarse de que todos cumplan con las Wearable Guidelines.
Colecciones programáticas
Para las colecciones programáticas, no todos los items tienen que ser curados individualmente. El número de items que se curarán en cada colección depende del tamaño de la colección; esto fue definido por el DAO en esta propuesta.
Última actualización