mcmapimg

A command-line utility, web application, and Python library to convert Minecraft in-game maps to image files.

Dependencies

Clone this repository into an empty directory:

git clone https://github.com/joodicator/mcmapimg.git
cd mcmapimg

There are four ways to use this tool:

Run mcmapimg.py as a command-line program. See the output of:
```
./mcmapimg.py --help
```
Using the web interface: make accessible by a web server index.htm and cgi-bin/map.cgi - the latter of which is an executable Python script and should be run as a CGI program by the web server - for example, run python's built-in http server:
```
python -m http.server --cgi 8000
```
Then visit http://localhost:8000 in your browser and follow the instructions there.

As a library directly from Python:

python
>>> import mcmapimg
>>> help(mcmapimg)

In a docker container. First build the image:

docker build -t mcmapimg .

Then run the container:

docker run -it --rm -p 8000:8000 mcmapimg

Finally access the webpage:

http://localhost:8000

The docker image also supports running from the command line:

cd directory/with/map_dat_files/

docker run -it --rm -v "$PWD":/usr/src/app/maps \
    mcmapimg ./mcmapimg.py maps/[in_map_file.dat] maps/[out_img_file.png]