BITHEADZ-ARTENGINE

Free NFT generator with layer-based composition, rarity controls, and metadata generation

Layer Upload

📁

Drag & drop layer folders here or click to browse

Upload individual layer folders (Background, Body, Eyes, etc.) - not the parent folder containing all layers.

Layer Structure

Upload layers to see preview

Collection Settings

Collection Name

Collection Size

Description

Custom IPFS CID (Optional) Leave empty to use placeholder CID. Format: Qm...

Advanced Configuration

Rarity Settings

Rarity Mode Bell Curve creates natural rarity distribution, Random gives equal chance to all traits

Layer Configuration

Active Layers & Probabilities

Toggle layers on/off and set probability percentages (1-100%)

Generation Status

Ready to generate

Download

Your collection is ready!

Support the Cause

5Zd2EiC7S2DaT5mQyC1etYmusNPyEQtHDgojdf5oLHLE

Click the address above to copy it to your clipboard. Your support helps keep this tool free and accessible to everyone.

📚 How To Use

🖼️

1. Prepare Layers

Organize your PNG trait images in folders (e.g. 01_Background, 02_Body).

⬆️

2. Upload Folders

Upload each layer folder. The engine auto-detects order and structure.

🎛️

3. Configure Layers

Toggle layers on/off and set rarity probabilities (1–100%).

⚠️

4. Uniqueness Check

If you request more NFTs than possible unique combinations, you'll see a warning. Choose to upload more traits, reduce collection size, or "generate anyway" (with duplicates).

🚀

5. Generate & Download

Click Generate, watch the progress, and download your ready-to-mint collection!

📁 Layer Organization & Folder Structure

🎯 Flexible Folder Naming

The system works with any folder names you choose. You have two options for controlling layer order:

Automatic Ordering: Use any folder names (Background, Body, Eyes, etc.) - they'll be ordered alphabetically
Custom Ordering: Use numeric prefixes (01_Background, 02_Body, 03_Eyes) to specify exact layer order
Any Names Work: Hats, Clothing, Weapons, Accessories, etc. - all supported
Smart Detection: System automatically detects your folder structure and organizes layers

📂 Folder Structure Examples

                      
                        Background/

                        ├── background1.png

                        ├── background2.png

                        └── background3.png

                        Body/

                        ├── body1.png

                        ├── body2.png

                        └── body3.png

                        Eyes/

                        ├── eyes1.png

                        ├── eyes2.png

                        └── eyes3.png

Or with custom ordering:

                      
                        01_Background/

                        02_Body/

                        03_Eyes/

                        04_Accessories/

Important: Upload each folder individually, not the parent folder containing all layers.

🖼️ Image Processing & Optimization

⚡ Automatic Compression

Large images are automatically processed for optimal performance:

Images larger than 1MB are compressed to 1000x1000 pixels
Maintains aspect ratio during compression
Smaller images (under 1MB) are used as-is
Sequential processing to avoid memory issues
Fallback to original images if compression fails

💾 Memory Management

Built-in optimizations for efficient resource usage:

Low memory mode enabled by default
Automatic garbage collection
Sequential image processing
Background job management with cleanup
30-second timeout per image compression

🎲 Rarity & Distribution Systems

📊 Bell Curve Distribution (Recommended)

Creates natural rarity distribution where:

Common traits appear frequently
Rare traits appear occasionally
Very rare traits appear seldom
Mimics real-world trait distribution

🎯 Random Distribution

Pure random selection where:

All traits have equal chance
No rarity weighting
Good for experimental collections

⚖️ Equal Distribution

Balanced distribution ensuring:

Each trait appears roughly the same number of times
Perfect for limited trait sets
Predictable rarity structure

⚙️ Advanced Layer Configuration

🎛️ Layer Toggles & Probabilities

Fine-tune your collection with precise controls:

Toggle On/Off: Enable or disable entire layers
Probability %: Set appearance chance (1-100%)
Real-time Preview: See layer structure instantly
Smart Defaults: Backgrounds at 100%, accessories at lower %

📈 Usage Examples

Standard Collection:

Background: 100% (every NFT gets a background)
Body: 100% (every NFT gets a body)
Accessories: 30% (only 30% of NFTs get accessories)
Rare Items: 5% (very rare special items)

🏷️ Collection Configuration

📝 Metadata Settings

Collection Name: Appears in NFT metadata
Description: Detailed collection description
Custom IPFS CID: For custom image hosting
Collection Size: 1-10,000 NFTs supported

📦 Output Structure

Images: PNGs in /images/
Metadata: JSON files in /metadata/
Download: All files in a single ZIP