mc-api Map Art Converter
mc-api.bisai.dev
- Free plan
- Web
- API
What mc-api Map Art Converter is
mc-api Map Art Converter is a free web and API service that turns an image into a Minecraft map file or a block plan for in-game construction. It accepts PNG, JPEG and WebP images up to 8 MB. Map output preserves transparency and supports four shades across 244 colours. Block plans show block placement and include a materials list; flat plans reach 61 colours and staircase plans 183. Floyd–Steinberg dithering or no dithering can be selected. The API accepts raw image bytes and returns a .dat map file, PNG preview or JSON block plan. A conversion produces one map file, or a ZIP when the grid exceeds one map. To display the result in a world, downloaded map_<n>.dat files go in that world’s data folder. The service is free of charge, with one API credit per conversion. Its provider states there is no guaranteed availability, response time or data retention. The service uses HTTPS and short-lived Redis-cached IP addresses for quotas and abuse protection, and is not affiliated with Mojang or Microsoft.
Who it suits
It suits Minecraft builders who want image-based map art or block-by-block construction plans. Developers can use the API for file, preview or JSON outputs.
Good to know, and what to watch
- Accepts PNG, JPEG and WebP input
- Preserves transparency in map output
- Provides block plans and materials lists
- Offers API and web workflows
- Includes dithering choices
- Input images are limited to 8 MB
- API conversions consume one credit
- No availability or response-time guarantee
- Palette control is fixed
Plans
Every plan and priceFree service
Free plan
The verdict
The converter offers straightforward image-to-map and image-to-plan workflows, including an API. Users should account for the file-size limit, conversion credits and the provider’s lack of service guarantees.
What the maker publishes
- API formats
- The map art API accepts raw image bytes and can return a .dat map file, a PNG preview, or a JSON block plan. source
- API output limit
- A conversion returns one map file or a ZIP when the map grid is larger than one map. source
- Block plan output
- The block plan includes which block goes where and a material list; the page says flat plans reach 61 colours and staircase plans 183. source
- Dithering
- Offers Floyd–Steinberg dithering or no dithering. source
- Headquarters
- Appenweier, Germany source
- Hosting
- The maker says the application, database, and caches run on its own server infrastructure, with Cloudflare in front for delivery and attack absorption. source
- Image input
- Accepts PNG, JPEG, or WebP images up to 8 MB. source
- Integrations
- The page instructs users to put downloaded map_<n>.dat files in a world's data folder so the map item displays the picture. source
- Map output
- The map file option preserves transparency and supports all four shades across 244 colours. source
- Not affiliated
- The site states it is not affiliated with Mojang or Microsoft. source
- Provider
- The imprint identifies Leon Janz as the service provider and gives an address in Appenweier, Germany. source
- Purpose
- Converts an image into a Minecraft map file or a block plan for building it in-game. source
- Security and privacy
- The privacy policy says the site connection uses TLS/HTTPS and the service uses short-lived Redis-cached IP addresses for quotas and abuse protection. source
- Support and availability
- The terms say the service has no guaranteed availability, features, response times, or data retention; the imprint invites users to contact the provider about issues. source
Checked against the maker's pages on 4 Oct 2026.