AIbuilder：让 AI 在 Minecraft 里替我盖房子

八月初的一天，我在 Minecraft 里又双叒叕被自己的建筑水平气到了：脑子里想的是“温馨小木屋”，手上搭出来的是“违章搭建”。搭了拆、拆了搭，最后干脆盯着空地发呆——要是能把脑子里的想法直接变成建筑就好了。

于是就有了 AIbuilder：一个 Fabric 模组，你在聊天框里描述想要的建筑，AI 帮你生成，然后直接以 Litematica 投影的形式加载到你面前。没有复杂的菜单，没有表格配置，就是聊天。

它是怎么工作的

原理说起来并不复杂，但每一步都有坑：

1. 在游戏里输入 /aibuilder 进入建筑模式，之后聊天框发出去的消息会被拦截；

2. 消息连同定义严格 JSON 建筑格式的系统提示词一起发给 AI 模型；

3. AI 返回设计思路说明和 JSON 数据（size 尺寸 + blocks 方块列表，含坐标和方块 ID）；

4. AIbuilder 解析 JSON，构建 Litematica 兼容的 NBT 结构（调色板 + 位打包方块状态），保存成 .litematic 文件；

5. 通过 Litematica API 把投影加载出来，放在玩家前方 5 格处。

最折磨人的是第 4 步。Litematic 的 NBT 结构不是随便写写就能读的，方块状态要位打包（packed block states），调色板要按序排列。我在第一个版本里把 NBT 键名写成了 BlockData，结果 Litematica 死活不认，最后翻源码才发现是 BlockStates——就一个字母的差别，浪费了我一晚上。

不只是“能用”，而是“好用”

做模组最怕的就是只有作者自己用。所以我在功能上花了不少心思：

• 多提供商支持：OpenAI、Anthropic、阿里云百炼、DeepSeek、智谱 GLM、小米 MiMo，以及任何 OpenAI 兼容 / Anthropic 兼容的自建端点或中转站。国内玩家不用折腾网络也能用；

• 游戏内配置界面：通过 Mod Menu 就能添加、删除、切换模型配置，还能直接从提供商拉取模型列表；

• 思考过程展示：模型支持的话，会在聊天里先展示推理过程，看着 AI“想”怎么建，比直接出结果有意思多了；

• 32 种语言：跟随 Minecraft 语言设置自动切换，连文言文都有。

一个模组，十个版本

我知道很多人还停留在自己最爱的版本，所以花了整整一个月做移植：从 1.20.6 开始，一路做到 1.16.5、1.18.2、1.19.4、1.20.2、1.20.4、1.21.4、1.21.11，以及 26.1.2 和 26.2。每个版本对应独立分支，依赖版本（Fabric Loader、Java、Litematica、MaLiLib、Mod Menu）都单独对齐过。

26.x 系列用官方 Mojang 映射，不再依赖 Yarn；1.16.5 只能找到 dev 版前置模组，也一并处理了。每个版本我都实际构建过 jar，产物在 Releases 里可以按版本下载。

怎么玩

1. 按你的 Minecraft 版本安装对应版本的 Fabric Loader；

2. 从 Releases 下载匹配的 aibuilder-0.1.1-<版本号>.jar；

3. 把 jar 和 Fabric API、对应版本的 Litematica、MaLiLib、Mod Menu 一起放进 .minecraft/mods；

4. 启动游戏，在 Mod Menu → AIbuilder 里添加模型（选提供商、填 API Key、拉取模型列表、保存）；

5. 输入 /aibuilder 进入建筑模式，然后随便描述，比如：

一栋带烟囱的温馨小木屋，门前有一条石头小路。

稍等片刻，建筑就会以投影的形式出现在你面前。位置不满意？用 Litematica 的快捷键调整就行。

最后

项目完全开源（LGPL-3.0），源码在 GitHub。这只是 0.1.1 版本，还有很多想法没实现：更复杂的建筑结构、根据地形自适应、批量生成建筑群……

如果你也受够了“脑子会了手不会”，欢迎下载试试，提 issue 或者给我点个 star。毕竟，让 AI 替我盖房子这种事，怎么想都比自己动手香。