トレイトとは、作品が持つプロパティです。Night か Day の Background、Crown か Cap の、あるいは 何もない Hat。トレイトは 1Sat のインデクサーが読む形式で各作品と一緒に刻まれるので、Zoide の中だけで なく、作品がどこへ行こうとついて回ります。
だからこそ、少し気を配る価値があります——刻まれたものは訂正できません。このページのすべては、申請する 前に、コンテンツステップのトレイトタブで起こります。
定義してから、割り当てる
二つの動作を、二つの場所で行います。
- トレイトタブで定義します——各トレイトとその値です。このタブには専用のトレイトを保存ボタンが あり、それぞれの値を何点の作品が持っているかも表示します。
- 作品タブで割り当てます——各作品にはトレイトごとに一つのセレクターがあり、フォームのほかの部分と 同じくすべて保存で保存されます。
ファイルからインポート
始める前に知っておく価値のある規則がいくつかあります。
- 名前と値は 1〜32 文字です。意図して短くしています—— 1,024 バイトの上限を参照。
- 大文字・小文字やアクセントだけが違う重複はできません。Café と cafe は同じ値で、保存すると二つめの 横にそう表示されます。
- None は予約語です。 値なしを意味し、値を割り当てなかった作品が持つのがこれです。帽子のない作品は すべて Hat では None として数えられ——None もほかの値と同じように割合に数えられます。
- 値の名前を変えても、その値を持っていた作品からは消えません。値を削除すると、それを持っていた 作品は値なしになります。削除の前には、何点の作品がその値を持っているかを示して確認が出ます。
- 名前と値はあなたのものです。どの言語でも、書いたとおりに表示されます。
いくつ持てるか
| コレクションごとのトレイト | トレイトごとの値 | コレクションごとの作品 | |
|---|---|---|---|
| サブスクリプションなし | 3 | 10 | 100 |
| サブスクリプションあり | 20 | 200 | 2,000 |
上限に達すると、タブがそう伝え、サブスクリプションで何が解放されるかも伝えます。 サブスクリプションを参照。
下書きが上限を超えているあいだにサブスクリプションが切れても、何も失われません。減らすことはできても 増やすことはできず、減らすか更新するまで、確認が申請を止めます。
割合とランクは自動で計算されます
Zoide はそれぞれの値を何点の作品が持っているかを数え、それを小数点以下 2 桁の割合にします。合計は 常にちょうど 100 になります。丸めの端数は配分されるので、それぞれ 3 分の 1 ずつ現れる三つの値は 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 が最もレア——は刻まれるものであり、コレクターが並べ替えに使うもので、 編集はできません。まずあなたが割り当てたランク、次にトレイトのスコア、最後に作品番号の順で並べられます。 つまりあなたの決定が先で、トレイトは同点を分けるだけです。
1,024 バイトの上限
トレイトは各作品のメタデータに刻まれ、インデクサーは 1,024 バイトを超えるメタデータを黙って捨てます。 それとともに作品はコレクションとのつながりを失い、コレクションから消えてしまいます。ですから——
- メタデータが収まらない作品は申請を止めます。名前や値を短くするか、トレイトを減らせば解決します。
- カバーはトレイト表全体——すべての値とその割合——を持ちます。それが収まらなければ、カバーは表なしで 刻まれ、確認が警告します——トレイトは各作品に残ります。表なしでも収まらない場合は説明が長すぎるという ことで、それは申請を止めます。
申請する前に、各作品とカバーが持つことになる正確なデータを、そのサイズとともに見られます—— オンチェーン JSON を表示。コレクションの ID はゼロで表示されます。本物の ID は、カバーが刻まれて初めて 存在するからです。
確認がチェックすること
コレクションにトレイトと作品があると、確認に次の行が加わります。満たされていない行にはそれぞれ、直す 場所への表示リンクがあります——該当する作品ですでに絞り込まれた作品の一覧か、トレイトタブです。
| チェック | |
|---|---|
| 各トレイトの % の合計が 100 | 申請を止める |
| 各作品が 1,024 バイト以内 | 申請を止める |
| プランの上限内 | 申請を止める |
| カバーがトレイト表込みで収まる | 表なしでしか収まらなければ警告、それでも収まらなければ申請を止める |
| 値のランクが Zoide の計算どおり | どれかを調整していれば警告 |
| 各作品のランクがトレイトによる推奨どおり | 推奨と違うものがあれば警告 |
コレクション全体をファイルからインポートする
千点の作品に手でトレイトを割り当てるのは、計画とは言えません。コレクションがジェネレーターから出てきた ものなら、代わりにそのファイルをアップロードしてください。インポートはサブスクライバー向けです。 サブスクリプションがなければカードは無効の状態で表示され、一括での編集が その代わりの道です。
画像はいつもどおりアップロード欄から入れます。ファイルが運ぶのは残りの部分——各作品の名前、番号、ランク、 トレイト——で、各行はアップロードしたときのファイル名で画像と対応付けられます。作品タブのどの作品にも、 まさにその対応を確かめられるように、元のファイル名が読み取り専用で表示されます。こちら側では、ファイルは ランダムな名前で保存されているからです。
二つのダウンロード、二つの別のもの
- サンプルテンプレート——形式を示すためだけの、架空の作品が三つ。あなたのコレクションのものは何も 入っていません。
- コレクションをエクスポート——あなたのコレクションがいま持っているもの。作品ごとに 1 行で、編集して 再アップロードするためのものです。作品がないあいだは無効です。割合とランクは、あなたが調整したものだけが 記入されます。空は計算値という意味なので、そのまま再アップロードしても何も変わりません。
どちらも 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 で小数点以下 2 桁まで、ランクは EXOTIC から COMMON まで。これは作品ではなく値に属するものです。その値を持つすべての行に同じものを書くか、1 行に だけ記入して残りは空にしてください。
- トレイトの値がない行では、割合は None の割合です。None には独自のランクはありません。
- ファイルにそれらの列やキーがまったくない場合——たとえばそのままの HashLips ファイル——調整済みの割合と ランクはそのまま残ります。
- トレイトの割合は、None を含めて、やはり合計 100 でなければなりません。インポート後にそうならない 場合はレポートが警告し、そうなるまで確認が申請を止めます。
検証してから、確定する
検証は何も変えません。レポートを返します——何行が画像と一致するか、何が変わるか、何がおかしいか。
赤で表示されるものはインポート全体を止めます——直すまで何もインポートされません。
- ファイルが読めない、行がない、
item_file列がない、またはアップロード済みの画像と一致する行が一つも ない。 - プランで許される作品数より行が多い。
- 同じ画像が二つの行にある。
- トレイトの名前や値が空か長すぎる、またはプランで許される数より多い。
- 作品名が空か 50 文字を超える、存在しないランク、正の整数でない番号、またはファイルによってコレクション 内で重複してしまう番号。
- 0 から 100 の数値でない割合、存在しない値のランク、または二つの行で割合やランクが異なる同じ値。
黄色で表示されるものは報告されますが、止めはしません——その名前の画像がアップロードされていない 行、ファイルが触れていない作品(そのまま残ります)、同じ名前を持つ複数のアップロード(該当する行は飛ばされ ます)、理解できない列、ファイル名のない行、値のない行に書かれたランク、割合の合計が 100 にならない トレイト。
インポートを確定はもう一度検証してから、すべてを一度に書き込むか、何も書き込まないかのどちらかです。 その前に、ページで未保存だったものが保存されるので、インポートが未保存の作業の上に重なることも、あとから それに上書きされることもありません。
もう一度インポートする
ファイルが決めるのは、ファイルが運んでくるものについてだけです。
- ファイルにあるトレイトごとに、ファイルに載っている各作品はその行の値になり、空のセルなら値が消えます。
- ファイルにないトレイトには触れません。
- 名前、番号、ランクは、行にそれがある場合にだけ変わります。
- 値の割合とランクは、ファイルにその列やキーがあるトレイトについてだけ変わります。
もう一度インポートすると、ファイル名で更新します。作品を作ることは決してなく——それをするのはアップロード 欄です——トレイトや値を重複させることもありません。ですから往復しても安全です——エクスポートして、 編集して、インポートする。
千行のインポートは一秒ほどで終わります。待つべきキューはありません。
多くの作品を一度に編集する
インポートしてもしなくても、作品タブは何百点もの作品を扱うために作られています。
- 名前、番号、元のファイル名で検索できます。
- トレイトで絞り込む——一つの値、またはあるトレイトの値なし。複数のフィルターを同時に使うと、すべてに 一致する必要があります。
- 作品を一点ずつ、読み込み済みのすべて、あるいは読み込まれているかどうかに関係なくフィルターのすべての作品 を選択できます。
そして、そのすべてに一つの操作を適用します。
| 操作 | すること |
|---|---|
| トレイトを設定・解除 | 既存の値を全作品に設定するか、消します。トレイトや値を作ることはないので、プランの上限を超えることはありません |
| ランクを設定 | 全作品に同じ階級を。UNRANKED にするとランクがなくなります |
| パターンで名前を変更 | Frog #{n} なら、各作品をそれぞれの番号で名付けます。パターンには {n} を含める必要があります——なければ、全作品が同じ名前になってしまいます |
| 1..N に振り直す | 選択ではなくコレクション全体を——1 から N まで、現在の順に、欠番なしで |
実行の前に、件数を示して確認が出ます——80 件の作品を変更します——そして適用する前に未保存の分を保存 します。一覧、グラフ、確認は再読み込みなしに更新されます。
典型的な使い方——Hat の値なしで絞り込み、フィルターのすべての作品を選択して、Hat: Cap を設定します。
コレクターが目にするもの
作品のページでは、そのトレイト——それぞれの割合と、その割合のランク——と、コレクションの中での順位が 表示されます。
コレクションのページには、それぞれの値を何点の作品が持っているかを示すトレイトのフィルターと、ランク順の 並べ替えがあります。
どちらも Zoide のデータベースではなく、チェーンから読まれます。だから、ここで公開されたものだけでなく、 トレイトを持つあらゆる 1Sat コレクションでも機能します。 作品ページが教えてくれることを参照。