Minecraft Map Art Pixel Art Generator

Pick a file from your device, choose a size and palette mode — the tool matches every pixel to the closest map color and counts how many pixels of each block appear in the image itself (not counting staircase support blocks or the map's north reference row).

Processing happens entirely in your browser — the file is never uploaded anywhere.

Palette colors

Untick blocks that are hard to obtain — the matcher will stop using those colors.

Preview

This is a sample built from a synthetic pattern. Upload your own image above to get a real result.

Materials list

ColorBlock (example)PixelsStacksShulker boxesLeftover
yellow (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)223434158
water19283018
purple wool187129115
block of diamond149023018
block of gold146422056
light blue (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)7121108
light gray (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)66510025
glow lichen65310013
blue (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)585909
block of raw iron5388026
block of lapis lazuli4757027
acacia (planks, log (vertical), stripped log, stripped wood, sign, trapdoor, slab, stairs, pressure plate, fence gate, fence, door)4396055
magenta terracotta389605
light blue terracotta3615041
crimson planks3365016
magenta (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)3355015
sand2523060
pink (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)2363044
grass block2153023
lime (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)1892061
crimson nylium1402012
dirt136208
cyan (wool, carpet, shulker box, bed (foot), stained glass, glazed terracotta, concrete, concrete powder, candle)135207
mushroom stem1141050
yellow terracotta1071043
block of iron881024
pink terracotta71107
clay470047
white terracotta440044
light gray terracotta390039
oak (planks, log (vertical), stripped log, wood, stripped wood, sign, door, pressure plate, fence, trapdoor, fence gate, slab, stairs)250025
warped planks250025
warped wart block230023
blue terracotta130013
warped nylium6006
block of emerald2002
stone (slab, stairs)1001
warped hyphae1001

How we calculate

An item map can only show a limited set of colors: every block's base color gets multiplied by one of a few brightness factors, giving a palette of 61 colors on a flat map, or 183 if you build with a one-block step between rows. For every pixel of your image the tool looks for the closest available palette color using a weighted RGB distance, not a single color channel.

Dithering (the Floyd-Steinberg method) does not change the palette itself — it spreads each pixel's rounding error onto the neighbors to its right and below. That makes smooth gradients in a photo look less "banded", even though the game still only shows the exact same number of distinct shades.

The materials list only counts blocks that actually appear in the result, showing one representative block per palette color and converting the totals into stacks (64 items) and shulker boxes (27 stacks). Colors that are hard to obtain can be toggled off in the palette list so the matcher skips them entirely.

Sources

checked 17 September 2026

Questions and answers

Is my image uploaded to a server?

No. Reading the file, processing it and building the pixel art all happen in your browser on a canvas. The link that saves your settings only stores the size, mode and the list of disabled colors — the image itself is never included and never sent anywhere.

What is the difference between "flat" and "staircase" mode?

On a flat floor a map can only show one shade of each block's base color, so 61 colors are available. Building the art with a one-block height step between rows lets the game apply a different brightness factor per row, unlocking 183 colors — a more accurate image, but a harder build.

Why use dithering, and is it always better?

Dithering spreads the color rounding error onto neighboring pixels, so smooth gradients look less banded from a distance. On small, sharp artwork or logos it can instead add unwanted "noise" — for images like that, try turning it off and comparing the result.

What does "representative block" mean in the materials list?

Several different blocks in the game can share the exact same map base color (several wool colors of the same shade, for instance). The tool shows only one example block per palette color — to see every block that would work, check the full list of options on the wiki.

Why is the grid limited to a certain number of maps?

The 8-map limit per side is the tool's own practical choice, not a game rule: a larger grid makes the in-browser preview noticeably slower and turns the materials list into something too long to read comfortably.

All Minecraft guides

Unofficial tool. Not affiliated with the developers or publishers of Minecraft.