Minecraft Map Art Generator

How do you use this map art generator?

1. Add your picture. Click Upload image, drop a file on the preview, or paste one with Ctrl+V. PNG, JPG, WebP and GIF work. The sample sunset is there so you can try every setting first.
2. Set the size in maps. One map is 128 by 128 blocks. A 2 by 2 wall is 256 by 256 blocks and gives four times the detail.
3. Crop it. Fill covers the maps and lets you zoom and drag the picture in the Original view. Fit keeps the whole picture and fills the rest with the background color. Stretch squashes it to fit.
4. Pick a mode and your version. Flat for a quick survival build, Staircase for better colors, Map file if you will load the maps into a world directly.
5. Tune it. Try the dithering methods and the adjustment sliders. Turn off colors you do not want to gather, or pick a preset.
6. Download. Get the map files, a schematic or structure file, the material list or a PNG.

What is Minecraft map art?

Map art is a picture made of blocks that you view through a map item. A map draws the top block of every column in its area as one colored pixel. Build a picture out of the right blocks, make a map of that spot, and the map shows the picture. Put the map in an item frame and you have a painting of any size you want on a wall.

A map at zoom level 0 (the level a fresh map starts at in Java) covers exactly 128 by 128 blocks, so one map is one 128 by 128 pixel picture. Bigger art is made of several maps side by side.

How do maps store colors?

A map does not store blocks. It stores 16,384 numbers, one per pixel, and each number is a map color. Every block in the game has a base color (sand, white wool and birch planks share some, for example), and each base color comes in four shades. The color number is the base color id times 4, plus the shade.

The shade is where height comes in. When a map draws a pixel, it compares the block with the block just north of it. Higher means a lighter shade, the same height means the normal shade, lower means a darker shade.

Java has 61 base colors since 1.17 (58 before, as deepslate, raw iron and glow lichen came with 1.17). Water is a special case: its shade depends on how deep the water is, not on height, so this generator only uses it in map files.

Flat, staircase or map file: which mode should you pick?

Staircase art can get tall. A long stretch of lighter pixels in one column means a long climb. The height limit setting stops a column from rising or falling more than the number of blocks you pick, and the converter picks the next best color where it has to. 32 blocks is a good middle ground. The status line under the preview shows the tallest column.

How do you build map art in survival?

1. Find the map area. Maps sit on a fixed grid. The edges of a zoom 0 map are at X and Z = 128 times n, minus 64: for example -64 to 63, or 64 to 191. Press F3 to see your coordinates, or hold a fresh map and walk to its edge.
2. Lay the noob line. This is one row of blocks just north of the map area. The top row of the picture is shaded against it, so without it the first row comes out wrong. The material list counts it as filler.
3. Build from north to south. Work row by row, so the block north of the one you place is always there. In staircase mode, follow the heights from the schematic or the hover info in the preview.
4. Support what falls. Sand, red sand, gravel and concrete powder fall, and carpets and pressure plates need a block under them. The files already include one filler block under each of them.
5. Make the map. Stand in the middle of the area with an empty map and use it. In the Overworld a map records terrain within 128 blocks of you, so the whole picture fills in.
6. Lock it. Put the map and a glass pane in a cartography table (Java 1.14 and newer). A locked map never changes again, so you can tear the build down. Use the cartography table with empty maps to make copies.
7. Frame it. Place the maps in item frames on a wall. Glow item frames (1.17 and newer) keep the art bright in the dark.

Leaves you place by hand never decay, but leaves pasted from a schematic do unless they are marked persistent. The files from this tool mark them, so a pasted build keeps its leaves. Dirt has another trap: grass can spread onto it and change the color, which is why the default for the dirt color is granite.

How do you load map files on a server?

Map files skip the building completely. Each map is a small file in the world folder, and the zip from this tool has them laid out already. The folder changed in 26.1:

1. Stop the server. A running server can overwrite the files you add.
2. Pick a starting number higher than every map already in the world. Look at the file names in the folder above: if the highest is map_57.dat, start at 58 or anywhere above. The default of 1000 is safe for most worlds. A file with the same number would replace an existing map.
3. Upload the files. A file manager in your hosting panel works, or SFTP. Copy the counter file from the zip too, as long as your world has no maps numbered above your new ones, so newly crafted maps never reuse these numbers.
4. Start the server and give the maps. From 1.20.5 on the command is /give @p minecraft:filled_map[minecraft:map_id=1000]. On 1.20.4 and older it is /give @p minecraft:filled_map{map:1000}. The readme in the zip lists the exact command for every map.

Take a backup before you change world files: how to back up a Minecraft server covers it. You need to be an operator to run give (see whitelist, ops and permissions), or run it from the console with a player name. If you want a place to try this, you can run a free Minecraft server on EternalZero and upload the files with its file manager.

How do you use the schematic with Litematica or WorldEdit?

Every build file starts one block north of the art, at the noob line. Place it with its north-west corner at the west edge of the map area and one block north of the north edge, and the art lines up with the map grid.

Litematica

Litematica is a client mod for Fabric that shows a see-through copy of the build to follow block by block. Copy the .litematic file to .minecraft/schematics, press M, choose Load Schematics, and move the placement to the corner. Its Schematic Verifier lists every wrong or missing block. This generator writes schematic version 7 for 1.20.5 and newer, and version 5 for older versions. For mods in general, see how to install mods and modpacks.

WorldEdit

WorldEdit 7.3 (March 2024) and newer read Sponge schematic v3. Older builds need v2, which the format list also offers. Put the .schem file in plugins/WorldEdit/schematics on Paper or Spigot, stand at the corner, then run //schem load name and //paste -a (the -a flag skips air). Setting up the plugin is covered in how to install plugins.

Vanilla structure files

No mods at all: copy the .nbt file into the world's generated structures folder (generated/minecraft/structures, renamed to generated/minecraft/structure in 26.1) and run /place template minecraft:name x y z, which exists since 1.19. A structure block can only load 48 by 48 by 48 blocks, so a full 128 by 128 map needs /place template, or the Split into 48 block pieces option, which names each piece with its offset from the corner.

Which pictures make good map art?

Bold shapes, clear outlines and strong colors work best. A single map is only 128 pixels across, about the size of a small icon, so faces and text need room: give a portrait at least 2 by 2 maps. Pixel art, logos, game characters and landscapes with big areas of color turn out great.

Dark, muddy photos lose detail, because the darkest map colors are close to each other. Raise the brightness and contrast a little before you convert. Pastel and gray tones are well covered by terracotta and the stone colors, while very saturated greens and blues have fewer matches. Use the Original view to compare.

What does dithering do?

Dithering mixes nearby colors in a pattern so your eye blends them into a color the palette does not have. Without it, a sky gradient becomes a few flat bands. With it, the bands melt into a smooth fade.

• Floyd-Steinberg spreads the color error to four neighbors. A good default for photos.
• Burkes spreads the error wider, to seven neighbors, for softer fades. Sierra Lite uses only three, which keeps fine detail a bit crisper.
• Atkinson spreads only part of the error, so highlights and shadows stay clean. Good for high contrast pictures.
• Bayer 4x4 and 8x8 use a fixed, regular pattern. It looks retro and is easier to build by eye.
• None gives flat areas with clean edges, the best choice for pixel art and logos.

Dithering adds more block changes, which means more work in survival. Lower the strength slider if a build gets too noisy.

Which blocks should you use?

The defaults are cheap, easy to get and do not fall. Carpets are the cheapest per pixel (two wool gives three carpets) but every carpet needs a block under it. Concrete and wool give the 16 dye colors in one consistent look. Terracotta covers the soft browns, pinks and grays. Some colors only come from hard blocks: Silk Touch for grass blocks, mushroom stems and nylium, or a lot of gold, diamonds or emeralds. The Easy survival preset turns those off.

How do you line up a large map wall?

Each map covers its own 128 by 128 area, and the areas of a large piece sit next to each other on the map grid. Build them in one go from north to south: in staircase mode the first row of each lower map is shaded against the last row of the map above it, so the files keep one shared base height. The map files are numbered row by row from the top left, and the readme names the row and column of each number. In the frames, row 1 goes at the top and column 1 on the left as you face the wall. Big walls of item frames add entities; if a busy server starts to lag, see how to fix server lag.

Does map art work on Bedrock?

The idea is the same, but the files are not. Bedrock keeps maps inside the world's LevelDB database instead of separate .dat files, stores the pixels as full RGBA colors, and tints some blocks (grass, foliage and water) by biome on maps. The map files and schematics here are for Java only. You can still use the preview and the block list as a guide for a hand-built Bedrock version, but expect a few colors to differ. Not sure which edition fits your group? Read Bedrock or Java.

How does this generator compare with other map art tools?

Most map art tools fall into two groups: simple converters that make one map file or a block list, and builder tools that make a schematic. This one does both, and keeps the version details right.

While you build, the other free tools may help: plan your base with the seed map, or design a banner to hang next to your map wall.