Skip to content
SPECIFICTION
Get listed

BlocksItems Map Art Generator

blocksitems.com

Free plan WebAPI

What it is

BlocksItems Map Art Generator converts an uploaded image into a Minecraft map art layout by matching each pixel to a block. Images can be dragged in, pasted from the clipboard or selected as a file. The blog describes map sizes from 1×1 to 4×4 and zoom levels from 0 to 4; at zoom 0, one map is 128×128 blocks. Users can choose vanilla blocks or include blocks from 500+ supported mods and modpacks. Matching uses perceptual OKLAB color distance, with optional Floyd-Steinberg dithering for smoother photographic gradients. Generated layouts come with a live preview, material list and shareable link. The list shows each block’s icon, color swatch, full block ID, total count and stack count. Exports include .schem for WorldEdit, .litematic for Litematica, and .nbt for vanilla structures, Create and data packs. API documentation covers generation and export endpoints. The web tool is free to use without an account, with custom palette control. The site says it is not an official Minecraft service and is not approved by or associated with Mojang or Microsoft.

Spec sheet

What it does
The tool converts an uploaded image into a Minecraft map-art layout by matching pixels to block map colors.Read 15 Oct 2026 · blocksitems.com
Purpose
Converts an uploaded image into a Minecraft map art layout by matching each pixel to a block.Read 4 Oct 2026 · blocksitems.com
API
The API documentation includes map-art generation and export endpoints, including schematic, Litematica, and structure NBT exports.Read 4 Oct 2026 · blocksitems.com
Support
The privacy page provides an email contact for questions, API-key requests, and support matters.Read 15 Oct 2026 · blocksitems.com
Analytics
The site uses essential cookies and Google Analytics cookies, with a cookie-banner opt-out.Read 15 Oct 2026 · blocksitems.com
API authentication
Basic API usage requires no key; optional API keys provide higher limits.Read 15 Oct 2026 · blocksitems.com
API availability
BlocksItems publishes a REST API with OpenAPI documentation and a /api/v1 base path.Read 15 Oct 2026 · blocksitems.com
API exports
API endpoints provide schematic, Litematica, and structure-NBT downloads for saved map art.Read 15 Oct 2026 · blocksitems.com
API map-art limits
The map-art API requires maps_wide and maps_tall values from 1 to 4 and zoom_level values from 0 to 4.Read 15 Oct 2026 · blocksitems.com
API rate limit
The documented free API tier allows 6,000 requests per minute without a key.Read 15 Oct 2026 · blocksitems.com
API SDKs
The documentation includes cURL, JavaScript, and Python request examples but does not identify an official SDK package.Read 15 Oct 2026 · blocksitems.com
Block capacity
At zoom level 0, one map is 128×128 blocks, or 16,384 blocks.Read 15 Oct 2026 · blocksitems.com
Block sources
Users can select vanilla blocks or include blocks from supported mods and modpacks.Read 15 Oct 2026 · blocksitems.com
Color matching
Pixel matching uses perceptual OKLAB color distance.Read 15 Oct 2026 · blocksitems.com
Data security
The privacy policy says BlocksItems uses technical and organizational measures to protect information and notes that internet transmission is not 100% secure.Read 4 Oct 2026 · blocksitems.com
Dithering
Floyd-Steinberg dithering is available for smoothing image gradients.Read 15 Oct 2026 · blocksitems.com
Exports
The generator offers .schem for WorldEdit, .litematic for Litematica, and .nbt for vanilla structures, Create, and data packs.Read 4 Oct 2026 · blocksitems.com
Image input
Images can be added by drag and drop, clipboard paste, or file browsing.Read 15 Oct 2026 · blocksitems.com
Independent alternative
The open-source Arachne project describes itself as a browser-based Minecraft map-art generator that outputs palette-optimized schematics.Read 15 Oct 2026 · github.com
Independent alternative licence
Arachne's repository is licensed GPL-3.0-only.Read 15 Oct 2026 · github.com
Independent alternative privacy
Arachne says its image processing stays in the browser and that it has no backend analytics or tracking.Read 15 Oct 2026 · github.com
Independent alternative scope
Arachne documents support for grids from one map up to 16×16 maps, exceeding BlocksItems' documented 4×4 range.Read 15 Oct 2026 · github.com
Independent map-art constraint
A Reddit commenter notes that block height changes the color displayed on a Minecraft map, so builders need to account for elevation.Read 15 Oct 2026 · reddit.com
Independent workflow context
A Reddit commenter recommends generating a schematic, testing it in a creative world with Litematica, and then using Litematica's material list for survival construction.Read 15 Oct 2026 · reddit.com
Launch news
BlocksItems announced the Map Art Generator on February 23, 2025.Read 15 Oct 2026 · blocksitems.com
Licence
The terms say the website design, API structure, and original documentation are BlocksItems property; no open-source licence is stated.Read 15 Oct 2026 · blocksitems.com
Litematica export
The generator exports .litematic files for Litematica.Read 15 Oct 2026 · blocksitems.com
Log retention
API usage logs are typically retained for 90 days.Read 15 Oct 2026 · blocksitems.com
Map dimensions
The generator accepts 1×1 through 4×4 maps, with zoom levels 0 through 4.Read 15 Oct 2026 · blocksitems.com
Map-art API
The API exposes POST /api/v1/mapart/generate, which accepts base64 PNG data and returns a palette, block grid, and material list.Read 15 Oct 2026 · blocksitems.com
Material details
The material list includes each block’s icon, color swatch, full block ID, total count, and stack count.Read 4 Oct 2026 · blocksitems.com
Materials list
The materials view lists each block's icon, color, block ID, quantity, and stack count.Read 15 Oct 2026 · blocksitems.com
Not an official Minecraft service
The site says it is not an official Minecraft service and is not approved by or associated with Mojang or Microsoft.Read 4 Oct 2026 · blocksitems.com
Official-status disclaimer
BlocksItems states that it is not an official Minecraft service and is not approved by or associated with Mojang or Microsoft.Read 15 Oct 2026 · blocksitems.com
Preview
Generated layouts provide a live preview with zoom, fit, and map-boundary controls.Read 15 Oct 2026 · blocksitems.com
Preview and materials
After generation, the tool provides a live preview, a material list, and a shareable link.Read 4 Oct 2026 · blocksitems.com
Privacy logging
The privacy policy says IP, browser, operating-system, referring-URL, page, access-time, endpoint, frequency, and response-time data may be collected.Read 15 Oct 2026 · blocksitems.com
Security and privacy
The privacy policy says the site collects IP addresses and API usage data, uses essential and Google Analytics cookies, and typically retains API usage logs for 90 days.Read 4 Oct 2026 · blocksitems.com
Security statement
BlocksItems says it uses technical and organizational safeguards but warns that internet transmission cannot be guaranteed secure.Read 15 Oct 2026 · blocksitems.com
Share links
Generated map art can be revisited through a share URL.Read 15 Oct 2026 · blocksitems.com
Structure export
The generator exports vanilla structure .nbt files compatible with structure blocks, Create, and data packs.Read 15 Oct 2026 · blocksitems.com
WorldEdit export
The generator exports Sponge Schematic .schem files for WorldEdit.Read 15 Oct 2026 · blocksitems.com

Plans and prices

Free Free Completely free to use · no account required Read 4 Oct 2026 · blocksitems.com
Free Free No account required · map-art generation · previews · materials · exports Read 15 Oct 2026 · blocksitems.com

Every BlocksItems Map Art Generator plan and price →

Strong points and limits

Strong points

  • Accepts drag-and-drop, clipboard and file input
  • Supports maps up to 4×4
  • Includes 500+ supported mods and modpacks
  • Provides material details and shareable previews
  • Exports .schem, .litematic and .nbt

Limits

  • Collects IP addresses and API usage data
  • Uses essential and Google Analytics cookies
  • API usage logs are typically retained for 90 days

Who it suits

It suits Minecraft builders who want to turn images into block layouts and need material counts or structure exports. Its mod support and API endpoints may also suit users working with modded blocks or automated workflows.

Verdict

The tool combines image-to-block matching with material details and several export formats, at no cost and without an account. Note its stated data collection and that it is not an official Minecraft service.

Where Specifiction places it

Alternatives to BlocksItems Map Art GeneratorAll alternatives →