marctv/minecraft-overviewer

Minecraft 1.19+ Docker Overviewer

基于overviewer.org的https://github.com/overviewer/Minecraft-Overviewer/%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%8F%90%E4%BE%9BDocker%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%B8%BAMinecraft Java版1.19+生成等距交互式地图。

视频教程：如何在Synology NAS上安装Overviewer

![观看视频]([***]

[***]

镜像概述和主要用途

该Docker镜像封装了Minecraft Overviewer工具，用于将Minecraft世界生成可交互的等距地图。主要用途包括：为Minecraft服务器生成世界地图供玩家查看、存档世界地形可视化、分享世界探索进度等。支持Minecraft 1.19及以上版本，提供便捷的容器化部署方式，无需手动配置依赖环境。

核心功能和特性

• 生成等距投影的交互式地图，支持多种渲染模式（如正常、夜间、洞穴等）
• 支持自定义配置，可通过config.py文件调整渲染参数、世界路径、输出目录等
• 提供PNG图片导出功能，可生成世界全景图
• 支持通过环境变量传递额外参数（如--genpoi生成兴趣点）
• 容器化设计，简化部署和使用流程，无需复杂的依赖安装

使用场景和适用范围

• Minecraft服务器管理员：为服务器生成世界地图，供玩家在线查看
• 个人玩家：可视化自己的世界地形，规划建筑或探索路线
• 地图创作者：生成高质量地图用于分享或展示
• 支持Windows、Linux、macOS等所有支持Docker的系统，尤其适合NAS设备（如Synology）部署

使用方法和配置说明

挂载卷说明

使用该镜像需挂载以下卷：

• 服务器文件夹（server folder）：
  Minecraft服务器目录，包含地图文件夹（如world），需以只读方式挂载（:ro）。

• 导出文件夹（export folder）：
  用于存放生成的地图文件，需以读写方式挂载（:rw）。

• 配置文件夹（config folder，可选）：
  包含自定义config.py文件的文件夹，默认使用容器内的config_sample/config.py。

基本使用示例

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

使用自定义配置

若需使用自定义config.py，需挂载配置文件夹：

bash
docker run \
  --rm \
  -v /Users/mtoe/Documents/mcserver/:/tmp/server/:ro \
  -v /path/to/your/config/:/tmp/config/:ro \
  -v /Users/mtoe/Documents/export/:/tmp/export/:rw \
  -it marctv/minecraft-overviewer

示例config.py

python
# 地图查看器的示例config.py脚本

worlds["world"] = "/tmp/server/world/"  # Minecraft世界路径
texturepath = "/tmp/overviewer/client.jar"  # 材质文件路径
outputdir = "/tmp/export/"  # 输出目录
defaultzoom = 5  # 默认缩放级别

renders["day"] = {
    'world': 'world',  # 对应worlds中的世界名称
    'title': '白天',  # 渲染标题
    'rendermode': 'normal',  # 渲染模式（正常）
    "dimension": "overworld",  # 维度（主世界）
}

高级示例：使用环境变量传递参数

通过overviewerParams环境变量传递额外参数（如--genpoi生成兴趣点）：

bash
docker run \
  --rm \
  -v /Users/mtoe/Documents/mcserver/:/tmp/server/:ro \
  -v /path/to/your/config/:/tmp/config/:ro \
  -v /Users/mtoe/Documents/export/:/tmp/export/:rw \
  -e overviewerParams="--genpoi" \
  -it marctv/minecraft-overviewer

生成PNG全景图

使用png-it.py工具生成世界全景PNG图片：

bash
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 *** --zoom-level 6 --output /tmp/export/full.png /tmp/export/day/