
Minecraft Pixel Art Generator
Turn a bold image into a Minecraft block grid, review suggested block counts, and export a chart, Java Edition function, Sponge Schematic v2, or Litematica v7.1 file. The schematic exports create a one-block-deep vertical pattern; map-color matches are approximate.
Your pattern
Choose a tool, then click or drag across the grid. Undo and redo: Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z.
Block colors and counts
Counts reflect filled map-color cells. Block matches are suggestions; check them in your game version.
Replaces every grid cell using that color with the selected brush color.
Sponge Schematic v2 targets Java 1.20.1 (data version 3465); Litematica v7.1 targets Java 1.21.1 (data version 3955). Both exports are one-block-deep vertical patterns: X runs left to right, Y runs bottom to top, and empty cells become air.
Choose a Minecraft build to try
Try simple, original 2D build art with clear silhouettes, then inspect the suggested block colors and counts.


Blocky oak tree

Red pixel rocket

Pixel heart wall emblem

Amethyst geode

Pig in a green pasture

Campfire in a forest clearing

Oak tree in early autumn

Gray donkey in a paddock

Blue heron at the marsh

Wooden fishing boat

Green tree frog on a leaf
These starter designs are illustrative, not customer work. Choose one to load it in the editor, then adjust the grid and colors for your project.
Features
Explore what this workspace can do, how each control affects the result, and which export fits your next step.
Convert a reference image into a block grid
Choose a PNG, JPG, or WebP image and set how many cells span the design. Each cell is assigned a suggested Minecraft block based on an approximate map-color reference.
Review a named block key and cell counts
The key groups cells by suggested block name and shows how many positions use each one. Counts describe the generated grid, not a verified inventory or a survival-mode shopping list.
Download a function or schematic
Download a Java Edition 1.13+ .mcfunction, Sponge Schematic v2 for Java 1.20.1, or Litematica v7.1 for Java 1.21.1. The schematic files contain a one-block-deep vertical pattern and export empty cells as air.
Adjust detail and color complexity
Change grid width and the maximum number of colors to simplify the design or preserve more parts of the source. A smaller grid is often easier to build, while a larger one gives small features more positions.
Edit cells and export a reference
Use the editable grid to correct a block choice or shape. Download a PNG for a quick visual reference or a PDF with a grid and key for following the layout while building.
Process the selected image in your browser
The source image is processed locally in the page. The tool does not upload it to a converter service or save an account project for later sessions.
How to make Minecraft pixel art from an image
Treat the result as a block-by-block planning reference: simplify the source, choose a practical grid, check the suggested palette, then verify materials in your game.
Choose a block-friendly image
Load a PNG, JPG, or WebP image or select one of the examples. A bold subject with a simple background is easier to translate into blocks than a detailed scene with many similar colors.
Choose the grid dimensions and color count
Set the width based on how much detail and build effort you want. Reduce the color limit to keep the material list shorter, then check that the most important shapes still stand out.
Inspect and correct the block suggestions
Read the approximate map-color matches as material suggestions, not exact texture matches. Edit a few cells if needed and check how the named counts change as the design is refined.
Save a reference and verify materials
Download a PNG or printable PDF, or export a Sponge v2 or Litematica v7.1 schematic for the documented Java version. Preview the actual blocks in your Minecraft edition, resource pack, and lighting before building a large design.
What the Minecraft pixel art generator creates
The generator turns an image into a two-dimensional grid where each cell is paired with a suggested Minecraft block. It also groups the cells into a named key, provides counts, and lets you copy the layout as rows of block IDs. These outputs make a visual reference for planning a flat build.
The optional Java Edition 1.13+ function is a text file of setblock commands. It places filled cells as one flat layer relative to where it runs, skips empty positions, and replaces existing blocks at filled positions. Separate exports create Sponge Schematic v2 files for Java 1.20.1 and Litematica v7.1 files for Java 1.21.1; both describe a one-block-deep vertical pattern and turn empty cells into air.
Choose a source image that maps to clear shapes
High contrast, a dominant subject, and a plain background usually produce a grid that is easier to build. A close crop puts more cells on the subject, while a distant scene may spend many cells representing sky, ground, or background. Simple illustrations can be easier to translate than photographs with subtle textures.
The source aspect ratio is preserved in the grid. A wide landscape becomes a wide design, and a portrait stays tall. Before choosing a width, decide how much wall or map area is available and check the resulting height so the layout fits the intended surface.
Treat map-color matches as suggestions
The palette uses approximate Minecraft map colors paired with representative blocks. A map color is a flat display reference, not a promise that the block texture will match the preview in the game. Texture, lighting, biome, shaders, resource packs, and game edition can all change how a build looks.
Use the suggested names to narrow down candidate materials, then test them in the actual world before gathering a large quantity. If a particular block is unavailable in your edition or build mode, choose a nearby substitute and revise the affected cells in the chart.
Balance build size with the number of block types
Grid width sets the number of cells across the image. A smaller grid means a smaller build and broader shapes; a larger grid can preserve details but increases the number of positions you must place. The maximum color count affects how many distinct block suggestions appear in the key.
A short material list can make a design easier to gather and organize, but too few colors may merge important boundaries. Preview the reduced version at normal viewing distance. If the subject is no longer recognizable, increase the grid or allow a few more colors rather than adding detail everywhere.
Read the block key and count the grid positions
Each row in the key names a suggested block and shows the number of cells assigned to it. Those counts are grid positions. They do not include extra blocks for mistakes, scaffolding, borders, structural support, or replacements if a material is unavailable.
Use the key as a planning estimate and add your own allowance for the build. Check whether the design contains empty cells and review its outline before copying the array. If you edit the grid, recheck the key and copy the updated data so the text matches the current preview.
Use the copied array as row data
The block array records the suggested layout row by row with namespaced block identifiers. It gives you a compact way to inspect or reuse the sequence, and empty positions are represented with minecraft:air. Keep the orientation consistent when you interpret the first row and first column.
The .mcfunction export writes only filled cells with setblock commands; empty positions remain unchanged when it runs. Sponge .schem v2 and Litematica v7.1 exports instead contain the full rectangular pattern and use air for empty positions. These files are build layouts, not undo records.
Export a chart that is easy to follow while building
A PNG works well as a quick image reference. A PDF provides a printable grid and a color key, which can help when you need to mark completed rows or check counts away from the editor. For a large design, make sure the printed pages preserve row and column alignment.
Keep the actual block key visible as you build and compare the preview with blocks placed in your world. The chart is a guide to color regions, not a simulation of depth or texture. Small shading differences that look useful on screen may disappear from a distance once the build is complete.
Minecraft pixel art generator questions
What does the Java function file do?
It contains Java Edition 1.13+ setblock commands for a flat layer. Coordinates are relative to the function execution position, empty cells are skipped, and filled positions replace existing blocks. The function itself is not a .schem file; review its commands before running them in the target world.
What do the schematic exports include?
Sponge Schematic v2 targets Java 1.20.1 (data version 3465), and Litematica v7.1 targets Java 1.21.1 (data version 3955). Both files contain the full one-block-deep vertical pattern, with X running left to right, Y running bottom to top, and empty cells represented as air.
Are the suggested block colors exact in-game textures?
No. The matches use approximate map colors paired with representative blocks. Texture, lighting, shaders, resource packs, and game edition can change the appearance, so test candidate blocks in your world before building.
What does the block count tell me?
It counts grid cells assigned to each suggested block. It does not include extra materials for construction, support, errors, or unavailable blocks, so use it as a planning estimate and check your actual build requirements.
How do I make the design easier to build?
Use a smaller grid width and a lower color limit to reduce positions and block types. Check that the main subject remains recognizable, then add detail only where it improves the design.
Can I copy the layout into another program?
Yes. The block-array field provides row-by-row text with namespaced block IDs. The receiving program may expect a different order or format, so verify its requirements before importing or transforming the text.
What does minecraft:air mean in the array?
It marks an empty grid position in the copied row data. It does not represent a suggested solid block, and the text array itself does not place or remove anything in a Minecraft world.
Can I print the block grid?
Yes. Download a PDF with a grid and color key, or use a PNG for a quick reference. Check that the printed grid is readable and that rows stay aligned if a large design spans multiple pages.
Can I edit the suggested block choices?
Yes. The grid is editable, so you can correct cells and then review the updated key and counts. Use edits for substitutions that fit your edition or materials, and copy the array again after changing the design.
Which images can I use?
The tool accepts PNG, JPG, and WebP images. A simple, high-contrast subject generally maps more clearly than a busy scene with many subtle colors.
Is my source image uploaded?
No. The image is processed in your browser and is not uploaded to the converter. The current page does not store a project for later, so download the chart or copy its array before leaving.