/papyri

Minecraft map item data mapping tool using Leaflet

Primary LanguageJavaScriptMIT LicenseMIT

papyri version 0.8.4

Papyri is a Minecraft map item web presenter. It will show all maps and banners created on a server positioned and scaled properly, creating a mosaic of your world as explored with maps. Since many maps can be created of the same area, Papyri will prioritize rendering so that maps with higher detail are rendered on top of maps of lower detail and maps at the same detail are rendered in order from oldest updated to newest updated.

Example 1 - Byblos

Example 2 - various YouTuber server maps

screen shot 2018-03-07 at 9 32 56 pm

prerequisites

python3 and pip (pip3) (Not tested in python2)

You'll need to install http://jcupitt.github.io/libvips/

to do this on Mac OS X:

brew install vips

Ubuntu should be:

apt-get install libvips glib2.0-dev libffi-dev

some python stuff you'll need:

pip3 install nbt Pillow requests pyvips Jinja2

and you'll need minecraftmap; I've put in a pull request for the official one to fix maps in 1.12, I'm hoping to just pull this from pypi eventaully, but for now use this fork:

git clone https://github.com/jason-green-io/minecraftmap

then, inside the new minecraftmap folder

python setup.py build
python setup.py install

usage

usage: papyri.py [-h] [--poi] [--banners] --mcdata MCDATA --output OUTPUT
                 [--zoomlevel {4,5,6,7,8}] [--overlay] [--nostitch]
                 [--mapstats]

convert minecraft maps to the web

optional arguments:
  -h, --help            show this help message and exit
  --poi                 generate POI file and show POI books, this outputs
                        papyri.md that can be used with
                        http://dynalon.github.io/mdwiki/#!index.md to show on
                        the web
  --banners             generate POI file and show banners, this outputs
                        papyri.md that can be used with
                        http://dynalon.github.io/mdwiki/#!index.md to show on
                        the web
  --mcdata MCDATA       input path to minecraft server data
  --output OUTPUT       output path for web stuff
  --zoomlevel {4,5,6,7,8}
                        size of maps generated in mc zoom levels, 8 = 65k, 7 =
                        32k
  --overlay             add overlay showing map IDs
  --nostitch            disable generating the map, useful if you only want
                        the overlay displayed

Once it's done, the contents of the output folder can be served as a website. It's completely static so it can be put in an S3 bucket a github project or hosted locally on your machine by running something like python3 -m SimpleHTTPServer inside the output folder.

Credits

POI web front end by: http://dynalon.github.io/mdwiki/#!index.md (this can actually be used as full fledged wiki with markdown files, pretty cool)

Font provided by: http://www.04.jp.org

DZI viewer provided by: https://openseadragon.github.io

minecraftmap map item framework by: https://github.com/spookymushroom/minecraftmap

This project is licensed under the terms of the MIT license.