Image to Map Art Generator
Java & BedrockNewTurn a picture into a Minecraft map art that looks exactly like the preview when you hang it in an item frame. Choose a grid of up to 8×8 maps, flat, staircase (classic or the much lower valley layout) or unobtainable shading (all four map shades, for map files you don't build), which blocks you have for each map colour (carpet-only, wool, concrete, survival-cheap and no-rare-blocks presets, 1.21.4 pale oak and resin included), dithering and support blocks. Safe build is on by default: it avoids blocks that burn, that endermen steal or that change colour, and always supports blocks that fall. Touch up any pixel by hand, make transparent maps, then download a Litematica / WorldEdit / structure file for the whole art or per map, a supports-only file, ready-made map .dat files, and a material list with a survival build estimate. Everything runs in your browser.
Image
Map grid & crop
128 × 128 blocks · 1 map
Shading
Three shades per colour with the lowest possible staircase (recommended).
Colours & blocks
All 60 placeable map colours, easiest block for each
Per-colour blocks · 60 of 60 colours on
- Grass
- Sand
- Wool
- Fire
- Ice
- Metal
- Plant
- Snow
- Clay
- Dirt
- Stone
- Wood
- Quartz
- Orange
- Magenta
- Light Blue
- Yellow
- Lime
- Pink
- Gray
- Light Gray
- Cyan
- Purple
- Blue
- Brown
- Green
- Red
- Black
- Gold
- Diamond
- Lapis
- Emerald
- Podzol
- Nether
- White Terracotta
- Orange Terracotta
- Magenta Terracotta
- Light Blue Terracotta
- Yellow Terracotta
- Lime Terracotta
- Pink Terracotta
- Gray Terracotta
- Light Gray Terracotta
- Cyan Terracotta
- Purple Terracotta
- Blue Terracotta
- Brown Terracotta
- Green Terracotta
- Red Terracotta
- Black Terracotta
- Crimson Nylium
- Crimson Stem
- Crimson Hyphae
- Warped Nylium
- Warped Stem
- Warped Hyphae
- Warped Wart Block
- Deepslate
- Raw Iron
- Glow Lichen
- can burn: Oak Leaves, Oak Planks, Spruce Planks
- endermen can steal it: Clay, Crimson Nylium, Warped Nylium
Gravity blocks and carpets need a block underneath; 'all' makes the whole build sturdier.
Colour & dithering
Error diffusion (Floyd–Steinberg, Atkinson…) blends gradients and photos; ordered (Bayer) gives a regular, easier-to-build pattern; None keeps flat areas clean.
World position
The top-left map is centred on x 0, z 0. Selected map 1,1: blocks x -64…63, z -64…63, noob line at z -65 · map_0.dat
Map preview
Materials
No blocks yet.
Export
Pick the version you play. Newer versions load files made for older ones, but an older game places nothing from a newer file (no error).
Builds include the noob line (the row just north of the art) and support blocks under gravity blocks and carpets. "Supports only" and "Blocks only" files have the same size and origin as the full file, so you can build the support layer first and line the rest up exactly. Commands are relative to you: ~ ~ ~ is the bottom north-west corner of the build (the noob line row); "Commands per map" gives one function per map with a README of where to stand.
Have map_<n>.dat files already? View and save them as PNG with the map.dat viewer.
How it works
A filled map shows each 1×1 column of the world as one pixel. Every block has a base map colour (wool, sand, stone, red, terracotta…, about 60 in total) and the map draws it in one of three shades depending on height: darker when the block is lower than the one to its north, normal when level, lighter when higher. Flat map art uses only the normal shade; staircase map art varies the heights so every colour is available in all three shades — roughly 180 colours instead of 60, which makes photos dramatically better.
The generator crops and resizes your image to 128 pixels per map, applies brightness, contrast and saturation, then matches every pixel to the closest enabled colour-and-shade in perceptual OKLab space with optional dithering (Floyd–Steinberg, Atkinson, Jarvis–Judice–Ninke — MapartCraft's MinAvgErr — Stucki, Burkes, the Sierra family, or ordered Bayer 2×2 / 4×4 / 8×8 and the 3×3 matrix). The preview is drawn with the exact shade multipliers Minecraft uses (180, 220 and 255 out of 255, plus 135 in unobtainable mode), so what you see is what the map will show.
For staircase art the heights are derived column by column from north to south, starting from the 'noob line' — an extra row of blocks just north of the art (z = −1 of the map) that the first row is shaded against. Classic mode climbs or drops one block per step; valley mode notices that a darker pixel may drop by any amount, so it lets each run fall back down to the floor and ends up far lower, which is cheaper and much easier to build. An optional height limit keeps every column within reach and reports how many pixels had to change shade.
Transparent pixels in your image can stay empty: no block is placed and the map file's pixel is transparent, so a logo floats on the item frame. In a built map the block just south of a gap compares itself with the ground far below and draws in the light shade — the planner accounts for that, and the preview shows it. Touch-up painting works on the final map colours (and shades, for staircase art) and re-plans the heights as you paint; Erase makes a pixel empty.
Safe build swaps a colour's default block for one that won't burn, won't be carried off by endermen and won't change colour by itself (dead coral, oxidising copper) whenever the colour has such a block — granite instead of dirt, slime instead of grass — and lists the colours that have no safe option. It also never leaves carpets, sand or pressure plates unsupported. The supports-only file contains just the support blocks and the noob line at the same size and origin as the full build, so you can lay that layer first and place the art on top with Litematica's easy place.
The material list counts every block, support block and the noob line, in total and per map, with shulker boxes and a rough build time. Exports: the whole build or a ZIP with one .nbt and .litematic per map (each with its own north row and the Y offset to place it at), map .dat files you can drop into your world's data folder to get the finished maps without building (laid out for 26.1+ and for older versions), a PNG of the final map colours and a CSV material list.
Under the hood
- Map pixel byte
- colour byte = baseColourId × 4 + shade (0 = ×180, 1 = ×220, 2 = ×255)
- Shade from height
- shade = 2 if h(z) > h(z−1) · 1 if equal · 0 if lower (z−1 = the block to the north)
- Classic staircase
- h(z) = h(z−1) + (shade − 1); then h −= min(h)
- Valley staircase
- split at every shade-0 pixel; segment base = max(0, nextBase + 1 − rise)
- Map centre (scale 0)
- xCenter = 128·⌊(x + 64) / 128⌋ · same for z — the map covers xCenter − 64 … xCenter + 63
- Build estimate
- hours ≈ blocks ÷ 2,000 (flat) or ÷ 1,100 (staircase)
- After a gap
- first block south of an empty pixel: shade 2 (compared with the ground below) · map.dat keeps the wanted shade
- Carpets
- wool = ⌈carpets ÷ 3⌉ × 2 (2 wool → 3 carpets)
FAQ
Flat or staircase map art — which should I build?
Flat is far easier: every block sits on one layer and you only have ~60 colours, which is perfect for logos, pixel art and survival builds (especially with carpets). Staircase uses block heights to unlock a darker and a lighter version of every colour, so photos and gradients look much better — choose valley mode for the same picture with much lower towers.
What is unobtainable mode?
Every map colour has four shades, but placed blocks can only produce three of them (lower, level or higher than the block to the north). The fourth, darkest shade (×135) only appears in map files — MapartCraft calls this 'Unobtainable'. Pick it when you'll copy the map_<n>.dat files into the world instead of building: you get the most accurate picture, but there is no schematic, command or material output, and Bedrock (which can't import map files) gets nothing.
What is the noob line?
The top row of a map is shaded by comparing each block with the block directly north of it, which lies just outside the map. Without a row of blocks there, the whole first row comes out the wrong shade. The generator includes this extra row (z = −1) in every build and in the material list — build it too, at the height shown in the schematic.
How do I use the map .dat files?
Close the world and open the ZIP folder for your version. 26.1 and newer keep maps in <world>/data/minecraft/maps/<n>.dat; 1.21.11 and older use <world>/data/map_<n>.dat — copy that folder's data folder into the world folder (this replaces maps with the same number, so set the first map number higher than any you've used), then reopen and run /give @p filled_map[map_id=<n>] (1.20.5+) or /give @p filled_map{map:<n>} on older versions. The maps are locked so they never redraw. Bedrock Edition doesn't support importing map files. For a transparent map art (a logo that floats on the item frame), use a PNG with a transparent background, set Transparent pixels to Empty and use these files — a built map can't be see-through.
Where do I build map art so it lines up with the map?
Maps are aligned to a 128-block grid: a map covers x from 128·k − 64 to 128·k + 63 (the same on z). Build the art inside one grid square per map and the noob line one block north of it. The tool lists each map's centre and corner coordinates for the grid position you choose; in-game, hold a map and look at the edges to find the square.
Is this a MapartCraft alternative for 1.21 and 26.x?
Yes — it does the same job (image → map colours → staircase schematic and map.dat) and adds what MapartCraft's issue tracker has been asking for: the 1.21.4 blocks (pale oak planks and wood, pale moss, resin blocks and bricks), current 1.20.5+ map.dat files, transparent maps, a supports-only file, hazard-safe block choices, carpet-only and survival presets, and touch-up painting. MapartCraft is a separate, independent project by rebane2001; we're not affiliated, and its classic features (staircasing, dithering, per-map NBT) work the same way here.
Does it work for Bedrock Edition?
Mostly. Bedrock uses the same base map colours, so flat map art works the same way and the commands export uses Bedrock syntax. Staircase shading works on Bedrock too but small rendering differences mean flat is the safer choice, and Bedrock can't load .litematic or map.dat files.
Related tools
map.dat Viewer & Map to PNG
Drop Minecraft map_<n>.dat files and see them as images — exact in-game colours, map details, PNG downloads and one stitched picture of a whole map wall.Pixel & Map ArtImage to Pixel Art Converter
Turn any picture into Minecraft block art: pick a palette, dithering and size, touch it up, then export a schematic, commands and a material list.Pixel & Map ArtWall Pattern & Gradient Block Mixer
Mix 2–8 Minecraft blocks into textured walls: dithered gradients, random mixes, noise, bricks and stripes, with exact block counts and schematic export.Pixel & Map ArtBlock Palette Generator & Color Matcher
Find the Minecraft blocks closest to any colour, build block gradients, pull a palette from an image or use 20+ curated themes, with survival filters.Pixel & Map Art