合集属性

给每件作品赋予它的属性,让 Zoide 算出每一个有多稀有。你的方案能定义多少个、1024 字节的上限、从文件导入整个合集、一次编辑几百件作品,以及收藏者最终会看到什么。

属性(trait)是一件作品所具有的一项特征:一个是 Night 还是 Day 的 Background(背景),一个是 Crown、Cap 还是什么都没有的 Hat(帽子)。属性会随每件作品一起被铭刻,用的是 1Sat 索引器 读取的格式,所以不管作品去到哪里,它们都跟着走——不只是在 Zoide 上。

这也是为什么它们值得花点心思:铭刻上去的东西无法更正。本页讲的一切都发生在你提交之前,在内容 步骤的属性标签页里。

先定义,再分配

两个动作,在两个地方:

  1. 在属性标签页里定义它们:每个属性和它的取值。这个标签页有自己的保存属性按钮,并会告诉你 每个取值有多少件作品带着。
  2. 在作品标签页里分配它们:每件作品针对每个属性都有一个选择器,和它表单的其余部分一样,用 全部保存来保存。
%
25 件
%
150 件
None
%
无取值:75 件
添加取值 合计:100.00 %

从文件导入

示例模板 导出合集
验证
属性标签页,带着一个属性和它的三个取值。真实标签页的一份副本,与它保持同步。

开始之前值得知道的几条规则:

  • 名称和取值都是 1 到 32 个字符。故意这么短——见 1024 字节的上限。
  • 不能有只在大小写或重音上不同的重复项:Café 和 cafe 是同一个取值,保存时会在第二个旁边提示你。
  • None 是保留值。 它的意思是无取值,也就是你没给一件作品分配取值时它的状态。每件没戴帽子的作品, 在 Hat 里都计为 None——而 None 和其他任何取值一样计入百分比。
  • 重命名一个取值,原来带着它的作品仍然保留它。删除一个取值,会让那些作品变成无取值,而且删除前 会先询问你,并告诉你有多少件作品带着它。
  • 名称和取值都是你自己的:它们会按你写的样子显示,在每一种语言里都一样。

你能有多少

每个合集的属性数 每个属性的取值数 每个合集的作品数
没有订阅 3 10 100
有订阅 20 200 2,000

达到上限时,这个标签页会告诉你,并说明订阅能解锁什么。见 订阅。

如果你的订阅在某个草稿超出限制时失效,什么都不会丢失:你可以删减它,但不能再扩充它,而在你删减它 或续订之前,检查会阻止提交。

百分比和等级会替你算好

Zoide 会统计每个取值有多少件作品带着,并把它换算成一个保留两位小数的百分比,合计永远正好是 100: 四舍五入的余数会被分摊出去,所以三个各占三分之一的取值,结果是 33.34、33.33 和 33.33。

然后每个取值会根据它的百分比得到一个等级——也就是它的百分比不超过的第一个档位:

带着这个取值的作品占…… 它就是
不超过 1% EXOTIC
不超过 5% LEGENDARY
不超过 10% EPIC
不超过 20% RARE
不超过 40% UNCOMMON
超过以上 COMMON

你可以修改它们

合集是你的。每个取值旁边,你都可以固定它的百分比和它的等级。把字段留空,就使用计算出来的 值——而且不管怎样,计算值都会显示在旁边,既作为字段的提示,也以 自动(EPIC) 这样的形式出现,所以 你永远知道自己偏离的是什么。它们也可以在导入文件里直接 填好带过来。

一个百分比合计不再是 100 的属性会阻止提交:给一个取值多一点,就得给另一个少一点。

每件作品的等级,以及建议的等级

一件作品的等级——从 EXOTIC 到 COMMON——仍然由你来选,和 准备你的作品里讲的完全一样。属性带来的是一个建议。 根据一件作品带着的属性,Zoide 会给它一个分数——取值越稀有,分数越高——把它放到其他作品之中排位, 然后用同一张表建议一个档位,并附上它的位置:排名 12 / 250。

12.png
建议:RARE · 排名 12 / 250
COMMON · 60.00 %
EPIC · 10.00 %
一件作品的表单,带着它的两个属性,以及等级下方的建议

在每个属性选择器旁边,作品还会显示这个取值有多稀有:它的等级(用它的颜色显示)和它的百分比—— 计算出来的,或者你修改过的。一件在某个属性上无取值的作品,显示的是 None 的等级和百分比。

如果你选的等级不是建议的那个,检查会把它作为一个警告提出来。它不会拦住你。

位置——排名 1 到 N,1 代表最稀有——才是会被铭刻、也是收藏者用来排序的东西,而且它不能编辑。它首先 按你分配的等级排序,然后按属性分数,最后按作品编号。所以你的决定排在第一,属性只用来打破平局。

1024 字节的上限

属性被铭刻在每件作品的元数据里,而索引器会悄无声息地丢弃任何超过 1024 字节的元数据。元数据一丢, 作品就失去了和合集的关联,并从合集里消失。所以:

  • 一件元数据放不下的作品会阻止提交。更短的名称或取值,或者更少的属性,就能解决。
  • 封面带着整张属性表,每个取值连同它的百分比。如果放不下,封面会不带这张表铭刻,检查会警告你—— 属性仍然保留在每件作品上。如果连不带表都放不下,那就是描述太长了,这会阻止提交。

提交之前,你可以看到每件作品和封面将要携带的确切数据,以及它的大小:查看链上 JSON。合集 id 会显示 为一串零,因为真正的 id 要等封面铭刻之后才存在。

检查会核对什么

一旦合集有了属性和作品,检查会多出下面这几行。每一行未通过时都带一个查看链接,指向解决它的 地方:已经筛选出相关作品的作品列表,或者属性标签页。

检查项
每个属性的百分比合计为 100 阻止提交
每件作品在链上不超过 1024 字节 阻止提交
在你的方案限制之内 阻止提交
封面连同属性表放得下 只有不带表才放得下时警告;连那样都放不下时阻止提交
取值等级与 Zoide 计算的一致 你修改过任何一个时警告
每件作品的等级与其属性建议的一致 有任何不同时警告

从文件导入整个合集

给一千件作品手工分配属性不是个办法。如果你的合集是用生成器做出来的,就直接上传它的文件。导入仅限 订阅用户;没有订阅时,这张卡片会显示为禁用状态,而批量编辑就是你的 办法。

图片仍然照常通过上传区上传。文件带来的是其余部分——每件作品的名称、编号、等级和属性——而每一行是按 你上传时文件的名称与它的图片对应起来的。作品标签页里的每件作品都会以只读方式显示这个原始名称, 正是为了让你核对这种对应关系:在我们这边,文件是以一个随机名称存储的。

两个下载,两样不同的东西

  • 示例模板——三件虚构的作品,只用来展示格式。里面没有你合集的任何东西。
  • 导出合集——你的合集此刻的内容,每件作品一行,用来编辑后再上传回去。合集里还没有作品时它是禁用的。 百分比和稀有度只填写你修改过的那些:留空表示使用计算值,所以原样再上传回去不会改变任何东西。

两者都提供 CSV 或 JSON,而且都带着所有的列,所以你永远知道每样东西该放在哪里。

格式

  • CSV——列是 item_file、name、number、rarity,再加上每个属性三列:它的取值 trait:<Name>,以及它的百分比和稀有度 trait:<Name>:percentage 和 trait:<Name>:rarity。只有 item_file 是必需的。逗号、分号或制表符都行,会自动识别,而且文件在 Excel 里能干净地打开。无法识别的 列会被忽略,报告里会说明是哪些。
  • JSON——items 下的一个列表,每一项带着 item_file、name、number、rarity 和 attributes (每个属性是一个 trait_type、一个 value,以及可选的 percentage 和 rarity)。JSON 不能写注释, 所以每个字段的说明会以 _guide 的形式放在最上面,用的是你的语言。以 _ 开头的键在导入时会被忽略。
  • HashLips 的 _metadata.json,原样使用。 它的 edition 视为编号,image 视为文件名。

文件内部:

  • item_file——不区分大小写,而在路径或 URL 里只看最后一部分:ipfs://…/7.png 就是 7.png。
  • rarity——EXOTIC 到 COMMON 之一,大小写不限。留空则作品的等级保持不变,UNRANKED 则去掉等级。
  • 一行里没有带上的属性、一个空单元格或 None,都会让作品在这个属性上无取值。
  • 取值的百分比和稀有度是可选的。留空则由 Zoide 计算;填写了就按原样设置,和在属性标签页里修改 它们完全一样——百分比为 0 到 100、最多两位小数,稀有度为 EXOTIC 到 COMMON 之一。它们属于取值,而不 属于作品:在带有该取值的每一行里重复相同的内容,或者只在其中一行填写、其余留空。
  • 在某个属性上无取值的行里,百分比就是 None 的百分比。None 没有自己的稀有度。
  • 如果文件完全没有这些列或键——比如原样的 HashLips 文件——你修改过的百分比和稀有度会保持不变。
  • 一个属性的百分比(包括 None)仍然必须合计为 100:如果导入后不是这样,报告会警告你,而且在合计为 100 之前,检查会阻止提交。

先验证,再确认

验证不会改动任何东西。它会返回一份报告:有多少行和它的图片对上了、会有什么变化、有什么问题。

红色的内容会阻止整个导入——修正之前什么都不会导入:

  • 文件无法读取、没有任何行或没有 item_file 列,或者没有任何一行和已上传的图片对上;
  • 行数超过你的方案允许的作品数;
  • 同一张图片出现在两行里;
  • 属性名称或取值为空或太长,或者数量超过你的方案允许的;
  • 作品名称为空或超过 50 个字符、不存在的稀有度、不是正整数的编号,或者导入后会在合集里重复的编号;
  • 不是 0 到 100 之间数字的百分比、不存在的取值稀有度,或者同一个取值在两行里的百分比或稀有度不同。

黄色的内容会被报告,但不会阻止导入:没有同名已上传图片的行、文件没有提到的作品(保持原样)、 多个上传文件同名(这些行会被跳过)、无法识别的列、没有文件名的行、无取值的行上填写的稀有度,以及百分比 合计不会是 100 的属性。

确认导入会再验证一次,然后一次性写入全部内容,要么全部写入,要么什么都不写。在那之前,你在页面上 所有待保存的内容都会先被保存,这样导入既不会落在没保存的工作之上,之后也不会被它覆盖。

再次导入

文件只决定它带来的那些东西:

  • 对于它带着的每个属性,它列出的每件作品最终都会得到它那一行里的取值,空单元格则会清除取值;
  • 它没带的属性不会被改动;
  • 名称、编号和稀有度只在这一行有填写的地方才会改变;
  • 取值的百分比和稀有度只会在文件带有其列或键的属性上改变。

再次导入是按文件名更新的:它从不创建作品——那是上传区的事——也从不重复创建属性或取值。所以这样的来回 是安全的:导出、编辑、导入。

一千行大约一秒就能导入完;没有需要等待的队列。

一次编辑很多件作品

不管你导不导入,作品标签页都是为处理几百件作品而设计的:

  • 搜索名称、编号或原始文件名。
  • 按属性筛选:某个属性的一个取值,或者该属性无取值。同时使用多个筛选时,必须全部满足。
  • 选择作品:逐件选择、选择所有已加载的,或者选择筛选出的全部作品,不论是否已加载。

然后对它们全部应用一个操作:

选择已加载的 选择筛选出的 80 件 已选 80 件 取消选择 重新编号 1..N
应用
通过筛选选中了八十件作品,即将被设为取值 Cap
操作 它做什么
设置或移除属性 给它们全部设置一个已有的取值,或者清除它。它不会创建属性或取值,所以不会让你超出方案的限制
设置稀有度 给它们全部设置同一个档位。UNRANKED 则去掉等级
按模式重命名 Frog #{n} 会用每件作品自己的编号来命名它。模式里必须包含 {n}:否则它们会全部同名
重新编号 1..N 针对整个合集,而不是所选作品:按当前顺序从 1 编到 N,不留空号

它会先询问确认,并带上数量——将更改 80 件作品——并在应用之前保存所有待保存的内容。列表、图表和 检查都会随之更新,无需重新加载。

典型用法:筛选 Hat 中无取值的作品,选择筛选出的全部作品,设置 Hat: Cap。

收藏者看到什么

在一件作品的页面上,有它的属性——每个属性带着它的百分比和这个百分比对应的等级——以及它在合集里的 位置:

排名 #12 / 250
Background Night 60.00% COMMON
Hat Crown 10.00% EPIC
作品页面上的属性区块

在合集页面上,有一个按属性筛选的功能,会显示每个取值有多少件作品带着,还可以按等级排序:

清除
Background
Hat
合集页面的属性筛选,勾选了 Night

两者都是从链上读取的,而不是从 Zoide 的数据库。这就是为什么它们对任何带属性的 1Sat 合集都有效,不只是 在这里发布的那些。见作品页面能告诉你什么。