Skip to content
ShapeCraft

map.dat Viewer & Map to PNG

Java EditionNew

Open the map_<n>.dat files from a world's data folder and see exactly what each filled map shows — for backing up map art, sharing a map wall, checking a trade before you buy, or turning an old exploration map into a picture. Drop one file or a whole folder's worth, download each as a PNG or stitch them into one image in map-number order or by where they sit in the world. Nothing is uploaded: the files are read in your browser.

Map files

Stitched image

auto · 1

×

512 px per map

Maps
0
none yet
Image
—
map pixels
Empty pixels
—
transparent / unexplored

Preview

Drop map .dat files to see them here. Want to make one? Use the map art generator.

Export

How it works

Java Edition stores every filled map as its own file: <world>/data/minecraft/maps/<n>.dat since 26.1, and <world>/data/map_<n>.dat in 1.21.11 and older, where n is the number shown in the map's tooltip (#n). The file is gzipped NBT with a 16,384-byte colours array — one byte per pixel of the 128×128 map, row by row from the north-west corner — plus the map's scale, dimension, centre and locked flag.

Each byte is baseColour × 4 + shade. The viewer looks up the base colour (grass, sand, wool, stone, the 16 dye colours, terracottas, nether and deepslate colours… 61 base colours, water included) and multiplies it by the shade factor Minecraft uses: 180, 220, 255 or 135 out of 255. Byte 0 is transparent — that's the unexplored part of a map or the empty pixels of a transparent map art — and stays transparent in the PNG.

For a wall of maps, choose file order (with the number of columns of your wall) or world position: maps of the same scale are placed by their centre coordinates, so neighbouring maps line up just as they do on the wall in-game.

Under the hood

Pixel colour
byte = baseId × 4 + shade · rgb = base × [180, 220, 255, 135][shade] ÷ 255
Pixel index
colors[x + z × 128], x east, z south
Map area
a scale-k map covers 128 × 2^k blocks centred on (xCenter, zCenter)

FAQ

Where are the map files?

26.1 and newer: <world>/data/minecraft/maps/, named <n>.dat ("#12" → 12.dat). 1.21.11 and older: <world>/data/, named map_<n>.dat. The world folder is .minecraft/saves/<world> in single player, or the world folder of a server. last_id.dat (idcounts.dat before 26.1) only stores the last id used — it has no picture.

Can I turn the PNG back into a map?

Yes — open the PNG in the map art generator, set the size to the same number of maps, turn dithering off and export map_<n>.dat files or a schematic to build it. The colours match because the PNG uses the real map palette (except the rare fourth, darkest shade, which only map files can show).

Why are parts of the map transparent?

Byte 0 means "nothing drawn": areas nobody has explored with the map in hand yet, or the empty pixels of transparent map art. The PNG keeps them transparent so you can put the picture on any background.

Does it work for Bedrock Edition maps?

No. Bedrock keeps maps inside the world's LevelDB database instead of map_<n>.dat files, so there is no file to drop. Java maps from any version since 1.13 work, and older files with a numeric dimension are read too.

All tools →