MCOverviewerGUI

为 Minecraft Overviewer 提供的 Windows 图形界面，开箱即用！

项目概述

MCOverviewerGUI 是 Minecraft Overviewer 项目的一个图形界面封装，旨在让用户能够通过简单的点按操作来使用 Overviewer 渲染 Minecraft 地图，无需记忆和输入命令行。

功能特性

• 🌍 地图渲染: 渲染 Minecraft 世界地图
• 🎨 多种渲染模式: 支持多种渲染模式（Normal、Cave、Nether 等）
• 📊 进度显示: 实时显示渲染进度和详细日志
• 📦 一键打包: 渲染完成后自动创建 tar.gz 压缩包
• 🔧 灵活配置: 可自定义进程数、输出目录等参数
• 📝 自定义标题: 支持为渲染的地图设置自定义标题
• 📋 存档信息: 查看选择的世界存档信息

快速开始

环境要求

• Windows 操作系统
• Python 3.8 或更高版本（必须安装）

⚠️ 注意: 本项目需要 Python 环境才能运行，不支持直接作为独立可执行文件运行。

安装 Python

如果尚未安装 Python，请访问 Python 官网 下载并安装 Python 3.8+。安装时请勾选 "Add Python to PATH"。

运行程序

直接双击运行项目根目录下的 run.bat 即可：

双击 run.bat

run.bat 会自动完成以下操作：

1. 检测系统中已安装的 Python
2. 自动安装缺失的依赖（PyQt5、requests）
3. 启动程序

手动运行（可选）

如果你更习惯命令行，也可以手动执行：

# 安装依赖
pip install -r requirements.txt

# 运行程序
python main.py

使用说明

基本使用流程

1. 选择 Minecraft 世界存档目录
2. 选择渲染输出目录
3. 选择渲染模式（可多选）
4. 设置进程数（建议使用逻辑核心数）
5. （可选）设置自定义地图标题
6. 点击"开始渲染"
7. 查看渲染进度和日志
8. （可选）渲染完成后选择是否创建 tar.gz 压缩包

常见问题

1. 纹理缺失错误: Overviewer 需要 Minecraft 客户端来获取纹理。

   • 程序会自动尝试查找 Minecraft 安装位置
   • 也可以手动在 resource_pack 目录中放置纹理文件

2. 中文路径问题: 程序已支持中文路径，但仍需注意系统权限问题。

3. 权限被拒绝: 尝试以管理员身份运行，或检查文件夹权限。

4. Python 未找到: 请确保已正确安装 Python 并添加到系统 PATH。

项目结构

MCOverviewerGUI/
├── core/              # 核心功能模块
│   ├── config_manager.py   # 配置管理
│   └── renderer.py        # 渲染引擎
├── gui/               # GUI 界面模块
│   ├── download_dialog.py # 下载对话框
│   └── main_window.py     # 主窗口
├── utils/             # 工具模块
│   ├── logger.py          # 日志系统
│   └── minecraft_downloader.py  # Minecraft 下载器
├── resource_pack/     # 资源包和纹理
│   └── assets/
│       └── minecraft/
│           └── textures/
│               └── colormap/
├── main.py            # 程序入口
├── requirements.txt   # Python 依赖
├── run.bat            # Windows 启动脚本（推荐）
├── run.ps1            # PowerShell 启动脚本
├── mc_overviewer_gui.spec  # PyInstaller 配置
└── config.example.json     # 配置示例

技术架构

核心模块

• ConfigManager: 管理用户配置和生成 Overviewer 配置
• Renderer: 封装 Overviewer 渲染过程
• MainWindow: PyQt5 主窗口界面
• Logger: 日志记录系统

渲染流程

1. 用户配置参数 → 生成配置文件
2. 调用 Overviewer 可执行文件
3. 监听输出并更新 UI 进度
4. 渲染完成后进行后续处理

依赖

• Python 3.8+
• PyQt5
• requests
• Minecraft Overviewer (已包含)

许可证

此项目是 Minecraft Overviewer 的 GUI 封装，遵循相应的开源许可证。

致谢

• Minecraft Overviewer 项目
• PyQt5
• 所有为开源项目做贡献的开发者

---

注意: 使用前请确保已备份您的 Minecraft 存档！