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.

Running Minecraft Overviewer

docker pull mide/minecraft-overviewer:latest
docker run \
  --rm \
  -e MINECRAFT_VERSION="1.17" \
  -v /home/user/minecraft/:/home/minecraft/server/:ro \
  -v /srv/http/minecraft/:/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.