A Minecraft map can store 61 base colors. Flat map art uses one brightness, so it works with a single layer of blocks. Staircase map art steps blocks up and down to reach three, for 181 colors in all. Drop in an image to see your art matched to those colors.
Your image never leaves your computer. Resizing and palette matching happen here in your browser, and the page makes no network request with your file. A share link is the one thing that gets uploaded, only when you press the button, and it carries the finished block grid rather than the picture.
Turn Any Image Into Minecraft Map Art
Minecraft map art is a picture built from blocks so that, seen through a map item, it reads as your image. This tool does the hard part: it resizes your picture to a 128 by 128 grid, or a larger grid of maps, and matches every pixel to the nearest map color. You get a live preview, the exact blocks to place and a PNG to build from, all in your browser with nothing uploaded.
Each pixel on a map stores one of 61 base colors, and the game renders that color darker, normal or lighter depending on the height of the block to the north. (A fourth, darkest level exists, but the game only draws it on explorer maps, so no block you place can reach it.) The tool builds the same color table the game uses and snaps your image onto it, so the preview matches what you will see in game.
Pick a single map for a quick build, or set the width and height separately, up to 4 maps each way. A 2 by 1 layout suits a landscape painting and 1 by 2 a portrait, while a 4 by 4 grid still covers a whole wall of item frames. The tool splits a big build into one tile per map so you can place and download them one at a time.
Flat vs Staircase, and Dithering
Flat map art keeps the whole build on one level. Because the map shades a pixel by the height difference to the block north of it, a flat carpet of blocks always renders at the middle brightness. That gives you one shade of each color and a build anyone can lay down in an afternoon. It is the honest default for a first map.
Staircase map art steps each row of blocks up or down, which lets the game pick the dark, normal or light brightness of any color. That takes the palette to 181 colors and is what large, photo-quality map art uses, at the cost of a much more careful build.
Dithering trades clean color areas for a wider apparent range. Floyd-Steinberg spreads the rounding error of each pixel into its neighbours for the smoothest look, ordered dithering applies a fixed cross-hatch, and none leaves flat blocks of color that suit logos and pixel art.
How To Build Your Map Art
1. Drop in your image and choose how many maps wide and tall the build should be.
2. Pick flat for a single-layer build or staircase for the full palette, then turn dithering on if your image has gradients.
3. Read the material list for the exact blocks and counts, and gather them. The blocks shown are cheap stand-ins; any block with the same map color works.
4. Build the grid to match the preview, place a map item on the finished art, then hang the map in an item frame. Download the PNG to follow along row-by-row.
Share Map Art With A Friend
Two people who upload the same picture do not get the same build. The resize runs through the browser's own resampler, and Chrome, Firefox and Safari each round the pixels differently; a picture that has been through a chat app comes back re-encoded on top of that. A handful of pixels land on a different map color, and the material list, the block counts and the guide lines all move with them.
Sharing the design moves the finished grid instead of the picture. Copy share link gives you a link to paste, and Save design file gives you a .mcmapart you can attach in Discord. Whoever opens it sees the same blocks, the same counts and the same numbered guide lines, so a build splits cleanly: one of you takes lines 1 to 64 of a map, the other starts at 65.
Frequently Asked Questions
How do I turn an image into Minecraft map art?
Drop your image into the tool, pick how many maps wide and tall you want, and it resizes the picture to that grid and matches every pixel to the nearest Minecraft map color. You get a live block-by-block preview, a material list of which blocks to place, and a PNG you can keep on a second screen while you build.
Can I make wide or tall map art, like 2x1 or 1x2?
Yes. Wide and Tall are set separately, from 1 to 4 maps each, so a landscape painting goes on a 2 by 1 wall and a portrait on 1 by 2. If your picture's shape doesn't fit the layout you picked, a Match picture shape button offers the closest one, which saves cropping the image by hand first. Every map is still 128 by 128 blocks, and the exports, the share link and the build guide all follow the layout.
What is the difference between flat and staircase map art?
A flat map sits on one level, so every block renders at the middle brightness. That limits you to one shade of each map color, 61 colors in total, but it is the easiest to build. Staircase map art steps each north-south row up or down a block, which unlocks the darker and lighter shades of every color, 181 in total, at the cost of a more involved build. Water is the exception in both modes: a map shades water by how deep it is rather than by height, so a single water block always draws in its light shade. Minecraft has a fourth, darkest brightness too, but only explorer maps use it, so map art cannot.
Does the biome or the height I build at matter?
In Java Edition, the biome doesn't matter and neither does the Y level you start at. A map takes each block's own map color and never checks the biome, so grass, leaves and water are the same color in every biome. Staircase shading compares each block with the one directly north of it, so only the steps between rows count, as long as the tallest column fits under the build limit (the build height is shown next to the downloads). Two things do matter: build in the Overworld or the End, because a map made in the Nether shows a noise pattern instead of the blocks, and use a map that hasn't been zoomed out, so each block is one pixel.
How many blocks does map art use?
One 128 by 128 map is 16,384 blocks if you fill it edge to edge. The tool counts the exact blocks for your image, broken down by color, and shows how many stacks of 64 each color needs. A grid of maps multiplies that, so a 2 by 2 build can reach about 65,000 blocks.
Should I use dithering?
Dithering mixes nearby colors so your eye blends them into shades the palette does not have, which helps with photos and gradients. Floyd-Steinberg looks the smoothest and is the usual pick. Ordered makes a regular cross-hatch pattern. None gives clean flat areas of a single color, which suits logos, pixel art and flat illustrations.
Does the tool give me the actual blocks to place?
Yes. The material list pairs each map color with one cheap, easy-to-place block that produces that color in Minecraft 26.3, such as wool, terracotta or planks, and tells you how many of each you need. Lay them out to match the preview, top-down for flat art.
Can I download a schematic or a litematic?
Yes. Structure .nbt gives one file per map, the format a structure block loads and Litematica, WorldEdit and the schematic viewers all import. Each file has its own noobline, which suits building one map, locking it, then starting the next. Litematica gives one .litematic of the whole piece, with every map in place, which is what most builders project into the world and fill in block by block, and the one to use for a wall of touching maps built in one go. Both carry the staircase heights the shading needs, the glass that keeps any water in place, plus the support row at the north edge that builders call the noobline. That row is why each file is one block longer than the art, so a 2 by 2 litematic measures 256 by 257. Place the file so that row sits just north of the map edge, outside the area the maps draw.
What are the map .dat files for?
They are the map items themselves. Set First map id to a number above every map your world already has, then stop the world or server, unzip the download into the world folder and start it again. Current versions read the files in data/minecraft/maps, older ones the map_N.dat copies next to them. Give yourself each map with /give @s filled_map[map_id=N]: the picture is already drawn, with no building at all. The zip also raises the world's map counter, so maps crafted later get new numbers instead of drawing over yours. It is the fast route for a wall of art on a server you own, and the only route that needs no blocks. Survival players want the schematic instead.
Can I share a design with a friend?
Yes. Press Copy share link and send the link, or save the design file and send that instead. Whoever opens it gets the same material list, the same block counts and the same build guide, line for line, which is what lets two people split one build. Sending the picture and asking them to upload it again does not work: browsers resize images differently and chat apps re-encode them, so some of the pixels land on a different map color and the counts drift apart.
Is my image uploaded anywhere?
No. The resizing, palette matching and dithering all run in your browser, so your picture never leaves your device and there is no watermark. A share link is the one exception, and only when you press the button: it uploads the finished block grid, never the image.
Already have a map file? Pull it back to an image, or browse more Minecraft tools: