mide/minecraft-overviewer

Minecraft Overviewer Docker镜像

用于运行Minecraft Overviewer的Docker镜像。Overviewer是一款可渲染Minecraft世界地图的工具。本镜像旨在无需担心依赖问题即可轻松运行Overviewer项目，并提供合理的默认配置。

:warning: 本项目非官方，也不隶属于优秀的Minecraft Overviewer项目。

本项目代码托管于https://github.com/mide/minecraft-overviewer%EF%BC%8C%E7%94%9F%E6%88%90%E7%9A%84Docker%E9%95%9C%E5%83%8F%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://hub.docker.com/r/mide/minecraft-overviewer%E3%80%82%E5%A6%82%E9%81%87%E9%97%AE%E9%A2%98%EF%BC%8C%E6%AC%A2%E8%BF%8E%E5%9C%A8https://github.com/mide/minecraft-overviewer/issues?q=is%3Aopen%E3%80%82

运行Minecraft Overviewer

shell
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

注意：latest Docker标签每天重建。若https://github.com/overviewer/Minecraft-Overviewer/%E6%9C%89%E6%9B%B4%E6%96%B0%EF%BC%8C%E6%96%B0%E9%95%9C%E5%83%8F%E5%8F%AF%E8%83%BD%E9%9C%80%E8%A6%8124%E5%B0%8F%E6%97%B6%E6%89%8D%E8%83%BD%E5%8C%85%E5%90%AB%E8%BF%99%E4%BA%9B%E6%9B%B4%E6%96%B0%E3%80%82

环境变量

必填

• MINECRAFT_VERSION
  设置世界基于的Minecraft版本（如1.17），用于加载纹理。也可使用特殊版本latest或latest_snapshot分别使用最新稳定版或快照版。

可选

• ADDITIONAL_ARGS
  默认值：null。用于设置要传递给overviewer.py的任何额外参数。

• ADDITIONAL_ARGS_POI
  默认值：null。用于设置要传递给overviewer.py --genpoi的任何额外参数。

• CONFIG_LOCATION
  默认值：/home/minecraft/config.py。设置为其他路径可覆盖提供的配置，通常需配合卷挂载自定义配置文件使用。

• RENDER_MAP
  默认值：true。设为false可禁用地图渲染，适用于仅更新POI的场景。

• RENDER_POI
  默认值：true。设为false可禁用兴趣点（POI）渲染。

• RENDER_SIGNS_FILTER
  默认值：-- RENDER --。仅包含带有此大小写敏感字符串的标牌到POI渲染中，有助于隐藏基地或减少渲染杂乱。设为空字符串（""）可渲染所有标牌。

• RENDER_SIGNS_HIDE_FILTER
  默认值：false。设为true可隐藏标牌中的过滤字符串（由RENDER_SIGNS_FILTER设置）。例如，若仅显示含-- RENDER --的标牌，该字符串将不会出现在渲染结果中。

• RENDER_SIGNS_JOINER
  默认值：<br />。设置渲染时连接标牌各行的字符串。值为"<br />"时，游戏中的每行将在渲染中单独显示；值为" "时，游戏中的所有行将合并为一行显示。