Um trait é uma propriedade que uma peça tem: um Fundo que é Noite ou Dia, um Chapéu que é uma Coroa, um Boné ou nada de todo. Os traits são inscritos com cada peça, no formato que os indexadores 1Sat leem, por isso viajam com a peça para onde quer que vá — não só na Zoide.
É também por isso que merecem algum cuidado: o que é inscrito não pode ser corrigido. Tudo nesta página acontece antes de submeter, no separador Traits do passo Conteúdo.
Defina-os, depois atribua-os
Dois movimentos, em dois sítios:
- Defina-os no separador Traits: cada trait com os seus valores. O separador tem o seu próprio botão Guardar traits, e diz-lhe quantas peças levam cada valor.
- Atribua-os no separador Peças: cada peça tem um seletor por trait, guardado com Guardar tudo como o resto do seu formulário.
Importar de um ficheiro
Algumas regras que vale a pena conhecer antes de começar:
- Os nomes e os valores têm de 1 a 32 caracteres. Curtos de propósito — ver o limite de 1 024 bytes.
- Sem duplicados que só difiram em maiúsculas ou acentos: Café e cafe são o mesmo valor, e ao guardar é-lhe dito isso ao lado do segundo.
- None está reservado. Significa sem valor, que é o que uma peça tem quando não lhe atribui nenhum. Cada peça sem chapéu conta como None em Chapéu — e None conta nas percentagens como qualquer outro valor.
- Mudar o nome de um valor mantém-no nas peças que o tinham. Remover um deixa essas peças sem valor, e pergunta antes, dizendo-lhe quantas peças o levam.
- Os nomes e os valores são seus: aparecem tal como os escreveu, em todos os idiomas.
Quantos pode ter
| Traits por coleção | Valores por trait | Peças por coleção | |
|---|---|---|---|
| Sem subscrição | 3 | 10 | 100 |
| Com subscrição | 20 | 200 | 2,000 |
Quando atinge um limite, o separador di-lo e diz o que uma subscrição desbloqueia. Ver Subscrição.
Se a sua subscrição expirar enquanto um rascunho está acima dos limites, nada se perde: pode reduzi-lo, mas não aumentá-lo, e a Revisão bloqueia a submissão até o reduzir ou renovar.
A Zoide calcula as percentagens e os ranks
A Zoide conta quantas peças levam cada valor e transforma isso numa percentagem com duas casas decimais que soma sempre exatamente 100: o resto do arredondamento é repartido, por isso três valores que aparecem cada um num terço das peças saem como 33,34; 33,33 e 33,33.
Cada valor recebe depois um rank a partir da sua percentagem — o primeiro nível que a sua percentagem não ultrapassa:
| Um valor presente em… | é |
|---|---|
| 1% das peças ou menos | EXOTIC |
| 5% ou menos | LEGENDARY |
| 10% ou menos | EPIC |
| 20% ou menos | RARE |
| 40% ou menos | UNCOMMON |
| mais do que isso | COMMON |
Pode alterá-los
A coleção é sua. Ao lado de cada valor pode fixar a sua percentagem, e o seu rank. Deixe o campo vazio e aplica-se o calculado — que é mostrado ao lado de qualquer forma, como dica do campo e como Auto (EPIC), para que saiba sempre de que se está a afastar. Também podem vir no ficheiro de importação, já preenchidos.
Um trait cujas percentagens já não somam 100 bloqueia a submissão: dar mais a um valor significa dar menos a outro.
O rank de cada peça, e o sugerido
O rank de uma peça — de EXOTIC a COMMON — continua a ser seu para escolher, exatamente como em Prepare os seus itens. O que os traits acrescentam é uma sugestão. A partir dos traits que uma peça leva, a Zoide dá-lhe uma pontuação — quanto mais raros os seus valores, mais alta —, coloca-a entre as outras e sugere o nível, usando a mesma tabela, juntamente com a sua posição: rank 12 de 250.
Ao lado de cada seletor de trait, a peça mostra também quão raro é esse valor: a sua raridade, na sua cor, e a sua percentagem — as calculadas, ou as suas se as alterou. Uma peça sem valor num trait mostra as de None.
Se o rank que escolheu não for o sugerido, a Revisão menciona-o como aviso. Não o impede.
A posição — rank 1 a N, sendo 1 a mais rara — é o que fica inscrito e aquilo por que os colecionadores ordenam, e não é editável. É ordenada primeiro pelo rank que atribuiu, depois pela pontuação dos traits, depois pelo número da peça. Por isso a sua decisão vem primeiro, e os traits só desempatam.
O limite de 1 024 bytes
Os traits são inscritos nos metadados de cada peça, e os indexadores descartam em silêncio quaisquer metadados acima de 1 024 bytes. Com eles, a peça perde a ligação à coleção e desaparece dela. Por isso:
- Uma peça cujos metadados não caibam bloqueia a submissão. Nomes ou valores mais curtos, ou menos traits, resolvem-no.
- A capa leva a tabela de traits inteira, cada valor com a sua percentagem. Se isso não couber, a capa é inscrita sem a tabela e a Revisão avisa-o — os traits ficam em cada peça. Se não couber nem sem a tabela, a descrição é demasiado longa, e isso bloqueia.
Antes de submeter pode ver os dados exatos que cada peça e a capa vão levar, com o seu tamanho: Ver JSON on-chain. O id da coleção aparece como zeros, porque o real só existe depois de a capa ter sido inscrita.
O que a Revisão verifica
Assim que a coleção tem traits e peças, a Revisão acrescenta estas linhas. Cada uma que falhe tem um link Ver para onde se corrige: a lista de peças já filtrada nas que estão em causa, ou o separador Traits.
| Verificação | |
|---|---|
| Os % de cada trait somam 100 | Bloqueia |
| Cada peça cabe em 1 024 bytes | Bloqueia |
| Dentro dos limites do seu plano | Bloqueia |
| A capa cabe com a sua tabela de traits | Avisa se só couber sem a tabela; bloqueia se nem assim couber |
| Ranks dos valores como a Zoide os calcula | Avisa se alterou algum |
| Rank de cada peça como o sugerido pelos seus traits | Avisa se algum for diferente |
Importar uma coleção inteira de um ficheiro
Atribuir traits à mão a mil peças não é um plano. Se a sua coleção sai de um gerador, carregue antes o seu ficheiro. Importar é para subscritores; sem subscrição o cartão Importar de um ficheiro aparece desativado, e editar em bloco é o caminho.
As imagens continuam a passar pela zona de carregamento, como sempre. O ficheiro traz o resto — o nome, o número, o rank e os traits de cada peça — e cada linha é associada à sua imagem pelo nome que o ficheiro tinha quando o carregou. Cada peça no separador Peças mostra esse nome original, só de leitura, precisamente para que possa verificar a correspondência: do nosso lado o ficheiro é guardado com um nome aleatório.
Dois downloads, duas coisas diferentes
- Modelo de exemplo — três peças inventadas, só para mostrar o formato. Nada da sua coleção.
- Exportar a coleção — o que a sua coleção tem agora mesmo, uma linha por peça, para editar e voltar a carregar. Fica desativado enquanto não houver peças. Das percentagens e raridades, só preenche as que alterou: vazio significa calculado, por isso voltar a carregá-lo tal como está não muda nada.
Ambos vêm em CSV ou JSON, e ambos trazem todas as colunas, para que saiba sempre onde vai cada coisa.
Os formatos
- CSV — as colunas são
item_file,name,number,raritye, por cada trait, três: o seu valor,trait:<Name>, e a sua percentagem e raridade,trait:<Name>:percentageetrait:<Name>:rarity. Sóitem_fileé obrigatória. Vírgula, ponto e vírgula ou tabulação, é detetado, e o ficheiro abre sem problemas no Excel. As colunas que não entende são ignoradas, e o relatório diz quais. - JSON — uma lista em
items, cada entrada comitem_file,name,number,rarityeattributes(cada atributo umtrait_type, umvaluee, opcionalmente, umpercentagee umrarity). O JSON não admite comentários, por isso a explicação de cada campo viaja no topo como_guide, no seu idioma. As chaves que começam por_são ignoradas ao importar. - Um
_metadata.jsondo HashLips, tal como está. O seueditionconta como número e o seuimagecomo nome do ficheiro.
Dentro do ficheiro:
item_file— maiúsculas e minúsculas não importam, e num caminho ou num URL só conta a última parte:ipfs://…/7.pngé7.png.rarity— uma de EXOTIC a COMMON, em maiúsculas ou minúsculas. Vazia deixa o rank da peça como está, e UNRANKED retira-o.- Um trait que uma linha não traga, uma célula vazia ou
Nonedeixa a peça sem valor nele. - A percentagem e a raridade de um valor são opcionais. Vazias, a Zoide calcula-as; preenchidas, ficam tal como vêm, exatamente como ao alterá-las no separador Traits — uma percentagem de 0 a 100 com no máximo duas casas decimais, uma raridade de EXOTIC a COMMON. Pertencem ao valor, não à peça: repita as mesmas em todas as linhas que o tenham, ou preencha-as numa só linha e deixe as restantes vazias.
- Numa linha sem valor num trait, a percentagem é a de None. None não tem raridade própria.
- Se o ficheiro não trouxer de todo essas colunas ou chaves — um ficheiro do HashLips tal como sai, por exemplo —, as percentagens e raridades que alterou ficam como estão.
- As percentagens de um trait, None incluído, continuam a ter de somar 100: se não somarem depois da importação, o relatório avisa-o, e a Revisão bloqueará a submissão até que somem.
Validar, depois confirmar
Validar não altera nada. Devolve um relatório: quantas linhas correspondem à sua imagem, o que mudaria e o que está mal.
O que está a vermelho bloqueia a importação inteira — nada é importado até ser corrigido:
- o ficheiro não pode ser lido, não tem linhas ou não tem coluna
item_file, ou nenhuma linha corresponde a uma imagem carregada; - mais linhas do que as peças que o seu plano permite;
- a mesma imagem em duas linhas;
- nomes ou valores de trait vazios ou demasiado longos, ou mais do que o seu plano permite;
- nomes de peça vazios ou com mais de 50 caracteres, raridades que não existem, números que não são inteiros positivos, ou números que o ficheiro deixaria repetidos na coleção;
- percentagens que não são um número de 0 a 100, raridades de valor que não existem, ou o mesmo valor com uma percentagem ou uma raridade diferente em duas linhas.
O que está a amarelo é reportado mas não a impede: linhas sem imagem carregada com esse nome, peças que o ficheiro não menciona (ficam como estão), vários carregamentos com o mesmo nome (essas linhas são ignoradas), colunas que não entende, linhas sem nome de ficheiro, uma raridade numa linha sem valor, e traits cujas percentagens não somariam 100.
Confirmar a importação valida outra vez e escreve tudo de uma vez, ou nada. Antes disso, o que tivesse pendente na página é guardado, para que a importação não caia por cima de trabalho por guardar nem seja depois sobrescrita por ele.
Importar de novo
O ficheiro só decide sobre o que traz:
- para cada trait que traz, cada peça que lista fica com o valor da sua linha, e uma célula vazia limpa-o;
- os traits que não traz não são tocados;
- o nome, o número e a raridade só mudam onde a linha os tem;
- a percentagem e a raridade de um valor só mudam nos traits cujas colunas ou chaves o ficheiro traz.
Importar de novo atualiza pelo nome do ficheiro: nunca cria peças — isso faz a zona de carregamento — e nunca duplica traits nem valores. Por isso a ida e volta é segura: exportar, editar, importar.
Mil linhas importam-se em cerca de um segundo; não há fila de espera.
Editar muitas peças de uma vez
Importe ou não, o separador Peças está feito para trabalhar sobre centenas de peças:
- Procure por nome, número ou nome do ficheiro original.
- Filtre por trait: um valor, ou sem valor num trait. Vários filtros ao mesmo tempo têm de se cumprir todos.
- Selecione peças uma a uma, todas as carregadas, ou todas as peças do filtro, carregadas ou não.
Depois aplique uma ação a todas elas:
| Ação | O que faz |
|---|---|
| Pôr ou tirar um trait | Põe um valor existente em todas, ou limpa-o. Não cria traits nem valores, por isso não o pode levar para lá dos limites do seu plano |
| Pôr uma raridade | O mesmo nível em todas. UNRANKED retira-o |
| Renomear com padrão | Rã #{n} dá a cada uma o nome com o seu próprio número. O padrão tem de incluir {n}: sem ele, todas ficariam com o mesmo nome |
| Renumerar 1..N | A coleção inteira, não a seleção: de 1 a N, pela ordem atual, sem buracos |
Pergunta primeiro, com a contagem — vai alterar 80 peças — e guarda o que estivesse pendente antes de aplicar. A lista, o gráfico e a Revisão atualizam-se sem recarregar.
O uso típico: filtre por sem valor em Hat, selecione todas as peças do filtro, ponha Hat: Cap.
O que os colecionadores veem
Na página de uma peça, os seus traits — cada um com a sua percentagem e o rank dessa percentagem — e a sua posição na coleção:
Na página da coleção, um filtro por trait que diz quantas peças levam cada valor, e a ordenação por rank:
Ambos são lidos da cadeia, não da base de dados da Zoide. É por isso que também funcionam para qualquer coleção 1Sat que traga traits, não só para as publicadas aqui. Ver O que a página de uma peça lhe diz.