mapcrafter

by Moritz Hilscher

mapcrafter is a fast Minecraft World renderer written in C++. It renders Minecraft Worlds to a bunch of images, which are viewable in any webbrowser using Leaflet.

mapcrafter runs on linux (maybe also Mac OS or W****** with cygwin) and needs libpng, libpthread, libboost-iostreams,libboost-system, libboost-filesystem, and libboost-program-options (and libboost-test if you want to use the tests). You can build it with g++ and CMake/make.

mapcrafter is not yet finished. At the moment a few blocks are not supported yet, but all rendering routines are implemented. The renderer works with the Anvil World Format and the new Minecraft 1.6 Resource Packs.

Some features of the renderer are:

• Rendering Minecraft Worlds to maps viewable in any webbrowser
• Configuration files to control the renderer
• Four different directions to render your worlds from with an isometric 3D view
• Different rendermodes
• Biome colors
• Incremental rendering, multithreading
• User-defined markers on your maps

mapcrafter is free software and available under the GPL license. You can access the latest source code of mapcrafter at: http://github.com/m0r13/mapcrafter

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.

Documentation

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

Examples

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

Help

Please read the documentation to find out how to use the renderer.

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

v.0.5.1

• Added support for Minecraft 1.6 Resource Packs (You have 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

v.0.5

• 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

v.0.4.1

• 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

v.0.4

• 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

v.0.3

• 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

v.0.2

• 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:
• Rendering minecraft worlds to tiles and an html file to view them like a Google Map
• Incremental rendering, multithreading