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:
- 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.
- 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.
Importar desde un fichero
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.
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,rarityy, por cada trait, tres: su valor,trait:<Name>, y su porcentaje y su rango,trait:<Name>:percentageytrait:<Name>:rarity. Soloitem_filees 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 conitem_file,name,number,rarityyattributes(cada atributo, untrait_type, unvaluey, opcionalmente, unpercentagey unrarity). 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.jsonde HashLips, tal cual. Sueditioncuenta como el número y suimagecomo 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.pnges7.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
Nonedejan 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:
| 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:
En la página de la colección, un filtro por traits que dice cuántas piezas llevan cada valor, y ordenar por rank:
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.