About

CryptoPunk-style avatars are 24×24 pixel grids where each pixel carries semantic weight. A single misplaced pixel breaks facial symmetry and destroys recognizability at thumbnail scale. This generator constructs avatars procedurally from layered trait maps: base type, skin tone, hair, eyes, mouth, and accessories. Each trait is a hand-coded pixel matrix composited in z-order onto the base canvas. The total combinatorial space exceeds 10⁸ unique configurations. Randomization uses uniform distribution across trait categories, but real-world avatar collections weight rarity tiers logarithmically. This tool approximates flat rarity. For production NFT collections, you would need off-chain metadata with explicit rarity percentages per trait.

Export resolution matters. The native 24×24 grid is scaled with nearest-neighbor interpolation to preserve hard pixel edges. Bilinear or bicubic scaling destroys the aesthetic. This tool exports at 24, 96, 192, and 384 pixel widths. For on-chain storage, the 24px version is canonical. For social media avatars, 192px or above avoids platform compression artifacts.

Formulas

The total unique avatar count is the Cartesian product of all trait dimensions:

N_total = k∏i=1 n_i

where k is the number of trait categories and n_i is the option count in category i.

Pixel compositing follows painter's algorithm. For each pixel at coordinates (x, y), the final color is:

C_final(x, y) =

{

C_{layer_j} if α_j = 1C_{layer_j−1} if α_j = 0

where j iterates from the topmost layer downward. No alpha blending is used. Each pixel is either fully opaque or fully transparent (binary compositing). Export scaling uses nearest-neighbor interpolation:

C_out(x, y) = C_src(floor(xs), floor(ys))

where s is the scale factor (4, 8, or 16).

Reference Data

Trait Category	Options	Layer Order	Combinatorial Weight
Base Type	Human, Zombie, Ape, Alien	0 (bottom)	4
Skin Tone	Light, Medium, Dark, Olive, Pale, Gold	0	6
Hair Style	Mohawk, Wild, Messy, Frumpy, Straight, Shaved, Pigtails, Clown, Cap, Beanie, Bandana, Headband, Tiara, None	3	14
Hair Color	Black, Blonde, Brown, Red, Purple, Blue, Green, Orange, Pink, White	3	10
Eyes	Normal, Small, Big, Narrow, VR, Glasses, Sunglasses, Eyepatch, Clown, Wink, Tired, Angry	2	12
Mouth	Normal, Smile, Frown, Lips, Teeth, Pipe, Cigarette, Mask, Buck Teeth, Open	2	10
Accessories	Earring, Chain, Nose Ring, Mole, Scar, Rosy Cheeks, Spots, None	4 (top)	8
Background	Solid color (any hex)	−1	∞
Export: 24px	Native resolution	-	Canonical
Export: 96px	4× scale	-	Thumbnail
Export: 192px	8× scale	-	Social media
Export: 384px	16× scale	-	Print / HiDPI
Total Combinations	4 × 6 × 14 × 10 × 12 × 10 × 8 = 3,225,600 unique avatars

Frequently Asked Questions

Social media platforms and messaging apps often apply bicubic resampling to uploaded images, which smears hard pixel edges. Export at 384px (16× scale) to give the platform enough resolution headroom. Some platforms also convert PNG to JPEG, which introduces compression artifacts around high-contrast pixel boundaries. There is no workaround for server-side JPEG conversion.

Each trait is selected independently with uniform probability across its option set. With 3,225,600 combinations, the probability of generating two identical avatars in a batch of n is governed by the birthday problem: P(collision) ≈ 1 − e^{−n²/6,451,200}. For batches under 1,000, collision probability is negligible. For large collections, implement a hash-based deduplication pass.

The pixel art produced by this tool is generated algorithmically from original trait matrices coded into the application. No copyrighted CryptoPunks artwork is used. However, the visual style is derivative of CryptoPunks by Larva Labs. Using generated avatars as profile pictures is generally safe. Minting and selling them as NFTs claiming association with CryptoPunks would be misleading. Consult intellectual property counsel for commercial NFT projects.

Alien base types use a fixed green skin color (#C8FBFB) consistent with the original CryptoPunk aesthetic convention. Ape types use a fixed dark brown (#6B4226), and Zombie types use a fixed gray-green (#7DA269). Only Human base types respect the skin tone selector. This is intentional to maintain visual consistency with the genre.

The original CryptoPunks used a flat purple-blue background (#638596). For general-purpose avatars, a mid-saturation background with lightness between 40% and 60% provides good contrast against both light skin tones and dark accessories. Avoid pure white or pure black backgrounds as they reduce perceived detail in highlight and shadow pixels respectively.

Each trait has a fixed z-order: background (−1), base/skin (0), facial features (2), hair (3), accessories (4). Higher layers overwrite lower layers using binary compositing (no alpha blending). Some trait combinations naturally conflict (e.g., a full-face mask hides mouth traits). The generator does not enforce compatibility constraints. You can manually resolve conflicts by changing one of the overlapping traits.