Skip to content
ShapeCraft

Minecraft Pixel Art Generator

Java & Bedrock

Drop in any image and get a buildable Minecraft pixel art in seconds. Choose how wide it should be, which blocks you have (wool, concrete, terracotta, building blocks or every full block), how it's dithered and whether it's a wall or a floor — then fix single blocks by hand and export a Litematica, WorldEdit or structure file, a merged /fill command list and an exact material list. Your image never leaves your browser.

Image

Sample landscape
loading… · never uploaded

Size & placement

auto · 64

%

Zoom in to crop the picture (the output keeps the same number of blocks).

Blocks

Customise blocks · 49 in use

Tick the blocks you want. Changes are kept in the share link.

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.

%
Size
64×64
wall
Blocks
0
0 shulkers · ≈ 0 h
Block types
0
of 49
Colour error
—
avg ΔE (lower = closer)

Preview

Original
Blocks
Touch-up
White ConcreteClick or drag on the block art to repaint cells.

Materials

0
blocks
0
stacks
0
shulkers

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).

Show merged /fill commands

How it works

Your picture is decoded and resized entirely in your browser. The converter averages every block-sized area of the image (area-average downscaling, not nearest neighbour), so small details blend into the right colour instead of flickering. Brightness, contrast and saturation are applied before matching, and transparent pixels either stay empty or are blended over a background colour you choose.

Each pixel is then matched to the closest block in perceptual OKLab colour space, using the average texture colour of every block in the palette. OKLab matching avoids the classic RGB mistakes (blues turning purple, dark greens turning grey). Dithering spreads the leftover colour error to neighbouring blocks — error-diffusion kernels like Floyd–Steinberg, Atkinson, Jarvis–Judice–Ninke (what MapartCraft calls MinAvgErr), Stucki, Burkes and the Sierra family for photos, or ordered patterns (Bayer 2×2, 4×4 and 8×8, plus the classic 3×3) for a regular texture that's easier to build — and the strength slider lets you dial it from subtle to full.

All of this runs in a background Web Worker, so dragging sliders stays smooth even at 512 blocks wide. Once the result looks right, switch to paint mode: choose any block (or the eraser) and click or drag over cells to repaint them, use the eyedropper to grab a block from the art, and undo mistakes. Your touch-ups are kept as long as the size stays the same.

The material list counts every block with stacks and shulker boxes. Exports place the art as a vertical wall facing south (the top row of the image is the top of the wall, left is west) or as a floor with the top of the image to the north. Litematica, WorldEdit .schem and vanilla structure .nbt files load directly; the .mcfunction merges runs of identical blocks into /fill commands so even big murals need only a few hundred commands.

Under the hood

Colour match
block = argmin ΔE_OKLab(pixel, avgTextureColour(block))
Floyd–Steinberg
error × strength → right 7/16, down-left 3/16, down 5/16, down-right 1/16 (serpentine)
Auto height
height = round(width × imageHeight ÷ imageWidth)
Wall orientation
image (x, row) → block (x, height − 1 − row, 0) · faces south (+z)
Shulker boxes
boxes = blocks ÷ 1,728 (27 slots × 64)

FAQ

What size should my Minecraft pixel art be?

For a survival build, 32–64 blocks wide is a few hours of work and still recognisable. Portraits and detailed scenes look good from 96–128 wide. Anything over 256 wide is a big creative project — and walls taller than about 380 blocks don't fit between the world's build limits, so build very tall images as a floor instead.

Which blocks are best for pixel art?

Concrete is the most saturated and has no texture noise, so it reads best up close. Wool is cheap in survival thanks to sheep farms but burns. Terracotta adds muted browns, pinks and greys that are great for skin and landscapes. The Wool + Concrete + Terracotta preset combines them for the most colours and the most accurate result.

Should I turn dithering on?

Use dithering for photos, skies, gradients and faces — it creates the illusion of in-between colours. Turn it off for logos, sprites, cartoons and text, where flat colour areas are cleaner and easier to build. Ordered dithering (Bayer 2×2 / 4×4 / 8×8 or the 3×3 matrix) is a good middle ground: a regular, predictable pattern. Jarvis–Judice–Ninke is the same algorithm MapartCraft lists as MinAvgErr.

Can I crop or zoom into the picture?

Yes. Zoom (100–400 %) crops into the source and the X/Y offsets pan around it, with or without a fixed height; with a fixed height you can also choose fill, fit or stretch. The zoom and offsets are part of the share link, and the Map grid toggle draws 128-block map boundaries so you can see how a wall splits across item-frame maps or chunks of a big build.

How do I build it with Litematica or WorldEdit?

Download the .litematic, put it in your schematics folder and load it with Litematica to get a ghost overlay and a material list in-game. For WorldEdit, put the .schem in plugins/WorldEdit/schematics (or config/worldedit/schematics) and run //schem load name then //paste. Without mods, use the .nbt with a structure block or run the .mcfunction in a datapack.

Is my image uploaded anywhere?

No. The image is decoded, resized and converted in your browser. Only the settings (width, palette, dithering…) go into the share link, so the person you send it to uses their own image or the sample.

All tools →