Docs
Generate 1/1 Loopers

Generate 1/1 Loopers

Overview

This guide outlines the steps to generate 1/1 Loopers that include their PFPs (Profile Picture), LooperLands sprite sheets, and metadata from individual sprite sheets. This process can be particularly useful when you have an array of sprite sheets with different traits.

πŸ“˜

Important: Make sure to verify the authenticity of your sprite sheets and metadata before committing. Incorrect or corrupt data can result in unusable or misleading LooperLand Items.

Requirements πŸ“‹

Steps

Initiate Generate 1/1 Loopers

Navigate to the 1/1 Creation Section within the Maize Menu. Here, you'll find the Generate 1/1 Loopers option. Click on it to start.

Input all information

  • Choose the LooperLand's Item you are creating and populate the NFT Name, NFT Description, Collection Address, Royalty Percentage, Iterations, and Input Directory. The chart below provides additional information on each.

  • The option to Allow Duplicates will create sprites that are the same.

Generate 1/1 Loopers

FieldDescriptionExample
NFT NameBase name for the NFTsAlpha CobLoopers
NFT DescriptionDescription for each NFTAlpha CobLoopers provide access to Alpha Fields!
Collection AddressBlockchain Address for the collection0xa6a1de23cfe7a2cbd9d3c63d53efd263426bc8ed
Royalty PercentagePercentage of royalties on sales (1-10%)5
IterationsNumber of 1/1s to create10
Input DirectorySprite's folder locationC:\cobmin\LL_Ready

Process the sprites

Once all information has been populated click the Process button.

Generate 1/1 Loopers

Review the Results

Upon completion, the application will automatically open the folder with the generated assets. Review content to ensure everything is as intended. Feel free to change the metadata as needed.


Image 1
Image 2
πŸ“˜

FYI Original files are never modified or deleted so feel free to test without worry. However, backups are always recommended.

Congratulations! πŸŽ‰

You have successfully generated 1/1 LooperLands' Items. Well done!

Now its time to Mint!

Folder and File Setup

The organization of folders and file names dictates how sprites are stacked, what data is included in metadata, and the maximum allowable percentage of each sprite, if applicable.

πŸ“˜

FYI: Anywhere an underscore is used a space will replace it when necessary. In file and folder names, best practice is to use an underscore in place of a space.

Main Folder structure

In your base directory, you should create folders that are prefixed with a number followed by an underscore (e.g., 0_background, 2_clothes). The purpose and contents of these folders are elaborated below.

The application selects a random sprite from each folder and stacks them in ascending order, starting with the folder prefixed 0.

Folder Structure

Metadata File Structure

Both the folder names and file names inform the properties and attributes of metadata. While the discussion below focuses on properties, the same principles apply to attributes.

Basic

In a straightforward setup, the folder name acts as the metadata Key, while the file name becomes its corresponding Value. For instance, in a folder named 0_background, a file named greenlight.png would result in a metadata key-value pair of "background: greenlight."


Image 1
Image 2

Advanced Folder Naming

When you need to select either one or multiple sprites from a set, use an ampersand (&) at the end of folder names that are meant to be considered together. For example, a folder named 2_clothes could contain a folder named outfit, clothes_top&, and clothes_bottom&. In this instance either 1 outfit will be chosen or 1 clothes top and 1 clothes bottom.

The metadata will not show clothes in this instance but outfit or clothes bottom and clothes top as the Key(s) with the respective file name inside as the Value.

Advanced Folder

Advanced File Naming

File names can also carry special symbols to influence sprite selection, expand metadata, or control their maximum occurrence percentage.

Maximum Occurrence

To set a maximum occurrence percentage for a sprite, prepend the file name with X#N, where N is the maximum percentage allowed. For example, X#5_SunsetRoseBlush.png will appear in no more than 5% of the iterations.

Maximum Occurrence

Excluding Directories from Maize Rarity Calculations

There may be instances where you want to exclude an entire directory from contributing to the uniqueness calculation of an NFT. This can be particularly useful for elements that are foundational but not distinct, such as backgrounds. To achieve this, insert an exclamation mark (!) between the directory number and the underscore. For instance, 0!_background would exclude the "background" directory from the rarity computation, ensuring it doesn't affect the uniqueness of each NFT.

Exclude background Directory with 0!_background

Metadata Expansion

File names can also include additional metadata using the - and + symbols. For example, the file Bob-Hair_Color+Black.png will result in two metadata entries: one for "Hairstyle: Bob" and another for "Hair Color: Black."

Expanding Metadata