YOUR IMAGE, ONE BLOCK AT A TIME

Minecraft Pixel Art Generator

Turn a picture into a flat block mosaic. One output pixel equals one block, with a row guide and material shopping list.

Choose your image

PNG, JPEG, WebP · max 10 MiB / 16 megapixels. Stays on your device.

No image loaded. Your image is not uploaded or saved.

Longest side in blocks. The other side keeps the image proportions, rounded to whole blocks.
Flat swatches, not game textures. Uses hardened concrete.

Loading tool… If it stays here, reload the page.

Your block building plan

Choose an image and generate a new plan.

Worked example: 12 blocks, four transparent gaps

Original 4 × 4 source uses exact concrete swatches and transparent corners (shown gray here). At maximum side 4 with Concrete selected, the output is four Red Concrete, four White Concrete, four Blue Concrete, and four empty cells. The material list totals 12 blocks. No scaling or approximate color matching is needed for this deliberately simple example.

Inspect the rows, download the PNG or materials CSV, then replace Red Concrete to see the same four positions change. This verifies conversion and counting; it is not an in-game appearance test. For photographs, the limited palette and resampling change the result.

How to turn an image into Minecraft pixel art

  1. Choose a clear image with a simple subject. Upload it or try the built-in sample; no account or image upload service is involved.
  2. Set the maximum side. A 2:1 landscape at 64 blocks becomes 64 columns by 32 rows, requiring at most 2,048 blocks. A portrait uses 64 rows and a proportionally smaller width.
  3. Choose concrete, wool, or both. Generate, then inspect the preview and text row plan before gathering materials. The material table names the actual block to place.
  4. Download the full TXT plan and CSV material list. Pick one fixed bottom-left build origin and place rows from the bottom upward. In the guide, X counts left to right and rows count from the top.

Keep the same origin for every row

For a 32-row wall, row 32 is the bottom and row 1 is 31 blocks above it. On a wall facing the viewer with screen-right aligned to increasing world X, a guide cell at X 5, row 10 is 5 blocks along and 22 blocks above your bottom-left origin. For floor mosaics, use the row direction along your chosen horizontal axis instead. Choose the build orientation yourself; these are relative guide coordinates, not game commands.

How colors and transparency are converted

The browser resizes the source to whole block dimensions using image smoothing. Each remaining pixel is matched to the nearest available flat block swatch using a weighted RGB color distance. There is no dithering. Pixels with alpha below 50% become empty cells; remaining semi-transparent pixels are blended against white before matching. After resizing, soft edges may therefore change the outline slightly.

There are 16 concrete colors and 16 wool colors. Swatches are approximate representative colors, not official textures, exact color measurements, or Minecraft map colors. Lighting, shaders, resource packs, and viewing distance change the in-game appearance. Check a small section in your world before committing to a large build. Larger plans retain more detail but need more materials.

Use the blocks you already have

After generating, use the material table to replace every occurrence of one block with another from the same palette. For example, replace all Blue Concrete with Cyan Concrete. This is a manual color choice, not a new nearest-color match. It preserves empty cells and the number of placed blocks. Changing the palette or size invalidates the plan; generate again to apply those settings.

Example: materials include gaps correctly

A 4 × 4 plan has 16 cells. If 4 cells are transparent gaps, its material list totals 12 placed blocks. A material count of 130 means 2 full stacks of 64 plus 2 extra. Gaps do not require an “air block,” and supports are not counted.

Java, Bedrock, and supported output

This is a manual flat mosaic plan for Minecraft versions containing the selected concrete and wool blocks. It is suitable for wall or floor art in Java or Bedrock. It does not generate map art, height shading, schematics, world files, commands, or automatic builds. CSV block identifiers use familiar minecraft:color_material names for reference, not edition-specific command syntax.

Your image stays on your device

Images are decoded and converted in this browser tab. They are not uploaded or stored by this site. Reloading or clearing the image removes the active plan; download results before leaving. Only local calculations run, without tracking or external image APIs.

Why an image might not work

Use PNG, JPEG, or WebP under 10 MiB and 16 megapixels. SVG and GIF are not supported. Output is always a single still image; animation and frame selection are not included. Reduce very large images first. If the browser cannot decode the file, export a new PNG or JPEG. Fully transparent images produce zero blocks; choose an image with visible pixels. A photograph with subtle shades can look coarse with a limited palette; try a simpler subject or increase the block size setting.

This independent fan tool is not affiliated with or endorsed by Mojang or Microsoft.