Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

mcmap

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.3 Club score Visit github.com

What mcmap is

mcmap is free, open-source software that turns Minecraft save files into isometric pixel-art maps. It reads saves from the standard folders on Linux, macOS and Windows, then creates a PNG by default. Users can split maps into square tiles, select a dimension, set a circular or coordinate-bounded area, and adjust direction, shading and lighting. Water and beacon rendering can be toggled, while a JSON color file allows custom block colors and rendering types. The renderer uses all computer threads to process terrain in batches. Rendering a whole map at once may need 10+ GB of RAM, and a fragment-size option lets users manage batch sizes. The program is used from a terminal or PowerShell; an experimental GUI is available for Windows. The v3.0.0 release specifies Minecraft 1.13+ support. It is distributed under GPL-3.0, with precompiled binaries and source code. The project notes that merged batches can leave visible lines in oceans and suggests adjusting fragment size or water settings.

Who it suits

It suits Minecraft players who want image maps from their save files and are comfortable using a terminal or PowerShell. Windows users can also try its experimental GUI.

Good to know, and what to watch

  • Creates PNG maps and optional square image tiles
  • Offers dimension, area, lighting and shading controls
  • Custom block colors can be set in a JSON file
  • Runs on Linux, macOS and Windows
  • GPL-3.0 software with binaries and source available
  • Whole-map rendering may require 10+ GB of RAM
  • The GUI is experimental and Windows-only
  • Merged batches can leave visible lines in oceans

Free

Free

Open source

The verdict

mcmap provides configurable isometric map rendering for Minecraft saves across desktop operating systems. Users should account for substantial memory needs on large maps and the documented ocean-line issue when rendering batches.

What the maker publishes

Build requirements
The project uses CMake and depends on zlib, PNG, fmt, and spdlog libraries. source
Compatibility
The project README says it is compatible with newer Minecraft versions, and the v3.0.0 release specifies Minecraft 1.13+ support. source
Custom colors
Users can customize block colors and rendering types with a JSON color file. source
Input
It reads Minecraft save files from the standard saves folders on Linux, macOS, and Windows. source
Known rendering issue
The README notes that merging render batches can create visible lines in oceans and suggests changing fragment size or water rendering settings. source
Large maps
The README says rendering a whole map at once may require 10+ GB of RAM and provides a fragment-size option to manage rendering batches. source
License
The repository is distributed under the GPL-3.0 license. source
Maker
The GitHub profile identifies the account as Jean-Baptiste Skutnik and lists Paris, France. source
Output
The default output is a PNG image, and an option can split the map into square image tiles. source
Platform use
The README says the program is used through a terminal or PowerShell on Linux, macOS, or Windows, with an experimental GUI available for Windows. source
Purpose
mcmap creates isometric renders of Minecraft save files as pixel-art maps. source
Rendering options
Options include circular or coordinate-bounded renders, dimension selection, shading, lighting, water and beacon toggles, and map direction. source
Support channel
The latest release notes invite users to use repository discussions to request changes and report bugs or incompatibilities. source
Threading
The renderer uses all computer threads to render terrain in batches. source

Checked against the maker's pages on 8 Oct 2026.