Minecraft Map Art Generator (Java)
Turn any picture into Minecraft map art: it's matched to the 60 map colours (3 shades each with a staircase), split over up to 4×4 maps, with a block list and Litematica, WorldEdit and map.dat downloads for Java.
Runs on your device · nothing uploaded
This tool is code that runs inside your browser. Your files, text and pictures are read here and never sent to a server, so it even works offline once loaded. Signed in? Only what you save to your account (My Kit, wardrobe) or publish is uploaded.
Flat vs staircase
| Compare | Flat | Staircase |
|---|---|---|
| Colours available | 60 | 180 |
| Build | One layer on the ground | Columns that step up and down |
| Best for | Logos, pixel art, beginners | Photos and smooth shading |
How to use it
- Choose a picture and how many maps wide and tall the art should be.
- Pick flat (one layer, easy) or staircase (blocks at different heights, 3× the colours).
- Choose dithering: Floyd–Steinberg for photos, none for logos and pixel art.
- Download a .litematic or .schem to build it, or map.dat files to drop straight into a world.
How it works
A map pixel's colour comes from the block's map colour and its height compared with the block north of it: higher shows the bright shade, level the normal shade, lower the dark shade. Flat art uses only the normal shade; staircase art plans each column's heights so every pixel gets the shade it needs, starting from a noobline row on the north edge. Colours are matched with a perceptual distance, and dithering spreads the error to neighbours so gradients look smooth. Map colours follow the game's base colour table.
Questions
How do I copy the map art onto a map?
Build it in a 128×128 area aligned to the map grid, stand in the middle and use an empty map, or place the map.dat files in your world's data folder and give yourself filled_map with that map_id.
What is a noobline?
A row of blocks just north of the art. The first row's shade depends on the block north of it, so the noobline makes the top row show the right colours.
Why does my map look darker than the picture?
Flat map art only uses the middle shade of each colour. Switch to staircase for brighter and darker shades.
Does this work on Bedrock?
The files are for Java. Bedrock maps use slightly different colours for some blocks, so the art may look off there.
How big can map art be?
Each map is 128×128 blocks. This tool splits pictures over up to 4×4 maps (512×512 blocks); hang them in item frames to show the whole picture.
Related tools
By PickaxeKit Editorial Team. Updated 2026-11-09.