Traits einer Kollektion

Gib jedem Stück seine Eigenschaften und lass Zoide ausrechnen, wie selten jede ist. Wie viele du in deinem Plan festlegen kannst, die Grenze von 1.024 Bytes, eine ganze Kollektion aus einer Datei importieren, hunderte Stücke auf einmal bearbeiten und was Sammler am Ende sehen.

Ein Trait ist eine Eigenschaft, die ein Stück hat: ein Background, der Night oder Day ist, ein Hat, der eine Crown, eine Cap oder gar nichts ist. Traits werden mit jedem Stück inskribiert, in dem Format, das die 1Sat-Indexer lesen, also reisen sie mit dem Stück, wohin es auch geht — nicht nur auf Zoide.

Genau deshalb verdienen sie etwas Sorgfalt: Was inskribiert ist, lässt sich nicht korrigieren. Alles auf dieser Seite passiert, bevor du einreichst, im Tab Traits des Schritts Inhalt.

Festlegen, dann zuweisen

Zwei Handgriffe, an zwei Orten:

  1. Lege sie fest im Tab Traits: jeden Trait mit seinen Werten. Der Tab hat seinen eigenen Knopf Traits speichern und sagt dir, wie viele Stücke jeden Wert tragen.
  2. Weise sie zu im Tab Stücke: Jedes Stück hat einen Selektor pro Trait, gespeichert mit Alles speichern wie der Rest seines Formulars.
%
25 Stücke
%
150 Stücke
None
%
Ohne Wert: 75 Stücke
Wert hinzufügen Summe: 100.00 %

Aus einer Datei importieren

Beispielvorlage Kollektion exportieren
Prüfen
Der Tab Traits, mit einem Trait und seinen drei Werten. Eine Kopie des echten, mit ihm im Gleichschritt gehalten.

Ein paar Regeln, die du kennen solltest, bevor du anfängst:

  • Namen und Werte haben 1 bis 32 Zeichen. Mit Absicht kurz — siehe die Grenze von 1.024 Bytes.
  • Keine Duplikate, die sich nur in Groß-/Kleinschreibung oder Akzenten unterscheiden: Café und cafe sind derselbe Wert, und beim Speichern wird dir das neben dem zweiten gesagt.
  • None ist reserviert. Es bedeutet kein Wert, und genau das hat ein Stück, wenn du ihm keinen zuweist. Jedes Stück ohne Hut zählt bei Hat als None — und None zählt bei den Prozentsätzen wie jeder andere Wert.
  • Einen Wert umzubenennen lässt ihn an den Stücken, die ihn hatten. Einen zu entfernen lässt diese Stücke ohne Wert, und vorher wird nachgefragt, mit der Zahl der Stücke, die ihn tragen.
  • Namen und Werte gehören dir: Sie werden so gezeigt, wie du sie geschrieben hast, in jeder Sprache.

Wie viele du haben kannst

Traits pro Kollektion Werte pro Trait Stücke pro Kollektion
Ohne Abonnement 3 10 100
Mit Abonnement 20 200 2,000

Wenn du eine Grenze erreichst, sagt der Tab das, und er sagt, was ein Abonnement freischaltet. Siehe Abonnement.

Wenn dein Abonnement abläuft, während ein Entwurf über den Grenzen liegt, geht nichts verloren: Du kannst ihn kürzen, aber nicht wachsen lassen, und die Prüfung blockiert die Einreichung, bis du ihn entweder kürzt oder verlängerst.

Prozentsätze und Ränge werden für dich ausgerechnet

Zoide zählt, wie viele Stücke jeden Wert tragen, und macht daraus einen Prozentsatz mit zwei Nachkommastellen, der immer genau 100 ergibt: Der Rest der Rundung wird verteilt, also kommen drei Werte, die jeweils in einem Drittel der Stücke vorkommen, auf 33,34, 33,33 und 33,33.

Jeder Wert bekommt dann einen Rang aus seinem Prozentsatz — die erste Stufe, die sein Prozentsatz nicht überschreitet:

Ein Wert, getragen von… ist
1% der Stücke oder weniger EXOTIC
5% oder weniger LEGENDARY
10% oder weniger EPIC
20% oder weniger RARE
40% oder weniger UNCOMMON
mehr als das COMMON

Du kannst sie nachbessern

Die Kollektion gehört dir. Neben jedem Wert kannst du seinen Prozentsatz festlegen, und seinen Rang. Lass das Feld leer, und der berechnete gilt — er wird so oder so daneben gezeigt, als Hinweis des Felds und als Auto (EPIC), damit du immer weißt, wovon du abweichst. Sie können auch schon ausgefüllt in der Importdatei kommen.

Ein Trait, dessen Prozentsätze nicht mehr 100 ergeben, blockiert die Einreichung: Einem Wert mehr zu geben heißt, einem anderen weniger zu geben.

Der Rang jedes Stücks, und der vorgeschlagene

Den Rang eines Stücks — EXOTIC bis COMMON — wählst weiterhin du, genau wie in Deine Items vorbereiten. Was Traits hinzufügen, ist ein Vorschlag. Aus den Traits, die ein Stück trägt, gibt Zoide ihm eine Punktzahl — je seltener seine Werte, desto höher —, ordnet es unter den anderen ein und schlägt die Stufe vor, mit derselben Tabelle, zusammen mit seiner Position: Rang 12 von 250.

12.png
Vorschlag: RARE · Rang 12 von 250
COMMON · 60.00 %
EPIC · 10.00 %
Das Formular eines Stücks mit seinen zwei Traits und, unter seinem Rang, dem Vorschlag

Neben jeder Trait-Auswahl zeigt das Stück außerdem, wie selten dieser Wert ist: seinen Rang, in seiner Farbe, und seinen Prozentsatz — die berechneten oder deine, wenn du sie nachgebessert hast. Ein Stück ohne Wert bei einem Trait zeigt die von None.

Wenn der Rang, den du gewählt hast, nicht der vorgeschlagene ist, erwähnt die Prüfung das als Warnung. Sie hält dich nicht auf.

Die Position — Rang 1 bis N, wobei 1 das seltenste ist — ist das, was inskribiert wird und wonach Sammler sortieren, und sie ist nicht editierbar. Sie wird zuerst nach dem Rang geordnet, den du vergeben hast, dann nach der Trait-Punktzahl, dann nach der Nummer des Stücks. Deine Entscheidung kommt also zuerst, und die Traits lösen nur die Gleichstände auf.

Die Grenze von 1.024 Bytes

Die Traits werden in die Metadaten jedes Stücks inskribiert, und die Indexer verwerfen stillschweigend alle Metadaten über 1.024 Bytes. Mit ihnen verliert das Stück seine Verbindung zur Kollektion und verschwindet aus ihr. Also:

  • Ein Stück, dessen Metadaten nicht passen, blockiert die Einreichung. Kürzere Namen oder Werte, oder weniger Traits, beheben es.
  • Das Cover trägt die ganze Trait-Tabelle, jeden Wert mit seinem Prozentsatz. Wenn das nicht passt, wird das Cover ohne die Tabelle inskribiert, und die Prüfung warnt dich — die Traits bleiben an jedem Stück. Wenn es nicht einmal ohne die Tabelle passt, ist die Beschreibung zu lang, und das blockiert.

Vor dem Einreichen kannst du die genauen Daten sehen, die jedes Stück und das Cover tragen werden, mit ihrer Größe: On-Chain-JSON ansehen. Die ID der Kollektion erscheint als Nullen, weil die echte erst existiert, wenn das Cover inskribiert ist.

Was die Prüfung kontrolliert

Sobald die Kollektion Traits und Stücke hat, fügt die Prüfung diese Zeilen hinzu. Jede, die fehlschlägt, hat einen Link Ansehen dorthin, wo sie behoben wird: die Liste der Stücke, schon auf die betroffenen gefiltert, oder den Tab Traits.

Prüfpunkt
Die Prozentsätze jedes Traits ergeben 100 Blockiert
Jedes Stück passt in 1.024 Bytes Blockiert
Innerhalb der Grenzen deines Plans Blockiert
Das Cover passt mit seiner Trait-Tabelle Warnt, wenn es nur ohne die Tabelle passt; blockiert, wenn es nicht einmal dann passt
Ränge der Werte so, wie Zoide sie berechnet Warnt, wenn du einen nachgebessert hast
Rang jedes Stücks wie von seinen Traits vorgeschlagen Warnt, wenn einer abweicht

Eine ganze Kollektion aus einer Datei importieren

Tausend Stücken von Hand Traits zuzuweisen ist kein Plan. Wenn deine Kollektion aus einem Generator kommt, lade stattdessen seine Datei hoch. Importieren ist Abonnenten vorbehalten; ohne Abonnement wird die Karte deaktiviert gezeigt, und die Massenbearbeitung ist der Weg.

Die Bilder gehen weiterhin über den Upload-Bereich, wie immer. Die Datei bringt den Rest — Name, Nummer, Rang und Traits jedes Stücks —, und jede Zeile wird ihrem Bild über den Namen zugeordnet, den die Datei beim Hochladen hatte. Jedes Stück im Tab Stücke zeigt diesen ursprünglichen Namen, nur lesbar, genau damit du die Zuordnung prüfen kannst: Bei uns wird die Datei unter einem zufälligen Namen gespeichert.

Zwei Downloads, zwei verschiedene Dinge

  • Beispielvorlage — drei erfundene Stücke, nur um das Format zu zeigen. Nichts aus deiner Kollektion.
  • Kollektion exportieren — was deine Kollektion gerade hat, eine Zeile pro Stück, zum Bearbeiten und wieder Hochladen. Solange es keine Stücke gibt, ist es deaktiviert. Von den Prozentsätzen und Rängen trägt es nur die ein, die du nachgebessert hast: Leer heißt berechnet, also ändert es nichts, wenn du es unverändert wieder hochlädst.

Beide gibt es als CSV oder JSON, und beide tragen jede Spalte, damit du immer weißt, wohin was gehört.

Die Formate

  • CSV — die Spalten sind item_file, name, number, rarity und pro Trait drei: sein Wert, trait:<Name>, und sein Prozentsatz und Rang, trait:<Name>:percentage und trait:<Name>:rarity. Nur item_file ist Pflicht. Komma, Semikolon oder Tab — es wird erkannt, und die Datei öffnet sich sauber in Excel. Spalten, die nicht verstanden werden, werden ignoriert, und der Bericht sagt, welche.
  • JSON — eine Liste unter items, jeder Eintrag mit item_file, name, number, rarity und attributes (jedes Attribut ein trait_type, ein value und, optional, ein percentage und ein rarity). JSON kann keine Kommentare haben, also reist die Erklärung jedes Felds oben als _guide mit, in deiner Sprache. Schlüssel, die mit _ beginnen, werden beim Import ignoriert.
  • Eine _metadata.json von HashLips, so wie sie ist. Ihr edition zählt als Nummer und ihr image als Dateiname.

In der Datei:

  • item_file — Groß- und Kleinschreibung spielen keine Rolle, und bei einem Pfad oder einer URL zählt nur der letzte Teil: ipfs://…/7.png ist 7.png.
  • rarity — einer von EXOTIC bis COMMON, in beliebiger Schreibweise. Leer lässt den Rang des Stücks, wie er ist, und UNRANKED entfernt ihn.
  • Ein Trait, den eine Zeile nicht mitbringt, eine leere Zelle oder None lässt das Stück dort ohne Wert.
  • Prozentsatz und Rang eines Werts sind optional. Leer rechnet Zoide sie aus; ausgefüllt werden sie so gesetzt, wie sie kommen, genau wie beim Nachbessern im Tab Traits — ein Prozentsatz von 0 bis 100 mit höchstens zwei Nachkommastellen, ein Rang von EXOTIC bis COMMON. Sie gehören zum Wert, nicht zum Stück: Wiederhole dieselben in jeder Zeile, die ihn hat, oder trag sie in nur einer Zeile ein und lass den Rest leer.
  • In einer Zeile ohne Wert bei einem Trait ist der Prozentsatz der von None. None hat keinen eigenen Rang.
  • Bringt die Datei diese Spalten oder Schlüssel gar nicht mit — etwa eine HashLips-Datei, so wie sie ist —, bleiben die Prozentsätze und Ränge, die du nachgebessert hast, wie sie sind.
  • Die Prozentsätze eines Traits, None eingeschlossen, müssen weiterhin 100 ergeben: Täten sie es nach dem Import nicht, warnt dich der Bericht, und die Prüfung blockiert die Einreichung, bis sie es tun.

Prüfen, dann bestätigen

Prüfen ändert nichts. Es gibt einen Bericht zurück: wie viele Zeilen zu ihrem Bild passen, was sich ändern würde und was falsch ist.

Was rot ist, blockiert den ganzen Import — nichts wird importiert, bis es behoben ist:

  • die Datei kann nicht gelesen werden, hat keine Zeilen oder keine Spalte item_file, oder keine Zeile passt zu einem hochgeladenen Bild;
  • mehr Zeilen, als dein Plan Stücke erlaubt;
  • dasselbe Bild in zwei Zeilen;
  • Trait-Namen oder Werte, die leer oder zu lang sind, oder mehr davon, als dein Plan erlaubt;
  • Stücknamen, die leer sind oder mehr als 50 Zeichen haben, Ränge, die es nicht gibt, Nummern, die keine positiven ganzen Zahlen sind, oder Nummern, die die Datei in der Kollektion doppelt hinterlassen würde;
  • Prozentsätze, die keine Zahl von 0 bis 100 sind, Wert-Ränge, die es nicht gibt, oder derselbe Wert mit einem anderen Prozentsatz oder Rang in zwei Zeilen.

Was gelb ist, wird gemeldet, hält den Import aber nicht auf: Zeilen ohne hochgeladenes Bild mit diesem Namen, Stücke, die die Datei nicht erwähnt (sie bleiben, wie sie sind), mehrere Uploads mit demselben Namen (diese Zeilen werden übersprungen), Spalten, die nicht verstanden werden, Zeilen ohne Dateinamen, ein Rang in einer Zeile ohne Wert und Traits, deren Prozentsätze nicht 100 ergeben würden.

Import bestätigen prüft noch einmal und schreibt alles auf einmal, oder nichts. Bevor es das tut, wird gespeichert, was du auf der Seite noch ausstehend hattest, damit der Import weder auf ungespeicherter Arbeit landet noch danach von ihr überschrieben wird.

Erneut importieren

Die Datei entscheidet nur über das, was sie mitbringt:

  • Für jeden Trait, den sie trägt, bekommt jedes Stück, das sie aufführt, den Wert aus seiner Zeile, und eine leere Zelle löscht ihn;
  • Traits, die sie nicht trägt, werden nicht angefasst;
  • Name, Nummer und Rang ändern sich nur dort, wo die Zeile sie hat;
  • Prozentsatz und Rang eines Werts ändern sich nur bei den Traits, deren Spalten oder Schlüssel die Datei mitbringt.

Erneut zu importieren aktualisiert nach Dateiname: Es legt nie Stücke an — das macht der Upload-Bereich — und dupliziert nie Traits oder Werte. Der Rundweg ist also sicher: exportieren, bearbeiten, importieren.

Tausend Zeilen sind in etwa einer Sekunde importiert; es gibt keine Warteschlange, auf die du warten müsstest.

Viele Stücke auf einmal bearbeiten

Ob du importierst oder nicht, der Tab Stücke ist dafür gebaut, an hunderten Stücken zu arbeiten:

  • Suche nach Name, Nummer oder ursprünglichem Dateinamen.
  • Filtere nach Trait: ein Wert, oder kein Wert bei einem Trait. Mehrere Filter gleichzeitig müssen alle zutreffen.
  • Wähle Stücke einzeln aus, alle geladenen oder alle Stücke im Filter, geladen oder nicht.

Dann wende eine Aktion auf alle an:

Die geladenen auswählen Die 80 im Filter auswählen 80 ausgewählt Auswahl aufheben Neu nummerieren 1..N
Anwenden
Achtzig Stücke, über den Filter ausgewählt, kurz davor, den Wert Cap zu bekommen
Aktion Was sie tut
Trait setzen oder entfernen Setzt einen bestehenden Wert bei allen, oder löscht ihn. Sie legt keine Traits oder Werte an, kann dich also nicht über die Grenzen deines Plans bringen
Rang setzen Dieselbe Stufe bei allen. UNRANKED entfernt sie
Mit Muster umbenennen Frosch #{n} benennt jedes mit seiner eigenen Nummer. Das Muster muss {n} enthalten: Ohne es hießen alle gleich
Neu nummerieren 1..N Die ganze Kollektion, nicht die Auswahl: von 1 bis N, in ihrer aktuellen Reihenfolge, ohne Lücken

Vorher wird nachgefragt, mit der Anzahl — du bist dabei, 80 Stücke zu ändern —, und was ausstand, wird vor dem Anwenden gespeichert. Die Liste, das Diagramm und die Prüfung aktualisieren sich, ohne neu zu laden.

Der typische Fall: nach kein Wert bei Hat filtern, alle Stücke im Filter auswählen, Hat: Cap setzen.

Was Sammler sehen

Auf der Seite eines Stücks seine Traits — jeder mit seinem Prozentsatz und dem Rang dieses Prozentsatzes — und seine Position in der Kollektion:

Rang #12 von 250
Background Night 60.00% COMMON
Hat Crown 10.00% EPIC
Der Traits-Block auf der Seite eines Stücks

Auf der Kollektionsseite ein Filter nach Trait, der sagt, wie viele Stücke jeden Wert tragen, und das Sortieren nach Rang:

Entfernen
Background
Hat
Der Trait-Filter einer Kollektionsseite, mit Night angehakt

Beides wird von der Chain gelesen, nicht aus der Datenbank von Zoide. Deshalb funktioniert es auch für jede 1Sat-Kollektion, die Traits trägt, nicht nur für die hier veröffentlichten. Siehe Was eine Stück-Seite dir sagt.