Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mtoensing/docker-minecraft-overviewer

Dockerimage for Minecraft Overviewer
https://github.com/mtoensing/docker-minecraft-overviewer

docker-container dockerfile map minecraft overviewer

Last synced: about 2 months ago
JSON representation

Dockerimage for Minecraft Overviewer

Awesome Lists containing this project

README

        

# Docker Overviewer for Minecraft 1.19+

Uses https://github.com/overviewer/Minecraft-Overviewer/ from [overviewer.org](https://overviewer.org) and provides a Docker container.

Tutorial (german) https://marc.tv/overviewer-minecraft-docker-synology/

## VIDEO: How to install Overviewer on a Synology NAS

[![Watch the video](https://img.youtube.com/vi/SqufPMfZdd0/maxresdefault.jpg)](https://youtu.be/SqufPMfZdd0)

https://youtu.be/SqufPMfZdd0

## mount volumes
**server folder:**

minecraft server directory that contains the map folder.

**export folder:**

writeable folder for the exported files

**config folder:**

Folder with config.py (optional) by default the config_sample/config.py file is used

## minimal example
```
docker run \
--rm \
-v /Users/mtoe/Documents/mcserver/:/tmp/server/:ro \
-v /Users/mtoe/Documents/export/:/tmp/export/:rw \
-it marctv/minecraft-overviewer
```

## use your own config
```
docker run \
--rm \
-v /Users/mtoe/Documents/mcserver/:/tmp/server/:ro \
-v config_sample/:/tmp/config/:ro \
-v /Users/mtoe/Documents/export/:/tmp/export/:rw \
-it marctv/minecraft-overviewer
```

### example config.py
```
# sample config.py script for viewer

worlds["world"] = "/tmp/server/world/"
texturepath = "/tmp/overviewer/client.jar"
outputdir = "/tmp/export/"
defaultzoom = 5

renders["day"] = {
'world': 'world',
'title': 'Day',
'rendermode': 'normal',
"dimension": "overworld",
}
```

## advanced example with --genpoi parameter as an environment variable
```
docker run \
--rm \
-v /Users/mtoe/Documents/mcserver/:/tmp/server/:ro \
-v /Users/mtoe/Documents/Docker-Minecraft-Overviewer/config_test/:/tmp/config/:ro \
-v /Users/mtoe/Documents/export/:/tmp/export/:rw \
-e overviewerParams="--genpoi" \
-it marctv/minecraft-overviewer
```

## generate png file
```
docker run \
--rm \
-v $(pwd)/mcserver-test/:/tmp/server/:ro \
-v $(pwd)/config_sample/:/tmp/config/:ro \
-v $(pwd)/export/:/tmp/export/:rw \
-it --entrypoint "/usr/bin/python3" marctv/minecraft-overviewer-local /tmp/overviewer/contrib/png-it.py --memory-limit 12000 --zoom-level 6 --output /tmp/export/full.png /tmp/export/day/
```