Minecraft Pixel Art Generator

How to use the Minecraft pixel art generator

1. Choose an image or drop one on the box. Simple images with bold shapes and few colors give the cleanest builds.
2. Set the width in blocks. The height follows your image, so a square image stays square.
3. Pick the block types you have, or want to collect. Concrete, wool and terracotta are on by default.
4. Try dithering for photos; leave it off for sprites and logos.
5. Download the build plan and materials list, gather the blocks, and build row by row from the bottom. Hover over the preview to check a block, or click a block in the list to see everywhere it goes.

How the color matching works

Every block color comes from Minecraft itself. A script downloads the official Minecraft: Java Edition 26.3 client from Mojang, keeps the 130 full blocks that show the same solid, non-animated texture on all six faces, and averages each texture's pixels. The average is taken in linear light, not raw RGB values, so it's closer to how the block looks from a distance.

Your image is scaled to the size you chose, and each pixel gets the block whose color looks closest. Closeness is measured with CIEDE2000, the CIE's standard formula for how different two colors look (ISO/CIE 11664-6). It weighs lightness, saturation and hue separately, so a dark green pixel gets green wool instead of the lime concrete that a plain CIELAB distance picks. Pixels that are more than half transparent are left empty.

With dithering on, the generator uses Floyd–Steinberg error diffusion: the difference between a pixel and its block is passed on to the neighboring pixels, so areas mix two or more blocks to suggest a shade in between. Everything runs in your browser; the image is never uploaded.

Concrete, wool and terracotta colors

The average color of each of the 16 dye colors, as used by the generator (Minecraft 26.3). Plain, undyed terracotta is #985E44.

Need a break from building? Check your setup with the mouse test, thekeyboard test or the FPS test.