Generating your Collection

There are two main ways to create your collection; you can use GeneratOrd's built in auto generation tool, or you can use third party tools to create a custom collection and import it into GeneratOrd.

GeneratOrd's auto generation is still a work in progress, and still has limited functionality. So if you have a more complex collection you may need to generate your collection using third party tools and import it into GeneratOrd.

GeneratOrd supports:

• Configuring different rarities for each trait

• Optional trait types with the use of the None Trait

• Manually editing and saving custom items

GeneratOrd does not support:

• Custom rules (e.g. rules that disallow certain trait combinations, or rules that require certain traits to be used with a specific trait)

• Different groups/classes of items, each with different traits, settings and rules (e.g. a Male and Female type, each with different traits and rarities)

If your collection has complex requirements that cannot be met by GeneratOrd, you can still create your collection without GeneratOrd and import it in. See here for more details on how to do this

Using GeneratOrd to Generate your Collection

To generate your collection, navigate to the Collection Tab, and click Generate Collection. The collection can be regenerated as many times as you like.

Click Generate Collection to create your collection

The first time you do this, you will be prompted to enter your collection size. This is the number of items in the collection, or the 'supply'. You will only be asked to set this once, however it can be edited later on if needed (See Changing the Collection Size)

When generating the collection for the first time, you will be prompted to enter the collection size.

After entering your collection size, and clicking Generate Collection, your collection will be generated and you will be shown a preview of it, as seen below. If you need to change any of the traits, or the layer order/rarities (See Preparing your Traits and Configuring your Traits), then you can click Regenerate Collection at any time to do this again.

Preview of the collection shown after generating the collection.

Changing the Collection Size

After you have generated the collection, you can change the collection size by clicking More Actions > Edit Collection Size. The More Actions menu can be found in the top right of the page, and is the button with the 3 dots (⋮). You will be prompted to enter in a new collection size, and after changing the size, the collection will be regenerated. Any items you have favourited will not be regenerated, however if you are reducing the collection size, some of the favourited items may have a different Token ID (i.e. a different position in the collection).

Click More Actions > Edit Collection Size to change the collection size after the collection had been generated

You will be prompted with this when changing the collection size. The collection will be regenerated when you change the collection size.

Regenerating Individual Items

If you are happy with the majority of your collections, but there are just a few items that you don't like, you can regenerate just the ones you don't want. To do this, simply click the Regenerate button underneath each image (as shown below). This will randomly regenerate just that item, while still using the rarity requirements you have configured.

You can regenerate a single item by clicking the Regenerate button underneath the image

Favouriting Items

Each item can be favourited, or unfavourited by clicking on the Favourite button (Heart Icon) below each image. When an item is favourited, it cannot be edited or regenerated. So, when you regenerate the collection, the favourited items will remain unchanged. It also disables manual editing of individual items. To edit a favourited item, you must unfavourite it first.

Unfavourited items are indicated by an unfilled, grey icon, while favourited items have a filled, red icon as you can see below.

Click on the Favourite button (Heart Icon) to favourite an item

This item has been favourited, which is indicated by the red heart icon. This button can be clicked again to unfavourite the item.

Editing Individual Items

Each item can be manually edited. To do this, click on the image for the item, and it will open up a dialog showing the traits for the item. Within this dialog, click Edit.

The dialog shown when you click on an item. You can edit the item by clicking Edit.

After clicking edit, each trait type and trait is shown in a dropdown box that can be edited. For each trait, you can change the trait type, and the trait value. You can also delete any of the traits, add new traits, or reorder the traits by dragging and dropping the icon on the left of each row. As you make edits, the preview on the left will automatically update. Once finished, click Save to save it, or Cancel to undo your changes and revert back to the original.

When editing an item, you can change trait types and trait values for each trait, add and remove traits, and reorder traits.

Shuffling the Collection

Shuffling the collection can be useful for a variety of reasons, particularly if you have manually created some custom items, and want them to be shuffled randomly into the collection instead of all being at the start.

In order to shuffle the collection, click More Actions > Shuffle Collection (The More Actions menu can be found in the top right of the page, and is the button with the 3 dots (⋮)).

Click More Actions > Shuffle Collection to shuffle your collection. This randomly reorders the items, without changing any of them.

Before shuffling, you will be asked if you want to shuffle your favourites.

• If you choose not to shuffle favourites, then the entire collection will be shuffled, except the favourites, meaning all favourites will still have the same Token ID before and after shuffling. This is useful if you have favourited items that you don't want to move, because they have a meaningful/significant Token ID for your collection.

• If you do choose to shuffle favourites, then the entire collection is shuffled as normal, including favourites. This is useful if you have manually created some custom items and favourited them, but want to shuffle them randomly into the collection so they aren't all clumped together at the start.

When shuffling the collection, you will be given the option to shuffle favourites or not.

Creating Custom Items

One common way to use the features described above it to create custom items for you collection. i.e. specific trait combinations that you want to make sure are in your collection. To do this, edit the first several items (See Editing Individual Items) so that they have the specific traits you want. You can do this for as many items as you like.

For each item that you edit, make sure to favourite it, so that it not regenerated if you choose to regenerate the collection (See Favouriting Items).

You likely don't want all your customs all together at the start of the collection, so once you have finished creating the customs, you can shuffle the collection, making sure to include the favourites in the shuffle, so your custom items get randomly shuffled through out the collection (See Shuffling the Collection).

Alternatively, if you want your customs to have specific Token ID's, you can edit those specific items. If you do this, you would not want to shuffle the favourites, as this would mean your customs are no longer on those specific Token ID's.

Creating a Custom Collection

If your collection has complex requirements that can't be met with GeneratOrd's built in collection generation tool, you may need to generate the collection externally and import it into GeneratOrd. To do this, you will need to upload a JSON file that containing all the information about which traits are in each item. The format for this file is described here.

There are several ways to create this file, which are discussed below.

To upload the JSON file, click on More Actions > Upload Custom Collection (The More Actions menu can be found in the top right of the page, and is the button with the 3 dots (⋮)). You will be prompted to upload your JSON file.

If you have already created a collection, and favourited some items, then uploading a custom collection will overwrite these favourited items.

Click More Actions > Upload Custom Collection to upload a custom collection file you have created.

You will be presented with this dialog when uploading a custom collection.

JSON File Format

The collection metadata file contains all the information about which traits are in each item in the collection.

It has the following format:

[
  [
    {
      "trait_type": "<trait_type>",
      "value": "<trait_name>"
    },
    {
      "trait_type": "<trait_type>",
      "value": "<trait_name>"
    },
    ...
  ],
  [
    {
      "trait_type": "<trait_type>",
      "value": "<trait_name>"
    },
    {
      "trait_type": "<trait_type>",
      "value": "<trait_name>"
    },
    ...
  ]
  ...
]

Here is a completed example of the Metadata JSON file.

You do not need to have the same trait types, or even the same number of traits in each item. For example, you could have an optional 'Tattoo' trait type, where some items have a tattoo and some don't. On items that don't have a tattoo, simply omit that trait, meaning they will have fewer traits than items with a tattoo.

It is important that the trait types and trait names are exactly the same as those set in the Traits tab. You must also make sure that every trait referenced in the metadata file has a corresponding trait in the Traits tab.

If either of these conditions are not met, GeneratOrd will let you know, and will not let you inscribe until you resolve the issue.

Trait Order

The order of the traits within the metadata file is very important, as this determines the order in which the traits are rendered. For example, if you have the traits Background, Head, Face and Hat, then you need to make sure they appear in that order, so they are layered in the correct order:

[
  ...
  [
    {
      "trait_type": "Background",
      "value": "Blue"
    },
    {
      "trait_type": "Head",
      "value": "Yellow"
    },
    {
      "trait_type": "Face",
      "value": "Smirk"
    },
    {
      "trait_type": "Hat",
      "value": "Bucket Hat"
    }
  ],
  ...
]

Unique Items

If your collection has unique items or 1/1's, you include these the same as any other item, but they just have one trait.

[
  ...
  [
    {
      "trait_type": "Unique",
      "value": "<name of unique item>"
    }
  ],
  ...
]

Creating your Collection JSON File

Using a Script

Using a script to generate your collection does require some technical ability. While you do not necessarily need to know how to write code, you do need to be able to run a script. The generatorderv2 script has some basic instructions for how to do this.

However, if this is not something your able to do, we can help. We can generate the collection JSON file for you based on your requirements for an additional fee. The additional fee will depend on the complexity and size of the collection. Please get in contact with us if this is something your interested in.

The most common way to generate the metadata file is to use a script that creates it. If your collection has very specific requirements, you may choose to write this script yourself. However, it is more common to use a script created by someone else.

We recommend using the generatorderv2 script, which is a script initially written by @ItsFranken and maintained by the team at GeneratOrd. It is designed specifically for GeneratOrd, and creates the metadata file in the correct format. Make sure to read the README to learn how to use the script properly.

GitHub - Vanniix/generateorderv2GitHub

The HashLips Art Engine is another very common tool that is used to create the collection JSON. It has been around for a long time, and there are many tutorials explaining how to use it. However, it is no longer maintained. If you are using it, the build/_metadata.json file that it creates is the file you upload to GeneratOrd.

GitHub - HashLips/hashlips_art_engine: HashLips Art Engine is a tool used to create multiple different instances of artworks based on provided layers.GitHub

Using a Third Party NFT Generation Tool

There are many collection generation tools designed for other blockchains such as Ethereum and Solana. These can be used to generate your collection, as they have many more features. However, this does come with additional costs, as you have to pay the fees associated with these tools. Some good websites you could use include Bueno and NFT Art Generator, but there are many more.

If you use a third part tool, it may provide you with in a different format to what GeneratOrd requires, so you may have to convert it before uploading to GeneratOrd. If you are unable to convert the files yourself, then please contact us. We will happily convert metadata files made with third party tools to the required format at no extra cost.

Fortunately, both Bueno and NFT Art Generator will provide metadata files that you can upload directly to GeneratOrd without any modification.

• If using Bueno, go to Launch > Token Sets and click Get Started. Follow the prompts and after payment you will be given several formats to download the metadata. Select Metadata JSON (NOT Tokens JSONs). The downloaded file can be uploaded to GeneratOrd as described here.

• If using NFT Art Generator, go to Export and make the payment. You will be given a zip file to download. Unzip this file and open it. Find the file called metadata.json inside of the metadata folder. This file (metadata.json) can be uploaded to GeneratOrd as described here.