Skip to content

miclav/mapcrafter

 
 

Repository files navigation

Mapcrafter Build Status

by Moritz Hilscher (modified by Michael Lavaire)

dockeri.co

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

Block Status

Featuring blocks up to 1.20

Supported Minecraft versions

The current version supports Minecraft versions 1.18.x. Newer versions may partially work. For Minecraft 1.17.x (or older) please use previous version of Mapcrafter.

Features

  • Web output: Render your Minecraft worlds to maps viewable in any web browser!
  • Different render views: Choose between different perspectives to render your world from! A 2D topdown and a 3D isometric render view are available!
  • Different rotations: Choose from four different rotations to render your worlds from!
  • Different render modes: Choose between different render modes like day, night and cave for your maps!
  • Different overlays: Show additional information on your map! For example: Where can slimes spawn? Where can monsters spawn at night?
  • Configuration files: Highly-customizable which worlds are rendered with which render view and other render parameters!
  • Markers: Automatically generated markers from your Minecraft world data!
  • Other stuff: Biome colors, incremental rendering, multithreading

Requirements

  • 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 may 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 resource packs

Example maps

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

Help

Documentation

You can read the current documentation on docs.mapcrafter.org and you can also download other builds from there. The documentation source is in the docs/ directory and you can build it yourself with Sphinx.

Reporting bugs and feature requests

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.

Community help

Join us on Discord, where you can meet other Mapcrafter users and ask for help. Please be respectful with everyone and have patience with people who are offering their time to help!

Acknowledgements

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.

License

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

Version history

See the CHANGELOG for details.

About

High Performance Minecraft Map Renderer.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 88.6%
  • JavaScript 4.2%
  • Python 2.3%
  • CMake 1.9%
  • CSS 1.8%
  • HTML 0.4%
  • Other 0.8%