Minecraft Map Art Generator
Drop an image and this Minecraft map art generator fits it to a grid of 128 by 128 block maps using the official map colour table. Choose flat, staircase (three shades) or carpet-only, switch dithering on, and see the picture exactly as a filled map will show it. You also get a material list for each map, staircase heights and PNG exports. Everything runs in your browser.
How to make map art in Minecraft
- 1
Choose the picture and the map grid
Add an image, then pick how many maps wide and high (1 to 4 each, so up to 16 maps). Each map is 128 by 128 blocks. Crop keeps the proportions, stretch fills the grid.
- 2
Pick a build style
Staircase uses three shades per colour and gives the most colours. Flat puts every block on one level. Carpet only uses the 16 dye colours of carpet.
- 3
Check the preview and materials
Look at all maps together or one at a time, with its own material list. Staircase mode also shows the tallest column you will have to build.
- 4
Build and place the maps
Build the blocks, fill a map for each area, and hang the maps in item frames in the order of the Show menu (map 1 is the top left). Download the PNG, block CSV, heights CSV and material list to work from.
Map colour shades and build styles
Every map colour comes in up to four brightness levels. A map shows a block one shade lighter or darker depending on the height of the block north of it.
| Shade 255 (high) | Brightest. The block is one higher than the block to its north. |
|---|---|
| Shade 220 (normal) | The block is at the same height as the block to its north. This is the only shade a flat build uses. |
| Shade 180 (low) | Darker. The block is one lower than the block to its north. |
| Shade 135 (lowest) | Only made by deep water, so it cannot be built on land and is not used here. |
| Flat build | One level, 59 colours at the normal shade. The easiest to build, with the fewest colours. |
| Staircase build | Three shades per colour, so about three times as many colours. Needs the blocks to step up and down along each north-south column. |
| Carpet only | The 16 dye colours of carpet laid flat on any solid floor. Simple to place, fewest colours. |
| Map size | One map covers 128 by 128 blocks at the default zoom, so 4 by 4 maps is a 512 by 512 block picture. |
How Minecraft map art works
A filled map is a small picture of the ground around you, one pixel per block. Each pixel takes the colour of the top block in that column, so a wall of orange wool shows up orange and a stone floor shows up grey. Map art turns this around: you build the picture on the ground, then let a map take a photo of it from above.
The game has a fixed list of base map colours, 59 of them in this generator, such as grass, sand, the sixteen dye colours, terracotta and a few Nether and mineral colours. Each block is tied to one of them. This generator uses that list directly and shows the preview in exactly those colours, so what you see is what the map will show, apart from the biome tint of a few blocks.
Because the map reads the top block only, anything above your picture spoils it. Build the art in the open, with nothing taller overhead, and keep torches and plants off the surface.
The staircase rule, north to south
In a flat build you have one shade of each colour. A staircase build gets three by changing the height of each block compared with its neighbour to the north (the top edge of the map). A block higher than the block north of it appears brighter. A block at the same height appears normal. A block lower than it appears darker. Only the direction counts, not how many blocks up or down.
In practice every column, running north to south, is a staircase that goes up where the picture gets brighter and down where it gets darker. The generator works out the lowest heights that give every shade: each step is a single block, and a column only grows where the picture keeps getting brighter (or darker) for many blocks in a row. The Heights CSV gives the height of every block above the lowest block in its column.
The shade of the first row depends on a block one step north of the map, outside the 128 by 128 area. Put a reference row of any block there; its heights are the first line of the Heights CSV. The tallest column is shown under the preview. The limit menu keeps every column within 16, 32, 64 or 128 blocks by turning one block of a long run of brighter (or darker) steps the other way, so the column starts again from the bottom. That costs a few scattered pixels, not a patch of the picture. Build all maps as one continuous area so the columns line up from one map to the next.
Placing the maps with item frames
In Java Edition each map covers a fixed 128 by 128 area on a grid that starts at -64 in X and Z, so one map covers -64 to 63, the next 64 to 191, and so on. Build your picture inside these areas, with the corners of the art on the grid lines, or the art will be split across two maps and look cut off.
Stand inside an area holding an empty map to start it, then walk around it so it fills in, and repeat for every area. Place item frames on a wall in a grid the same shape as your maps, and put the maps in the order of the Show menu: map 1 is the top left, then across each row, with its row and column listed. On a flat floor you can lay frames on the ground instead.
Check one map in game before you commit to a big build, in case a block you chose has a biome tint or a different colour in your version. The material list is per map, so you can gather and build one map at a time.
Want a real 3D model instead of blocks?
Turn a short text prompt or a photo into a textured 3D model with AI, or bring a Minecraft skin into 3D. The block tools on this page stay free and run in your browser.
More Minecraft tools
Minecraft map art generator questions
Not affiliated with Mojang or Microsoft. Minecraft is a trademark of Mojang Synergies AB, named here only to describe what the tools are for. Block and map colours are flat approximations drawn by us; no game textures or files are used.