Skip to content
This repository

High Performance Minecraft Map Renderer.


by Moritz Hilscher

Mapcrafter is a high performance Minecraft map renderer written in C++. It renders Minecraft worlds to a bunch of images which are viewable in any webbrowser using Leaflet.js.

Mapcrafter is free software and available under the GPL license. You can access the latest source code of Mapcrafter on GitHub:

Thanks to pigmap and Minecraft Overviewer, whose documentations and source code were very helpful. I also used the alpha blending code of pigmap and some maps stuff of the template from Minecraft Overviewer.


  • Web output: Render your Minecraft worlds to maps with an isometric 3D perspective viewable in any webbrowser!
  • Different directions: Choose from four different directions to render your worlds!
  • Different rendermodes: Choose between different rendermodes like day, night and cave for your maps!
  • Configuration files: Control which worlds are rendered from which direction and with which rendermodes!
  • Markers: Automatically generated markers from your Minecraft world data!
  • Other stuff: Biome colors, incremental rendering, multithreading


  • A Linux-based or Unix-like operating system like Mac OS
  • A decent C++ compiler (preferable gcc >= 4.4, or clang), CMake and make if you want to build Mapcrafter from source
  • Some libraries:
    • libpng
    • libjpeg (but you should use libjpeg-turbo as drop in replacement)
    • libboost-iostreams
    • libboost-system
    • libboost-filesystem (>= 1.42)
    • libboost-program-options
    • (libboost-test if you want to use the tests)
  • For your Minecraft worlds:
    • Anvil world format
    • Minecraft 1.6 resource packs


There are a few example maps of the renderer on the GitHub Wiki. Please feel free to add your own map to this list.

Documentation and Help

The documentation is in the docs/ directory and you can build it yourself with Sphinx. You can read a built version of the documentation here and you can also download other builds.

If you find bugs or problems when using Mapcrafter or if you have ideas for new features, then please feel free to add an issue to the GitHub issue tracker.

You can contact me in IRC (#mapcrafter on Freenode). Use the webclient if you are new to IRC. I will be there most of the time, but please bear in mind that I can't be available all the time. If I'm not there, wait some time or try another time of the day.

You can also ask questions in the Minecraft Forum thread.

Version history


  • Added option to use JPEGs as image output format
  • Added option to change the background color of the map


  • Added option to hide specific marker groups in the web interface by default
  • Added a way to add more user-defined markers using the Leaflet API (#71)
  • Changed markers.js file attribute icon_size to iconSize
    • You should update your markers.js file and re-run mapcrafter_markers if you use markers.
  • Fixed a bug causing Mapcrafter not to use the data/ directory as resource directory (#70)


  • Added simple progress output to marker generation program (optional)
  • Added option to hide empty signs by default
  • Fixed a bug (#65) causing invalid Javascript being generated
  • Markers use the world section name to distinguish between the worlds, not the world_name attribute


  • Added ability to automatically generate markers from signs in the Minecraft world
    • The format to specify markers has changed, please have a look at the documentation and update your markers.js file.


  • Started refactoring the web template
    • Since some files were split up and are now in a separate static/ directory, you should manually delete the old *.js *.css files in your map directories and update the maps with mapcrafter to prevent a mess with old files.
  • Added new options to specify the default view of a map
  • Added new option to specify the dimension of a world
  • Fixed lighting of The End
  • Fixed a texture bug (#61) causing segfaults


  • Fixed the batch mode showing an animated progress bar


  • Fixed a bug (#58) with mapcrafter hanging when there are no tiles to render


  • Refactored multi threading and some other things
  • Fixed some small block issues:
    • Fixed downward spreading lava
    • Fixed not rendered nether portal blocks
    • Improved appearance of flat snow
    • Added some special (not used in the game) slabs
  • Fixed a configuration bug


  • Added ability to crop the world and render only a specific part of it


  • Fixed jungle wooden planks rendering as birch planks
  • Changed worldName attribute in template from part of the world path to the name of the world section
  • Added hint about rendering the Nether/End to documentation


  • Added new configuration file format (consult the documentation for more information):
    • Different section types for Minecraft Worlds/rendered maps
    • Better validation of configuration files
  • Some internal reworkings


  • Added support for Minecraft 1.7 blocks and biomes
  • Added some more blocks such as trip wire, trip wire hook and magic floating cocoa beans


  • Added support for Minecraft 1.6 Resource Packs
    • (You have to delete your old textures and get them new from a new Minecraft Jar file)
  • Added some new blocks from Minecraft 1.6
  • Better compatibility for older gcc (4.4 +) and boost versions
  • Some code reworkings, replaced plain Makefile with CMake


  • Added a new configuration file format to specify worlds to render
  • Added different rendermodes: default, lighting (day/night), cave
  • Added ability to render different worlds/rotations/rendermodes into one output file
  • Added new blocks: dragon egg, redstone wires, some redstone/quartz stuff from Minecraft 1.5
  • Added alternative way to check if tiles are required when rendering incremental (image file timestamps)
  • Added alternative Leaflet template


  • Fixed a bug preventing rotated worlds
  • Fixed a small compiler error for some gcc versions
  • Fixed the problem with the world scanning (world scanning seems to be stuck) when the max zoom level is higher
  • Added compatibility for older boost filesystem versions


  • Added support for biomes
  • Added support for Minecraft 1.5 texture packs
  • Added some new blocks
  • Some template things: url hash with current view, better support for markers


  • Reworked multithreading
  • Added possibility to render the world rotated
  • Reworked block image generation to work with the rotated worlds, fixed rotation of blocks
  • Added nicer beacon, fixed wrong stone slab texture


  • Added support for chests, fences, fence gates
  • Added option --batch, to render without the animated progress bar
  • Small fixes for end portal frame, enchantment table to work with all texture sizes
  • Some code reworking, more comments

v.0.1 (December 2012)

  • First version on GitHub
  • Features:
    • Render Minecraft Worlds to tiles and an HTML-File to view them like a Google Map
    • Incremental rendering, multithreading
Something went wrong with that request. Please try again.