Minecraftify2.0

三维模型转 Minecraft 工具，需与 Builder 模组配合使用

项目介绍

本项目是一个用于将3D模型进行体素化并转换为 Minecraft（JAVA版）中的方块数据的工具。

支持多种 3D 模型格式，如 OBJ、STL、GLB 等，并可根据用户选择的材料（羊毛、混凝土、陶瓦、玻璃）进行转换。

生成数据以 JSON 文件形式保存，可通过 Fabric 模组 Builder 导入 Minecraft 中，具体使用说明见后文

本项目由 Minecraftify1.0 升级而来，相较上一版的主要变化为：

原项目中的旧版本依赖库无法适应 Minecraft 新的游戏版本，且更新适配工作较为困难。为了减少维护成本，新的项目不再使用该依赖库与 MC 交互；

新项目改用自主开发的 Fabric 模组 Builder 与本项目配合使用，适配最新的游戏版本（1.21.8）。

安装说明

发布版

从发布页面下载最新的 release 版本
解压下载的压缩文件
运行 Minecraftify2.exe 即可启动程序

开发者（若选择发布版，则无需执行以下步骤）

克隆本仓库

git clone https://github.com/Ivans-11/Minecraftify2.git
cd Minecraftify2

安装所需依赖（推荐使用虚拟环境，请自便）
```
pip install -r requirements.txt
```

运行 gui.py 启动图形化界面或使用命令行工具 python mcify.py 进行转换

# 简单用法
python mcify.py 你的模型.obj
# 使用更多参数
python mcify.py 你的模型.obj --game_path 你的游戏目录 --rotate 45,0,0 --pitch 0.5 --no-wool --no-glass
# 查看详细参数说明
python mcify.py --help

若需编译为可执行文件，请使用 PyInstaller

pyinstaller -w -i ./image/logo.ico -n Minecraftify2 --exclude-module torch ./gui.py

图形化界面使用方法

准备好要转换的 3D 模型文件，支持的格式包括 OBJ、STL、GLB 等。
运行 Minecraftify2.exe 或 gui.py 启动工具界面。
在界面中选择要转换的3D模型文件和Minecraft游戏主目录（一般为C:\Users\你的用户名\.minecraft）
勾选转换使用的材料，目前支持羊毛、混凝土、陶瓦、玻璃。
可以展开高级选项，设置旋转角度、体素大小等参数。
点击"转换"按钮开始转换。
转换完成后，将生成一份JSON文件，其中包含了转换后的方块数据。（若之前选择了正确的游戏目录，文件将自动保存在后续模组所需的路径；否则您还需要根据模组的要求手动复制文件到正确的路径）
使用Fabric模组 Builder 将 JSON 文件数据导入到 Minecraft 世界中。模组的安装和使用方法请参考其仓库说明。

注意事项

旋转角度为度数，使用三个角度表示模型在 x、y、z 轴上的旋转。
设置较小的体素大小可以提高转换精度，但也会增加转换时间。
转换过程可能需要一定时间，具体取决于模型的复杂度。
转换时将从勾选的材料中自动选择颜色接近的方块。
Builder 模组适配的游戏版本为 JAVA Edition 1.21.8。

文件说明

gui.py：工具的图形用户界面。
tran.py：实现3D模型转换逻辑的核心代码。
mcify.py：命令行工具。

未来计划

支持更多方块材料的添加，并可以对已有的材料进行更换
优化转换算法，提高转换速度

FilesExpand file tree

README_zh.md

Latest commit

History