Minecraft Overviewer Docker Image

Docker Image to Run Minecraft Overviewer. Overviewer is a render that produces a render of a Minecraft world. The goal of this image is to easily run the Overviewer project without having to worry about dependencies, and to provide sane default configurations.

⚠️ This project is not official nor affiliated with the wonderful Minecraft Overviewer project.

This project's code is hosted on GitHub, and the resulting Docker image is hosted on Docker Hub. Feel free to open an issue on GitHub if you're having problems.

🚧 Maintenance Status

As of April 5, 2023, the upstream Minecraft-Overviewer project is no longer being maintained. For more information on the matter, please check the project's Official GitHub.

Running Minecraft Overviewer

In the below example, minecraft-overviewer will read input in from /home/user/path_to_minecraft_files/ and write the output to /home/user/path_to_write_overviewer_output/. It will run once and exit.

docker pull mide/minecraft-overviewer:latest
docker run \
  --rm \
  -e MINECRAFT_VERSION="1.19.4" \
  -v /home/user/path_to_minecraft_files/:/home/minecraft/server/:ro \
  -v /home/user/path_to_write_overviewer_output/:/home/minecraft/render/:rw \
  mide/minecraft-overviewer:latest

Note: The latest Docker tag is rebuilt daily. If there are changes to the upstream project, it may take up to 24 hours for the new image to contain them.

Environment Variables

Required

MINECRAFT_VERSION Set to the version of Minecraft the world is based from (Like 1.17). Used for textures. You can also use the special version latest or latest_snapshot to just use the latest version (stable or snapshot, respectively).

Optional

ADDITIONAL_ARGS Default Value: null. Set to contain any additional arguments you'd like to pass into overviewer.py.
ADDITIONAL_ARGS_POI Default Value: null. Set to contain any additional arguments you'd like to pass into overviewer.py --genpoi.
CONFIG_LOCATION Default Value: /home/minecraft/config.py. Set to a different path to override the provided configuration. This only makes sense if you have a different configuration in a volume.
RENDER_MAP Default Value: true. Set to false if you do not want to render the map. This is useful for POI only-updates.
RENDER_POI Default Value: true. Set to false to disable rendering of POI (points of interest).
RENDER_SIGNS_FILTER Default Value: -- RENDER --. Only signs with this case-sensitive string will be included in the POI (points of interest) render. Useful for allowing hidden bases or decluttering the render. Set to an empty string ("") to render all signs.
RENDER_SIGNS_HIDE_FILTER Default Value: false. Set to true to prevent the sign filter string (Set via RENDER_SIGNS_FILTER) from appearing in the render. For example, if only signs with -- RENDER -- are displayed, the string -- RENDER -- would be hidden from the render.
RENDER_SIGNS_JOINER Default Value: <br />. Set to the string that should be used to join the lines on the sign while rendering. Value of "<br />" will make each in-game line it's own line on the render. A value of " " will make all the in-game lines a single line on the render.

Mapped Directories / Volumes

The following directories are read from within the context of the container. You'll want to modify your commands to ensure that the expected files end up in the correct locations inside the container.

/home/minecraft/server/ (Read Only) This is the expected directory for the Minecraft server files.
/home/minecraft/render/ (Read & Write) This is where Minecraft Overviewer will write the files. If you want to have it directly write to a webserver's directory, make sure you mount the output location correctly.

In the example above, -v /home/user/path_to_minecraft_files/:/home/minecraft/server/:ro will use /home/user/path_to_minecraft_files/ as the source of the Minecraft server files. The line -v /home/user/path_to_write_overviewer_output/:/home/minecraft/render/:rw tells the Docker contianer to write out to /home/user/path_to_write_overviewer_output/.

For more information, check out the Docker documentation on docker run.

mide / minecraft-overviewer