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), la Propuesta en 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 funcionalidad Linked Wearables.
Este documento está principalmente dirigido a representantes de comunidades de NFT que quieren dar a sus usuarios la capacidad de representar sus NFTs como wearables mientras pasean por Decentraland.
¿Qué son Linked Wearables?
Linked Wearables son representaciones 3D de NFTs que se originan fuera de Decentraland 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 pautas 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 u 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 funcionalidad lista para usar que ofrecer.
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 NFTs?
Los wearables se vinculan a tus NFTs creando una Linked Wearable Collection en el sitio Builder y configurando cómo se representarán tus NFTs al crear los wearables.
Admitimos 4 mecanismos para vincular tus wearables a los 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 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 Linked Wearables Collections
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 previamente fueron diseñados y modelados. Por ejemplo: CryptoPunks y BAYC son ejemplos de colecciones NFT 2D pfp que fueron creadas programáticamente.
Seguimos el mismo principio en Decentraland con las Linked Wearables Collections también; puede haber Standard Linked Wearable Collections para las colecciones hechas a mano y Programmatic Linked Wearable Collections 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 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 NFT, por esa razón, se requiere un contrato 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 Colecciones, haz clic en el botón Crear Colección del botón.
Selecciona la opción Linked Wearable Collection 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 está. 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 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 Nuevos ítems del botón.
Selecciona la opción Single items .
Sigue los pasos para subir y configurar tu wearable como se describe en las pautas para crear wearables y configura cómo se vinculará a tus NFTs. Consulta 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 Linked Wearables Collection - En Lote
Dado que las Linked Wearable collections pueden contener un gran número de ítems, 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 un ítem necesita para cada uno de los ítems. Subir wearables en lote se recomienda solo para colecciones programáticas.
Construyendo el ZIP del Wearable
Cada ítem requerirá que se construya un archivo ZIP que incluya los siguientes assets:
El requerido Archivos del modelo 3D del wearable (GLB, GLTFs, archivos de texturas, 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 el opcional thumbnail.png siguen la sección de Miniaturas Personalizadas en el artículo Subir 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 forma corporal:
Este archivo se comprimirá junto al aMaleModelFile.glb, aTextureFile.png, aFemaleModelFile.glb y anotherTextureFile.png.
Para añadir 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 el pautas para crear wearables.
El arreglo representations contendrá la información sobre cómo se verá cada forma corporal. Cada wearable DEBE contener al menos una representación (puede tener una o las dos), es decir, tomando en cuenta las formas corporales que actualmente tenemos, ya sea
urn:decentraland:off-chain:base-avatars:BaseMaleuurn:decentraland:off-chain:base-avatars:BaseFemale. Cada representación describirá qué modelos se usarán para cada forma corporal.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.
Configurar un ID o URN personalizado para los ítems
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 Lote (lo cual se explica más adelante en la sección Editar wearables en lote ).
En caso de que el id campo sea usado, 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 obtenerse desde la página de la colección y el item-id es el identificador personalizado del ítem 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. Sugerimos reemplazar los espacios en blanco con el
-
Puedes obtener el ID (o URN) desde la página de la colección siguiendo los siguientes pasos:
Entrar en la vista de la colección 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 interfaz 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 Nuevos ítems del botón.
Selecciona la Múltiples ítems .
Haz clic en el Explora tu equipo enlace para abrir tu administrador de archivos y selecciona 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 botón Añadir más y vuelve a subir los archivos fallidos con el mismo nombre o descartando los errores usando el ícono de basura en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Subir ítems.
¡Ten paciencia, esto puede tomar un tiempo!
¡Éxito! Tus ítems 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 establecer correctamente para qué tipo de colección estás creando ítems.
Errores comunes al subir ítems en lote
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 ningún
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 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 (tres puntos horizontales) a la derecha del ítem que quieres ver en el mundo. Aparecerá un desplegable. Selecciona Ver en Decentraland.
Se abrirá el Decentraland World. Navega a tu mochila para ver el wearable.
⚠️ Aviso: La vista previa en el mundo funciona con la Versión Web Obsoleta del Cliente de Decentraland. No es posible probarlos aún 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 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 una Linked Wearable Collection sigue estos pasos:
Haz clic en el menú de tres puntos (tres puntos horizontales) en el extremo derecho 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 Cancelar.
Editar un solo wearable
Editar propiedades del wearable
Para editar un solo wearable, sigue estos pasos:
Haz clic en el menú de tres puntos (tres puntos horizontales) a la derecha del ítem que quieres ver en el mundo. Aparecerá un desplegable. Selecciona Abrir en el editor.
Edita el wearable como se editan los wearables estándar. Sigue la sección Editar ítems en pautas para crear wearables sobre cómo crear una miniatura personalizada.
Editar el enlace del wearable
El enlace de los wearables con la colección 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 de vinculación desde la vista de la colección, 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.
sección Editar wearables en lote
Siguiendo la misma idea vista anteriormente en la sección Crear wearables en lote , los gestores third party pueden hacer cambios en 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 serán cambiados.
Estos archivos ZIP deben crearse siguiendo el formato descrito en sección Crear wearables en lote con una excepción, en el wearable.json archivo, la id propiedad 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 que será cambiado. Si creaste tus wearables en lote proporcionando un id en el wearable.json archivo, puedes reutilizar sus wearable.json archivos para actualizarlos.
Tomando en consideración el ejemplo en la sección Crear wearables en lote 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 ítems en lote:
Haz clic en el menú de tres puntos (tres puntos horizontales) en el extremo derecho del conjunto de botones. Aparecerá un desplegable. Selecciona Editar en lote.
Aparecerá un modal similar al de la subida de modelos en lote . Haz clic en el enlace Explora tu equipo para abrir tu administrador de archivos.
Selecciona todos los archivos ZIP de los ítems que serán editados.
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 botón Añadir más y vuelve a subir los archivos fallidos con el mismo nombre o descartando los errores usando el ícono de basura en la sección superior derecha del modal.
Sube todos los wearables haciendo clic en Subir ítems.
¡Ten paciencia, esto puede tomar un tiempo!
¡Éxito! Tus ítems ya están disponibles en tu colección. Consulta el post del foro para cualquier actualización del curador.
Publicando tus Linked Wearables
Tus Linked Wearables necesitan pasar por un proceso de publicación y curación como 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 ítems deben primero 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 dependiendo del tipo de Linked Wearable Collection que elijas construir:
Estándar: cada wearable publicado cuesta lo mismo que un wearable regular: 100 USD pagaderos en MANA.
Programática: una tarifa fija, pagada una sola vez por todos los wearables que publicarás. Esta tarifa 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 sección NFT Collections & Linked Wearables Collections sección.
Publicar wearables para revisión
Una vez que tus wearables estén listos, deben publicarse para la curación. Tus wearables se publican en grupos de ítems, puedes elegir qué ítems están listos para ser curados seleccionándolos y haciendo clic en el Publish botón. Después de publicar ítems, la publicación quedará bloqueada hasta que los que ya están publicados sean curados.
Para publicar tus wearables, necesitas:
Seleccionar los ítems a publicar haciendo clic en la casilla junto a ellos. Haz clic en el Publish botón cuando estés listo con tu selección.
Confirma el nombre de tu colección. Una vez que publiques tus ítems, cambiar el nombre de la colección no será posible, así que asegúrate de revisarlo detenidamente.
Revisa los ítems que estás publicando. Haz clic en el botón Confirmar ítems cuando estés listo.
Firma la confirmación de publicación de tus ítems en tu wallet.
Lee y acepta los Términos y Condiciones.
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 el contrato inteligente 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 red, esto puede tardar un poco.
¡Éxito! Has publicado tus ítems. Tus ítems pasarán por el proceso de curación que hacen las colecciones regulares. Puedes comunicarte con el curador a través del post 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 tarifas a los wearables ya publicados.
Para enviar cambios para que sean curados, necesitas:
Seleccionar los ítems con cambios haciendo clic en la casilla junto a ellos. Haz clic en el botón Push changes botón cuando estés listo con tu selección.
Procede con el proceso de envío de cambios. Como dice el modal, estos cambios deberán pasar por la fase de curación una vez más.
Lee y acepta los Términos y Condiciones. Al aceptarlos, los ítems estarán listos para ser curados nuevamente.
Curación
Al igual que 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 aún deben preservarse.
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.
Wearables hechos a mano
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 Curador deberá revisar todos los ítems de la colección individualmente para asegurarse de que todos cumplan con las Wearable Guidelines.
Colecciones programáticas
Para colecciones programáticas, no todos los ítems tienen que ser curados individualmente. El número de ítems a curar en cada colección depende del tamaño de la colección; esto fue definido por el DAO en esta propuesta.
Última actualización