Map art: why your image looks wrong, and the 3-shade trick that fixes it
Maps have 61 base colours, not 16 million — but each has four shades set by block height. Staircasing triples your palette and is why good map art is never flat.
Convert an image to blocks and the first attempt always looks washed out. The reason is that a flat build only uses a third of the colours available.
Maps store colour ids, not pixels
A filled map records, per pixel, the map colour of the topmost block plus a shade. There are 61 base map colours. Two blocks that look different in the world can share a map colour — all the wood planks collapse toward the same few, which is why a build that looks varied maps as a flat brown.
Shade is height, and it triples the palette
Each base colour renders in four shades chosen by comparing a block's height to its northern neighbour:
| Neighbour to the north | Shade |
|---|---|
| Lower | lighter |
| Same height | normal |
| Higher | darker |
So the same wool in three staircased rows gives three distinct tones. 61 × 3 usable shades is roughly 180 colours instead of 61 — the difference between a poster and a smear.
The fourth shade only occurs for water at depth and is not usable for building.
Flat versus staircase
Flat — one Y level. Easy, fast, survival-friendly, and limited to 61 colours. Fine for logos and flags with hard edges.
Staircase — each row can step up or down. Triple the palette, far better gradients, and the build climbs: a 128-block map can rise many blocks over its length. Plan the starting Y so you do not hit the height limit or the ground.
Almost every impressive map art is staircased. If yours looks dull, that is usually why.
Dithering
The converter has to pick the nearest available colour for each pixel, and the naive choice produces banding. Dithering scatters the error into neighbouring pixels, trading noise for smoother gradients. Good for photographs, bad for flat logos where it adds speckle to what should be solid.
Practical constraints
- One map is 128×128 blocks. Larger art is a grid of maps in item frames.
- Some map colours need blocks you cannot farm — several require dyes or Nether
materials in quantity. Filter the palette to what you can actually get before committing to a design.
- Plants and non-full blocks map as the block beneath them in some cases; keep the
surface to full solid blocks.
- The map must be created at the right zoom and position, and you must physically
walk the area to fill it in.
Reading an existing map back
A map_*.dat in the world's data/ folder holds the colour ids. Converting that back to a PNG is lossless in one direction — you get exactly what the map shows — but it cannot tell you which blocks were used, only which colours resulted.
Convert an image with your choice of flat or staircase and a filtered block palette in the Map Art Studio, or turn an existing map.dat back into a PNG with the Map Art Extractor.