Traits de la colección

Dale a cada pieza sus propiedades y deja que Zoide calcule lo rara que es cada una. Cuántos puedes definir con tu plan, el límite de 1.024 bytes, importar una colección entera desde un fichero, editar cientos de piezas a la vez y lo que acaban viendo los coleccionistas.

Un trait es una propiedad que tiene una pieza: un fondo (Background) que es Night o Day, un sombrero (Hat) que es Crown, Cap o nada en absoluto. Los traits se inscriben con cada pieza, en el formato que leen los indexadores de 1Sat, así que viajan con la pieza vaya donde vaya — no solo en Zoide.

Por eso mismo merecen un poco de cuidado: lo que se inscribe no se puede corregir. Todo lo de esta página pasa antes de enviar, en la pestaña Traits del paso Contenido.

Defínelos, y después asígnalos

Dos movimientos, en dos sitios:

  1. Defínelos en la pestaña Traits: cada trait con sus valores. La pestaña tiene su propio botón Guardar traits, y te dice cuántas piezas llevan cada valor.
  2. Asígnalos en la pestaña Piezas: cada pieza tiene un selector por trait, que se guarda con Guardar todo como el resto de su formulario.
%
25 piezas
%
150 piezas
None
%
Sin valor: 75 piezas
Añadir valor Suma: 100.00 %

Importar desde un fichero

Plantilla de ejemplo Exportar la colección
Validar
La pestaña Traits, con un trait y sus tres valores. Una copia de la real, que se mantiene al día con ella.

Unas cuantas reglas que conviene saber antes de empezar:

  • Los nombres y los valores tienen de 1 a 32 caracteres. Cortos a propósito — mira el límite de 1.024 bytes.
  • Nada de duplicados que solo se diferencien en mayúsculas o acentos: Café y cafe son el mismo valor, y al guardar te lo dice junto al segundo.
  • None está reservado. Significa sin valor, que es lo que tiene una pieza cuando no le asignas ninguno. Toda pieza sin sombrero cuenta como None en Hat — y None cuenta en los porcentajes como cualquier otro valor.
  • Renombrar un valor lo mantiene en las piezas que lo tenían. Quitar uno deja esas piezas sin valor, y pregunta antes, diciéndote cuántas piezas lo llevan.
  • Los nombres y los valores son tuyos: se muestran tal como los escribiste, en todos los idiomas.

Cuántos puedes tener

Traits por colección Valores por trait Piezas por colección
Sin suscripción 3 10 100
Con suscripción 20 200 2,000

Cuando llegas a un límite, la pestaña te lo dice y te dice qué desbloquea una suscripción. Mira Suscripción.

Si tu suscripción caduca mientras un borrador está por encima de los límites, no se pierde nada: puedes recortarlo, pero no ampliarlo, y Revisión bloquea el envío hasta que lo recortes o renueves.

Los porcentajes y los rangos se calculan solos

Zoide cuenta cuántas piezas llevan cada valor y lo convierte en un porcentaje con dos decimales que siempre suma exactamente 100: el resto del redondeo se reparte, así que tres valores que aparecen un tercio de las veces cada uno salen como 33.34, 33.33 y 33.33.

Después, cada valor recibe un rango según su porcentaje — el primer nivel que su porcentaje no supera:

Un valor que llevan… es
el 1% de las piezas o menos EXOTIC
el 5% o menos LEGENDARY
el 10% o menos EPIC
el 20% o menos RARE
el 40% o menos UNCOMMON
más que eso COMMON

Puedes retocarlos

La colección es tuya. Junto a cada valor puedes fijar su porcentaje, y su rango. Deja el campo vacío y se aplica el calculado — que se muestra al lado en cualquier caso, como pista del campo y como Auto (EPIC), así que siempre sabes de qué te estás apartando. También pueden venir en el fichero de importación, ya rellenos.

Un trait cuyos porcentajes ya no suman 100 bloquea el envío: darle más a un valor significa darle menos a otro.

El rango de cada pieza, y el sugerido

El rango de una pieza — de EXOTIC a COMMON — sigue siendo decisión tuya, exactamente como en Preparar tus elementos. Lo que añaden los traits es una sugerencia. A partir de los traits que lleva una pieza, Zoide le da una puntuación — cuanto más raros sus valores, más alta —, la sitúa entre las demás y sugiere el nivel, con la misma tabla, junto con su posición: rank 12 de 250.

12.png
Sugerido: RARE · rank 12 de 250
COMMON · 60.00 %
EPIC · 10.00 %
El formulario de una pieza con sus dos traits y, bajo su rango, la sugerencia

Junto a cada selector de trait, la pieza muestra también lo raro que es ese valor: su rango, en su color, y su porcentaje — los calculados, o los tuyos si los retocaste. Una pieza sin valor en un trait muestra los de None.

Si el rango que elegiste no es el sugerido, Revisión lo menciona como aviso. No te lo impide.

La posición — rank 1 a N, donde el 1 es la más rara — es lo que se inscribe y por lo que ordenan los coleccionistas, y no se puede editar. Se ordena primero por el rango que asignaste, después por la puntuación de los traits y después por el número de la pieza. Así que tu decisión va primero, y los traits solo deshacen los empates.

El límite de 1.024 bytes

Los traits se inscriben en los metadatos de cada pieza, y los indexadores descartan sin avisar cualquier metadato de más de 1.024 bytes. Con él, la pieza pierde su vínculo con la colección y desaparece de ella. Así que:

  • Una pieza cuyos metadatos no caben bloquea el envío. Se arregla con nombres o valores más cortos, o con menos traits.
  • La portada lleva la tabla de traits entera, cada valor con su porcentaje. Si eso no cabe, la portada se inscribe sin la tabla y Revisión te avisa — los traits siguen en cada pieza. Si no cabe ni sin la tabla, la descripción es demasiado larga, y eso bloquea.

Antes de enviar puedes ver los datos exactos que llevarán cada pieza y la portada, con su tamaño: Ver JSON on-chain. El id de la colección sale como ceros, porque el real solo existe cuando la portada se ha inscrito.

Qué comprueba Revisión

Cuando la colección tiene traits y piezas, Revisión añade estas líneas. Cada una que falla tiene un enlace Ver a donde se arregla: la lista de piezas ya filtrada en las afectadas, o la pestaña Traits.

Comprobación
Los % de cada trait suman 100 Bloquea
Cada pieza cabe en 1.024 bytes Bloquea
Dentro de los límites de tu plan Bloquea
La portada cabe con su tabla de traits Avisa si solo cabe sin la tabla; bloquea si no cabe ni así
Rangos de los valores como los calcula Zoide Avisa si has retocado alguno
Rango de cada pieza como el sugerido por sus traits Avisa si alguno es distinto

Importar una colección entera desde un fichero

Asignar traits a mano a mil piezas no es un plan. Si tu colección sale de un generador, sube su fichero. Importar es para suscriptores; sin suscripción la tarjeta se muestra desactivada, y editar en bloque es el camino.

Las imágenes siguen pasando por la zona de subida, como siempre. El fichero trae el resto — el nombre, el número, el rango y los traits de cada pieza — y cada fila se empareja con su imagen por el nombre que tenía el fichero cuando lo subiste. Cada pieza de la pestaña Piezas muestra ese nombre original, de solo lectura, precisamente para que puedas comprobar el emparejamiento: por nuestra parte el fichero se guarda con un nombre aleatorio.

Dos descargas, dos cosas distintas

  • Plantilla de ejemplo — tres piezas inventadas, solo para enseñar el formato. Nada de tu colección.
  • Exportar la colección — lo que tiene tu colección ahora mismo, una fila por pieza, para editarlo y volver a subirlo. Está desactivado mientras no haya piezas. De los porcentajes y rangos, solo rellena los que retocaste: vacío significa calculado, así que volver a subirlo tal cual no cambia nada.

Las dos vienen en CSV o en JSON, y las dos llevan todas las columnas, así que siempre sabes dónde va cada cosa.

Los formatos

  • CSV — las columnas son item_file, name, number, rarity y, por cada trait, tres: su valor, trait:<Name>, y su porcentaje y su rango, trait:<Name>:percentage y trait:<Name>:rarity. Solo item_file es obligatoria. Coma, punto y coma o tabulador: se detecta solo, y el fichero se abre bien en Excel. Las columnas que no entiende se ignoran, y el informe dice cuáles.
  • JSON — una lista bajo items, cada entrada con item_file, name, number, rarity y attributes (cada atributo, un trait_type, un value y, opcionalmente, un percentage y un rarity). JSON no admite comentarios, así que la explicación de cada campo viaja arriba como _guide, en tu idioma. Las claves que empiezan por _ se ignoran al importar.
  • Un _metadata.json de HashLips, tal cual. Su edition cuenta como el número y su image como el nombre del fichero.

Dentro del fichero:

  • item_file — no distingue mayúsculas, y en una ruta o una URL solo cuenta la última parte: ipfs://…/7.png es 7.png.
  • rarity — uno de EXOTIC a COMMON, en mayúsculas o minúsculas. Vacío deja el rango de la pieza como está, y UNRANKED se lo quita.
  • Un trait que una fila no trae, una celda vacía o None dejan la pieza sin valor en ese trait.
  • El porcentaje y el rango de un valor son opcionales. Vacíos, los calcula Zoide; rellenos, se fijan tal cual vienen, exactamente como al retocarlos en la pestaña Traits — un porcentaje de 0 a 100 con dos decimales como mucho, un rango de EXOTIC a COMMON. Son del valor, no de la pieza: repite los mismos en todas las filas que lo llevan, o rellénalos en una sola fila y deja las demás vacías.
  • En una fila sin valor en un trait, el porcentaje es el de None. None no tiene rango propio.
  • Si el fichero no trae esas columnas o claves en absoluto — un fichero de HashLips tal como sale, por ejemplo —, los porcentajes y rangos que retocaste se quedan como están.
  • Los porcentajes de un trait, None incluido, tienen que seguir sumando 100: si tras la importación no lo hicieran, el informe te avisa, y Revisión bloqueará el envío hasta que sumen.

Validar, y después confirmar

Validar no cambia nada. Devuelve un informe: cuántas filas casan con su imagen, qué cambiaría y qué está mal.

Lo que sale en rojo bloquea la importación entera — no se importa nada hasta que se arregle:

  • el fichero no se puede leer, no tiene filas o no tiene columna item_file, o ninguna fila casa con una imagen subida;
  • más filas que piezas admite tu plan;
  • la misma imagen en dos filas;
  • nombres o valores de trait vacíos o demasiado largos, o más de los que admite tu plan;
  • nombres de pieza vacíos o de más de 50 caracteres, rangos que no existen, números que no son enteros positivos, o números que el fichero dejaría repetidos en la colección;
  • porcentajes que no son un número de 0 a 100, rangos de valor que no existen, o el mismo valor con un porcentaje o un rango distinto en dos filas.

Lo que sale en amarillo se informa pero no la detiene: filas sin una imagen subida con ese nombre, piezas que el fichero no menciona (se quedan como están), varias subidas con el mismo nombre (esas filas se saltan), columnas que no entiende, filas sin nombre de fichero, un rango en una fila sin valor, y traits cuyos porcentajes no sumarían 100.

Confirmar la importación vuelve a validar y lo escribe todo de una vez, o nada. Antes de hacerlo se guarda lo que tuvieras pendiente en la página, así que la importación ni cae encima de trabajo sin guardar ni queda pisada por él después.

Volver a importar

El fichero solo decide sobre lo que trae:

  • en cada trait que lleva, cada pieza que lista acaba con el valor de su fila, y una celda vacía lo borra;
  • los traits que no lleva no se tocan;
  • el nombre, el número y el rango solo cambian donde la fila los tiene;
  • el porcentaje y el rango de un valor solo cambian en los traits cuyas columnas o claves trae el fichero.

Volver a importar actualiza por nombre de fichero: nunca crea piezas — eso lo hace la zona de subida — y nunca duplica traits ni valores. Así que el viaje de ida y vuelta es seguro: exportar, editar, importar.

Mil filas se importan en un segundo, más o menos; no hay cola que esperar.

Editar muchas piezas a la vez

Importes o no, la pestaña Piezas está hecha para trabajar con cientos de piezas:

  • Busca por nombre, número o nombre original del fichero.
  • Filtra por trait: un valor, o sin valor en un trait. Varios filtros a la vez tienen que cumplirse todos.
  • Selecciona piezas una a una, todas las cargadas o todas las piezas del filtro, cargadas o no.

Después aplica una acción a todas ellas:

Seleccionar las cargadas Seleccionar las 80 del filtro 80 seleccionada(s) Quitar selección Renumerar 1..N
Aplicar
Ochenta piezas seleccionadas a través del filtro, a punto de recibir el valor Cap
Acción Qué hace
Poner o quitar un trait Pone un valor existente en todas, o lo quita. No crea traits ni valores, así que no te puede llevar por encima de los límites de tu plan
Poner un rango El mismo nivel en todas. UNRANKED lo quita
Renombrar con patrón Frog #{n} nombra cada una con su propio número. El patrón tiene que llevar {n}: sin él, todas se llamarían igual
Renumerar 1..N La colección entera, no la selección: de 1 a N, en su orden actual, sin huecos

Pregunta antes, con el recuento — vas a cambiar 80 piezas — y guarda lo pendiente antes de aplicar. La lista, el gráfico y Revisión se actualizan sin recargar.

El uso típico: filtrar sin valor en Hat, seleccionar todas las piezas del filtro, poner Hat: Cap.

Lo que ven los coleccionistas

En la página de una pieza, sus traits — cada uno con su porcentaje y el rango de ese porcentaje — y su posición en la colección:

Rank #12 de 250
Background Night 60.00% COMMON
Hat Crown 10.00% EPIC
El bloque de traits de la página de una pieza

En la página de la colección, un filtro por traits que dice cuántas piezas llevan cada valor, y ordenar por rank:

Quitar
Background
Hat
El filtro por traits de la página de una colección, con Night marcado

Las dos cosas se leen de la cadena, no de la base de datos de Zoide. Por eso funcionan también con cualquier colección 1Sat que lleve traits, no solo con las publicadas aquí. Mira Qué te dice la página de una pieza.