iBuild 桌面应用程序，本地运行 AI 模型从文本提示生成 Minecraft 数据，无需外部 API。结合处理 UI 和模型集成的 Python 以及管理 Minecraft 区域文件更新的C库-CSDN博客

本文链接：https://blog.csdn.net/struggle2025/article/details/145655189

一，软件介绍

文末提供下载（安装程序和源码）

该项目是一个桌面应用程序，它在本地运行 AI 模型，为 Minecraft 构建生成文本 “块数据”。
该应用程序会在需要时自动下载这些模型，因此不需要单独手动下载。然后，它使用基于 C 的解析器和编辑器来修改 Minecraft 区域文件，将 AI 生成的结构直接放入保存中。由于这些 AI 模型在您的计算机上运行，因此建议使用相当强大的设置。

GitHub作者地址：https://github.com/dejwi/iBuild

本文信息图片来源于GitHub作者地址

注意：这些 AI 模型相当小，因此结果通常无效或只是一堵积木墙。这也是我的第一个 C 和 Python 的“主要”项目（并将两者结合起来），所以至少这是一次重要的学习之旅！

重要提示：请勿在 Minecraft 上使用此应用程序，您可以节省您关心的。在某些极端情况下，该过程可能会损坏您的世界数据。始终备份或使用测试保存。

二、预制的 AI 预设

Custom 习惯
- 手动配置 GPU 层、CPU 线程等。
16GB 内存 |10GB 显存（32b IQ2_XS）
- 在 DeepSeek-R1-Distill-Qwen-32B-IQ2_XS 上使用 49 个 GPU 层。
- 大约 13gb 的模型可供下载。
16GB 内存 |8GB 显存（32b IQ2_SX）
- 在 DeepSeek-R1-Distill-Qwen-32B-IQ2_XS 上使用 39 个 GPU 层。
- 大约 13gb 的模型可供下载。
16GB 内存 |±6GB 显存（7b Q4_K_M）
- 使用 DeepSeek-R1-Distill-Qwen-7B-Q4_K_M 上的 8 个 GPU 层。
- 大多数结果很糟糕。

三、编译版本

适用于 Windows 或 Mac 的预编译可执行文件可在文末提供下载。
这些编译后的版本使用 PyInstaller 打包。

带有 NVIDIA GPU 的 Windows：确保已安装 CUDA 驱动程序 (Download CUDA Drivers).。
下载、解压缩并运行可执行文件。

四、使用方法

模型会自动下载到文件夹中 models 。
所有生成的 AI 输出文件（如 JSON 或图像）都放置在文件夹中 generated_samples 。

选择您的 AI 预设或定义自定义配置。
键入描述 Minecraft 结构的文本提示。
（可选）选择保存文件夹和插入坐标，然后选择 generate。

五、如何运作

多模态步骤
- 该程序首先尝试生成您请求的结构的 “图像” 表示（使用 Janus-Pro 1B 多模态模型）。
- 然后，它会分析此图像以创建文本描述。
LLM 步
- 第二个本地语言模型（DeepSeek distill）创建最终的 Minecraft 块数据集（JSON 结构）。
插入 Minecraft
- 生成的结构在 Python 中解析并传递给 C 代码，该代码会更新所选存档中的相关 Minecraft 区域文件。

C代码和Minecraft保存

和相关 mc.c 文件解析专有的 Minecraft 区域文件格式（ .mca ）。
解析器识别块头，使用 zlib 处理压缩，解码 NBT 数据，并插入新的块状态和调色板条目。
此过程必须仔细调整数据块的数据结构，以避免损坏世界数据。

Python 代码 & UI

Python 方面有两个主要部分：
- 使用 Tkinter 构建的 UI （ app.py ），用于控制用户输入、AI 预设和进度反馈。
- AI集成（ multimodal.py & llm.py ”下载或引用本地模型文件，运行它们，通过 torch 像和 llama_cpp 这样的框架，并生成“内部数据”JSON。
- 最后， nbt_link.py 通过 ctypes .

本地安装

Windows 要求

NVIDIA GPU + CUDA 驱动程序 (Download CUDA Drivers)
Python
MinGW-w64 用于 C 代码构建

Mac 要求

合适的 C 编译器（Clang、GCC 等）
Python

安装依赖项

克隆存储库后，将 Python 包安装在顶级目录中：

pip install -e .

构建 C 库

在目录中 nbt-editor ：
在 Mac/Linux 上：

make -f Makefile.nix

在 Windows 上：

make -f Makefile.win

这会在中生成共享库（ .so 在 Mac/Linux 上、 .dll 在 Windows 上）。 nbt-editor/build

启动 Python GUI

构建 C 库并安装 Python 包后，运行 Python GUI：

python py-ui/app.py

六、软件下载和源码

夸克网盘分享