mcmap
github.com
- Free plan
- Windows
- macOS
- Linux
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
Plans
Every plan and priceFree
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.