How to Add 1 of 1s to a Generative NFT Collection

What a 1 of 1 is in a generative collection

A 1 of 1 is a finished artwork that appears once, exactly as drawn, instead of being put together from traits: a hand-drawn legend, a collaboration or a surprise. It sits among the generated NFTs and is numbered with them.

How 1 of 1s count toward the total

They are part of the collection size. 10,000 with 25 1 of 1s means 9,975 NFTs made from traits, and in a real 10,000-piece test plan that is exactly what the studio made. A collection can hold up to 2,000 1 of 1s.

Your traits still need room for the NFTs made from them: how many traits you need covers that.

Mixed throughout or at the end

In the 1 of 1s tab, “Where should they appear?” has two choices.

What each does to the numbering

Mixed throughout means nobody can tell from the numbers alone which NFTs are the 1 of 1s. At the end puts them on the last numbers, where everyone knows they are.

The same seed gives the same places

The places come from the seed, like everything else in the plan. Keep the seed and the same 1 of 1s land on the same numbers every time. Adding or removing a 1 of 1 changes how many NFTs are made from traits, so those are dealt again.

Their metadata

A 1 of 1 gets one attribute instead of a list of traits. This is the starter kit’s 1 of 1, which landed at #98:

{
  "name": "Puff Editions #98",
  "description": "An original collection. Created with Puffles Studio.",
  "image": "ipfs://REPLACE_WITH_IMAGES_CID/98.png",
  "attributes": [
    { "trait_type": "1 of 1", "value": "The Original" }
  ]
}

Two settings in the 1 of 1s tab change it. “Metadata trait name” renames the trait type, for example to “Legend”. “Use each artwork’s own name in metadata” replaces the numbered name with the artwork’s own, so this one would be called “The Original” instead of “Puff Editions #98”.

The artwork’s name comes from its file name, and you can edit it in the tab. The rest of the file follows the usual OpenSea metadata format.

How they show in rarity.csv and the OpenSea CSV

rarity.csv lists each 1 of 1 on its own row, under its trait type, with a count of 1. In the 100-piece starter kit that row reads “1 of 1,The Original,1,1”: one NFT, 1% of the collection. (How to read rarity.csv.)

The OpenSea drop CSV gains an attributes[1 of 1] column. The 1 of 1’s row fills only that column and leaves the trait columns empty; every other row leaves it empty:

tokenID,name,description,file_name,external_url,attributes[Background],attributes[Body],attributes[Expression],attributes[Headwear],attributes[1 of 1]
98,Puff Editions #98,An original collection. Created with Puffles Studio.,98.png,,,,,,The Original

Adding them

• At import: put them in a folder named “1 of 1” inside the parent folder. The studio also recognises “one of one”, “1_of_1” and “1-of-1s”, with or without a number in front (how to prepare your folders).
• In the studio: press “Add artworks” in the 1 of 1s tab and pick PNG, JPG or WebP files.
• Each artwork has an Include checkbox, and Include all or Exclude all switch them together. Only included ones count.

Other tools do it differently. NFTs2Me’s guide, for example, adds a “1/1” layer with 0% likelihood and assigns each artwork to a token ID by hand after generating.

Tips

• Use the same canvas size as your traits. Images of another size are stretched to the size most of your images share, and the import tells you when that happens.
• Give each one a unique name: two 1 of 1s with the same name are refused.
• A 1 of 1 can be fully solid. It is used as it is, not stacked on other layers.