属性(trait)是一件作品所具有的一项特征:一个是 Night 还是 Day 的 Background(背景),一个是 Crown、Cap 还是什么都没有的 Hat(帽子)。属性会随每件作品一起被铭刻,用的是 1Sat 索引器 读取的格式,所以不管作品去到哪里,它们都跟着走——不只是在 Zoide 上。
这也是为什么它们值得花点心思:铭刻上去的东西无法更正。本页讲的一切都发生在你提交之前,在内容 步骤的属性标签页里。
先定义,再分配
两个动作,在两个地方:
- 在属性标签页里定义它们:每个属性和它的取值。这个标签页有自己的保存属性按钮,并会告诉你 每个取值有多少件作品带着。
- 在作品标签页里分配它们:每件作品针对每个属性都有一个选择器,和它表单的其余部分一样,用 全部保存来保存。
从文件导入
开始之前值得知道的几条规则:
- 名称和取值都是 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。
在每个属性选择器旁边,作品还会显示这个取值有多稀有:它的等级(用它的颜色显示)和它的百分比—— 计算出来的,或者你修改过的。一件在某个属性上无取值的作品,显示的是 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 的属性。
确认导入会再验证一次,然后一次性写入全部内容,要么全部写入,要么什么都不写。在那之前,你在页面上 所有待保存的内容都会先被保存,这样导入既不会落在没保存的工作之上,之后也不会被它覆盖。
再次导入
文件只决定它带来的那些东西:
- 对于它带着的每个属性,它列出的每件作品最终都会得到它那一行里的取值,空单元格则会清除取值;
- 它没带的属性不会被改动;
- 名称、编号和稀有度只在这一行有填写的地方才会改变;
- 取值的百分比和稀有度只会在文件带有其列或键的属性上改变。
再次导入是按文件名更新的:它从不创建作品——那是上传区的事——也从不重复创建属性或取值。所以这样的来回 是安全的:导出、编辑、导入。
一千行大约一秒就能导入完;没有需要等待的队列。
一次编辑很多件作品
不管你导不导入,作品标签页都是为处理几百件作品而设计的:
- 搜索名称、编号或原始文件名。
- 按属性筛选:某个属性的一个取值,或者该属性无取值。同时使用多个筛选时,必须全部满足。
- 选择作品:逐件选择、选择所有已加载的,或者选择筛选出的全部作品,不论是否已加载。
然后对它们全部应用一个操作:
| 操作 | 它做什么 |
|---|---|
| 设置或移除属性 | 给它们全部设置一个已有的取值,或者清除它。它不会创建属性或取值,所以不会让你超出方案的限制 |
| 设置稀有度 | 给它们全部设置同一个档位。UNRANKED 则去掉等级 |
| 按模式重命名 | Frog #{n} 会用每件作品自己的编号来命名它。模式里必须包含 {n}:否则它们会全部同名 |
| 重新编号 1..N | 针对整个合集,而不是所选作品:按当前顺序从 1 编到 N,不留空号 |
它会先询问确认,并带上数量——将更改 80 件作品——并在应用之前保存所有待保存的内容。列表、图表和 检查都会随之更新,无需重新加载。
典型用法:筛选 Hat 中无取值的作品,选择筛选出的全部作品,设置 Hat: Cap。
收藏者看到什么
在一件作品的页面上,有它的属性——每个属性带着它的百分比和这个百分比对应的等级——以及它在合集里的 位置:
在合集页面上,有一个按属性筛选的功能,会显示每个取值有多少件作品带着,还可以按等级排序:
两者都是从链上读取的,而不是从 Zoide 的数据库。这就是为什么它们对任何带属性的 1Sat 合集都有效,不只是 在这里发布的那些。见作品页面能告诉你什么。