Minecraft Pixel Art Generator
Java & BedrockDrop 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
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.
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).
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.
Related tools
Image to Map Art Generator
Minecraft map art generator: convert any image to flat or staircase map art, with survival presets, touch-up painting, schematics and map.dat export.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 ArtCircle, Ellipse & Star Generator
Minecraft circle generator: pixel-perfect circles, ellipses, stars and arcs up to 512 blocks, with a row-by-row build guide, block counts and schematics.Shapes